系統地圖（流程關聯）
整體系統由 Kevin（NPI 模組）與 Alice（生產系統模組）共同打造， 涵蓋從接單到結案的完整商品生命週期。下圖呈現各模組間的承接關係：
角色與權限矩陣
| 角色（Role） | 帳號 | RFQ | NPI | 樣品 | PCN | ECN | QC | 備註 |
|---|---|---|---|---|---|---|---|---|
| 業務 SALES | sales01 | 建單、試算、客戶報價 | 進入 NPI | 建單 | — | 建 ECN（售價） | — | 各事業部 |
| 業助 ASSISTANT | asst01 | — | — | 出貨/開單沖銷 | — | 建 ECN（售價） | 建單、橫向展開盤點(客戶端) | — |
| 工程師 ENGINEER | eng01 | 排製程、派發詢價 | 主導開發 | 建製程單 | 建 PCN | 技術類確認 | 改善方案咨詢 | — |
| 工程主管 ENG_MGR | engmgr | 知悉 | 知悉 | 知悉 | 知悉 | 知悉 | 知悉 | — |
| 品保 QC | qa01 / ipqc | — | — | — | SIP 檢表 | 技術類確認 | 主導全流程 | 含 IPQC/IQC/OQC |
| 產線主管 PROD_MGR | pd01 | — | — | — | 作業 SOP | — | 建單 | 產線端發現問題建單 |
| 生管 PC | pmc01 | — | — | 確認途程 | — | — | 派工/Sorting/Rework 回填 | 2026-04-26 拆出獨立角色 |
| 採購 PURCHASE | pc01 | 跟催供應商報價 | 議價 | 議價 | — | 建 ECN（成本） | 退貨補貨協調 | — |
| 倉管 WAREHOUSE | wh01 | — | — | — | 包裝 SOP | 設計 ECN 庫存盤點 | 橫向展開盤點(廠內) | — |
| 事業部主管 BU | bh01 | 核准報價 | 核准成案 | 核准 | 核准 + CC PDF | 核准 + CC PDF | 知悉 | 儲能/消費性 |
| 人事 HR | hr01 | — | — | — | — | 商業 ECN CC | — | — |
| 管理員 ADMIN | admin | 全權限（系統管理） | — | |||||
業務收到客戶詢價後，建立 RFQ 單；工程排製程並派發供應商； 採購跟催；業務收齊報價後試算成本；BU 核准後發送客戶報價。
流程圖
關鍵欄位
| form_id | RFQ-YYYYMMDD-NNN（自動生成） |
| customer_name / email | 客戶資訊 |
| spec_summary | 規格摘要 |
| eng_process_data | 工程排製程 JSON（每站 part_no/是否走途程） |
| quote_cost_data | 業務試算 JSON（明細/管銷/毛利/建議售價） |
| quoted_unit_price | 業務決定客戶報價單價 |
| selected_quote_supplier_id | 最終選定供應商 |
| bu_quote_note | BU 核准/退回評語 |
附件分類
客戶詢價信 · 圖面 · 供應商報價 · 議價後報價單
· 成本分析表 · 客戶報價單 · 其它
通知（LINE / Mail）
客戶確認開發後，業務點選機種匯入 NPI；工程選定供應商並開立 ERP 模具請購單； 填寫 T1 試模日期；BU 核准成案；採購議價回填實際成本後結案，匯入 NAS。
流程圖
關鍵欄位
| t1_plan_data | JSON list — 每張圖的 T1 試模日期 + 備註 |
| eng_process_data | JSON — 每站廠內料號/是否走途程 |
| mould_cost_est / mould_cost_final | 工程估模具成本 / 採購議價後實際模具成本 |
| bargain_data | 採購議價 JSON — 每供應商價格/模治具/備註 |
| npi_supplier_invites | 派發明細表 — 供應商/品號/數量/階梯式 MOQ 報價 |
通知
流程圖
附件規則（按客戶訂單狀態）
- 不可請款 (NO_ORDER)：客戶報價單 + 成本分析截圖（必要）+ 其它
- 可請款 (WITH_ORDER) / 後補訂單 (PENDING_ORDER)：客戶訂單 + 成本分析截圖（必要）+ 其它
途程判斷
EngFormItem.has_routing（Boolean）— 製程明細每行一個 toggle； 任一行有途程 → 整張製程單走生管；全部無途程 → 跳過生管直接到採購。
廠商主動提出之製程變更，由工程建立，依序由品保填 SIP、產線主管填作業 SOP， 最後 BU 核准結案並產生 CC PDF。
流程圖
附件分類
圖面新版 · SIP 檢表 · 作業 SOP · 包裝 SOP · 議價記錄 · 其它
退回時各角色僅可刪除自己負責類別的附件。
客戶主動或已量產品設計變更。由 change_types JSON 決定走哪支： 「製程/設計/供應商變更」走技術類；「售價/成本變更」走商業類直送 BU。
技術類流程圖（含設計變更需庫存盤點）
商業類流程圖（售價變更：業助建單／成本變更：採購建單）
變更類型 (change_types) 與走向
| 類型 | 走向 | BU 核准 CC 對象 |
|---|---|---|
| 製程變更 | 技術類 | 工程/品保/採購/倉管/提案 |
| 設計變更 | 技術類 + 倉管盤點 | 同上 + 圖面新版 |
| 供應商變更 | 技術類 | 同製程 |
| 售價變更 | 商業類 | 提案/業助/人事 |
| 成本變更 | 商業類 | 提案/採購/人事/業務 |
設計變更庫存盤點 (inventory_data)
JSON list：每筆 {part_no, customer_qty, inhouse_qty, supplier_qty, decision}， 倉管於 ECN_PENDING_WAREHOUSE 階段填寫， 決定庫存品如何處理（如「停用換新」「沿用至庫存盡」）。
IQC/IPQC/OQC 或產線發現異常時建單；品保下處理判斷（可多選）； 依路線執行（退貨／特採處理／橫向展開）；需長期改善則進入改善方案，必要時綁 ECN。
階段流程圖
B. 處理方式（5 子類，可任意組合）
| 子類 | 說明 | 填寫人 | 欄位 |
|---|---|---|---|
| B1 | 不需特殊處理（只記錄） | 品保 | — |
| B2 | 廠內 Sorting（生管安排） | 品保 生管 | 執行站別下拉、良/不良數 |
| B3 | 廠內 Rework + 樣品測試 | 品保 生管 | SOP 附件、Rework 結果回填 |
| B4 | 客戶端 Sorting | 品保 | 預估工時 + 需求人力 + 客戶聯絡人 |
| B5 | 客戶端 Rework | 品保 | 同上 + Rework SOP 附件 |
C. 橫向展開盤點欄位（角色分權寫入）
| 欄位 | 填寫角色 | 已填視覺 |
|---|---|---|
| 客戶端 QTY | 業助 | 綠底+綠框 |
| 廠內 QTY | 倉管 | 綠底+綠框 |
| 供應商 QTY | 採購 | 綠底+綠框 |
| 處理判定 | 品保 | 綠底+綠框 |
退貨自動路由（A 退貨）
| 單號類型 (doc_type) | 通知對象 |
|---|---|
| RECEIVE 進貨單號（原物料） | 採購 |
| PROCESS 製程單號（製成品） | 生管 |
| SHIP_DC 出貨 D/C | 採購 + 生管 |
通知
Alice 訂單處理實際流程
已知對接點（從 Kevin 模組看出去）
- RFQ → 訂單：quoted_unit_price 為客戶報價單價，為訂單售價之來源
- NPI → 訂單：mould_cost_final + bargain_data 為實際成本，供成本分析模組使用
- ECN 商業類 → 訂單：售價/成本變更核准後，需同步至訂單模組 （目前以 PDF + Mail CC 通知，未直連系統）
- QC NCR → 訂單：客戶端 Sorting/Rework 工時人力，可能納入成本
建議整合方向
- Alice 提供訂單 API → Kevin 端可在 RFQ QUOTE_APPROVED 時自動建單
- Kevin ECN 商業類核准 → POST 至 Alice 訂單成本/售價維護 endpoint
- QC 客戶端工時人力 → 折算成本費用 push 至 Alice
Kevin 模組（NPI 系統）
- 後端：FastAPI + SQLAlchemy async (aiosqlite)
- 前端：Jinja2 + Bootstrap 5
- DB：SQLite（dev）／可換 SQL Server（prod）
- ERP 整合：pyodbc 直連 SQL Server (192.168.0.201)
- 通知：LINE Messaging API + SMTP（urllib stdlib）
- 啟動：uvicorn app.main:app --reload --port 8000
- Repo： Honten-archive/feature/npi-module
Alice 模組（生產系統）
- Repo： HT_Production-system （私有，待開放查閱）
- 範圍：樣品需求單、訂單管理、成本分析、售價維護
- 整合方式（建議）：REST API + 共用 SSO 帳號