Department Modules
部門模組與資料互通
本頁用來定義各部門如何獨立作業，同時透過專案主線、事件、任務、文件與狀態資料彼此互通。原則是：部門各自擁有自己的工作區與資料責任，但所有成果都回寫到同一個 Project。
總體設計原則
- 各部門模組獨立：業務部、採購部、工程部、財務部、倉庫都有自己的工作台。
- 資料不互相覆蓋：誰產生資料，誰擁有編輯權；其他部門只能讀取、引用或建立回報。
- 資料透過 Project 串接：所有模組資料都必須關聯到 ProjectId / CaseCode。
- 流程透過事件推進：部門完成節點後發出事件，由下一個部門接收成待辦。
- 總覽只讀整合資料：專案總覽負責顯示完整狀態，不直接替各部門改資料。
- 先完成單一部門模組：以採購部作為第一個完整模組，穩定後再串接正式資料庫與 API。
- Agent 互不干擾：各部門 Agent 只能操作自己的 Command 與資料表，不直接改其他部門主資料。
階段導入方式
第一階段不一次完成所有部門，而是先把採購部做到可用，包含專案總覽、來源單據、採購明細、狀態異動、自動儲存、報表與通知。完成後再將採購部資料結構收斂為正式資料表與 API，再接 MySQL 5.6.2。
共用資料核心
共用資料核心不是某個部門的頁面，而是系統底層的串接層。部門模組透過它互通資料，避免彼此直接耦合。
部門功能模組
業務部
負責開案、客戶與合約資訊、規格書交付、履約交貨與驗收結案確認，是專案資料的起點。
功能模組
- 開案管理
- 案件查詢
- 規格書交付
- 客戶資料與窗口
- 履約交貨日與驗收日維護
- 驗收追蹤與結案確認
需要完成的節點
01 業務開案02 規格書交付11 履約交貨14 驗收完成15 結案確認
採購部
負責採購需求、報價單 / 採購單匯入、供應商報價、叫貨、交期追蹤與採購異常回報。
功能模組
- 採購需求清單
- 匯入報價單
- 查詢報價單
- 叫貨追蹤
- 到貨確認
- 供應商管理
- 採購報表
需要完成的節點
05 採購需求產生06 報價單 / 採購單匯入07 採購叫貨08 到貨追蹤15 結案確認
工程部
負責接收規格、建立 BOM、管理 BOM 版本、產出工程圖、支援組裝測試與驗收改善。
功能模組
- 待接案清單
- 電控 BOM
- 機構 BOM
- BOM 版本管理
- BOM 審核與發布
- 工程圖與技術文件
- 工程異常與測試回報
需要完成的節點
03 工程 BOM 建立04 BOM 審核與發布09 廠內組裝支援10 組裝測試13 驗收改善15 結案確認
財務部
負責採購金額審核、請款付款、發票、成本歸屬與專案成本報表。
功能模組
- 採購金額審核
- 發票管理
- 請款管理
- 付款狀態
- 專案成本歸屬
- 成本報表匯出
需要完成的節點
06 採購金額讀取07 採購金額審核08 到貨入帳依據14 驗收請款確認15 結案確認
倉庫
負責實際到貨確認、入庫、儲位、缺料短交回報、領料出庫與庫存查詢。
功能模組
- 到貨確認
- 入庫管理
- 儲位管理
- 短交 / 異常回報
- 領料 / 出庫
- 庫存查詢
需要完成的節點
08 到貨確認09 廠內組裝供料10 領料 / 出庫15 結案確認
部門資料互通方式
| 來源部門 | 完成節點 / 動作 | 產生資料 | 接收部門 | 接收後動作 |
|---|---|---|---|---|
| 業務 | 業務開案 | Project、CaseCode、客戶、專案名稱、履約交貨日、驗收日。 | 工程 | 建立待接案任務與規格書確認任務。 |
| 業務 | 規格書交付 | 規格書文件、版本、特殊需求、驗收條件。 | 工程 | 建立 BOM 任務，若資料不足則退回補件。 |
| 工程 | BOM 發布 | BOM 版本、料號、品名、規格、數量、需採購標記、長交期標記。 | 採購 | 產生採購需求，長交期品項進入風險清單。 |
| 採購 | 報價單 / 採購單匯入 | 採購明細、供應商、交貨日期、案件編碼、採購狀態。 | 專案總覽、報表、財務、倉庫 | 更新專案採購進度；財務取得金額資料，倉庫取得待到貨清單。 |
| 採購 | 採購叫貨 | 叫貨日期、預計交貨日、採購數量、已叫貨狀態。 | 倉庫、通知模組 | 建立到貨確認提醒，逾期時通知採購，倉庫可看到預計到貨品項。 |
| 倉庫 | 到貨確認 | 實際到貨日、到貨數量、部分到貨、異常到貨。 | 採購、工程、財務 | 更新採購到貨狀態；財務取得入帳依據；工程取得可領料狀態。 |
| 財務 | 付款 / 發票確認 | 付款狀態、發票號碼、發票日期、成本歸屬。 | 業務、採購、專案總覽 | 更新專案成本與付款狀態，不回寫採購作業狀態。 |
| 工程 | 廠內組裝 / 測試支援 | 測試結果、工程異常、改善需求、補件需求。 | 採購、倉庫、業務 | 需要補件時建立採購需求；需要領料時通知倉庫；影響交期時通知業務。 |
| 業務 | 驗收完成 | 驗收文件、驗收日期、客戶確認、改善完成紀錄。 | 採購、工程、財務、倉庫 | 啟動結案確認。 |
資料權責邊界
| 資料類型 | 主要編輯部門 | 其他部門權限 | 說明 |
|---|---|---|---|
| 案件基本資料 | 業務 | 讀取、提出問題 | 履約交貨日與驗收日不可由其他部門直接覆蓋。 |
| 規格書 | 業務 | 工程可確認或退回 | 退回補件不直接改業務資料。 |
| BOM | 工程 | 採購可引用、不可修改 | BOM 發布後以版本管理，不覆蓋既有版次。 |
| 採購明細 | 採購 | 工程、財務、倉庫可讀取 | 採購狀態由採購維護；倉庫只回寫實際到貨與入庫結果。 |
| 到貨 / 庫存 | 倉庫 | 採購、工程、財務可讀取 | 到貨、入庫、短交、儲位與出庫資料由倉庫維護。 |
| 財務資料 | 財務 | 業務、採購可讀取必要狀態 | 付款、發票與成本資料由財務維護，不覆蓋採購單內容。 |
| 工程 / 組裝資料 | 工程 | 業務、採購、倉庫可讀取 | 工程負責 BOM、測試、組裝支援與改善任務。 |
| 驗收與結案 | 業務 | 採購、工程、財務、倉庫共同確認 | 所有必要部門確認後才能封存專案。 |
Agent 操作邊界
未來不同部門若各自有 Agent，必須遵守資料權責，不允許跨部門直接覆蓋資料。Agent 只負責自己的部門資料，跨部門協作透過事件、任務或 API command 完成。
| 部門 Agent | 允許操作 | 禁止直接操作 | 互通方式 |
|---|---|---|---|
| 業務部 | 開案、客戶、合約日期、規格交付、驗收結案。 | 採購狀態、BOM、入庫、付款。 | 建立 ProjectEvent 或交付任務。 |
| 採購部 | 採購需求、來源單據、採購明細、叫貨、交貨日、採購狀態。 | 業務合約日期、工程 BOM 原始內容、倉庫入庫、財務付款。 | 發出採購狀態事件與到貨確認任務。 |
| 工程部 | BOM、工程圖、規格確認、工程異常、測試回報。 | 採購價格、付款、客戶合約日期、庫存入庫。 | 發布 BOM 事件或補件需求。 |
| 倉庫 | 到貨、入庫、儲位、出庫、短交異常。 | 採購價格、BOM、業務合約欄位、付款。 | 回寫到貨與庫存事件。 |
| 財務部 | 發票、付款、請款、成本歸屬。 | 採購作業狀態、工程 BOM、倉庫實際入庫。 | 發布付款與發票確認事件。 |
工程實作時，API 不使用單一通用更新入口，而以部門 command 分開，例如 Procurement.UpdatePurchaseItemStatus、Engineering.PublishBom、Warehouse.ConfirmArrival。這樣每個 Agent 的可操作範圍能被測試與權限機制明確限制。
建議的左側功能架構
專案總覽
業務部
開案管理
案件查詢
規格書交付
驗收追蹤
採購部
採購需求
匯入報價單
查詢報價單
叫貨追蹤
到貨確認
工程部
待接案
BOM 建立
BOM 版本
工程圖文件
組裝測試
驗收改善
財務部
採購金額審核
發票管理
請款付款
成本報表
倉庫
到貨確認
入庫管理
儲位管理
領料出庫
庫存查詢
通知中心
報表中心
系統設定