MES 廠商需求差距矩陣
本頁說明本次 Demo 範本已實作的功能，以及廠商尚需補充的項目。
6
已實作
1
部分實作
3
廠商待補
| # | 分類 | 需求項目 | 狀態 | Demo 實作說明 | 廠商待補事項 | Demo 頁面 |
|---|---|---|---|---|---|---|
| 1 | 製程管控 | eSOP 步驟引擎 — 58步逐步引導，顯示當前步驟與下一步預覽 | 已實作 | StepDefinition + StepExecution 完整實作；gate 防呆（GateBlockedError）。 | 無 | 查看 |
| 2 | 製程管控 | 開工前檢點 gate — 所有必填項目 PASS 才可開工 | 已實作 | ChecklistItem + ChecklistResponse；check_checklist_gate() 返回 (bool, failed_ids)；start_run API 409 gate_blocked。 | 無 | 查看 |
| 3 | 品質管控 | IPQC gate — 規格帶自動判定 PASS/FAIL，FAIL 時不可完步驟 | 已實作 | IPQCRecord；submit_ipqc() 伺服端計算 PASS/FAIL；check_ipqc_gate() 封鎖完工。支援主管例外放行 override。 | 無 | 查看 |
| 4 | 設備監控 | 設備即時參數 (T/P/流量) 顯示，每 10 秒自動更新，趨勢 mini-chart | 已實作 | EquipmentAdapter ABC + SimulatorAdapter；ParameterReading 持久化；Vanilla Canvas sparkline；/api/equipment/read。PLC adapter 介面已定義，可熱插拔。 | 需提供真實 PLC 驅動程式（pycomm3/pymodbus）實作 PLCAdapter 介面。 | 查看 |
| 5 | 追溯性 | 多人員作業記錄 — Join/Leave 時間戳，EBR append-only 事件流 | 已實作 | OperatorLog join/leave；EBREvent append-only；完工頁顯示完整時間軸。 | 無 | 查看 |
| 6 | 追溯性 | 完工後自動生成 EBR 電子批次紀錄 + SPC 數據匯出 | 已實作 | closeout() 自動呼叫 spc_export.save_export()；EBR 時間軸含所有操作事件；SPCExport 含所有 ParameterReading + IPQCRecord payload。 | 無 | 查看 |
| 7 | SPC / 統計 | SPC 趨勢圖 — Xbar-R 管制圖，UCL/LCL 自動計算 | 廠商待補 | 目前僅提供 SPC 數據匯出（JSON payload）。管制圖繪製、UCL/LCL 計算、失控判定規則均未實作。 | 廠商需實作 SPC 計算引擎（Xbar-R/Xbar-S）及圖表渲染，建議整合 ECharts 或 D3.js。 | — |
| 8 | SPC / 統計 | 良率自動計算 — 批次完工後計算 FPY / OEE | 廠商待補 | 目前批次完工流程已記錄所有步驟與 IPQC 結果，但 FPY/OEE 計算邏輯尚未實作。 | 廠商需定義良率計算公式並實作 KPI dashboard。 | — |
| 9 | 整合 | ERP 工單介接 — 工單從 ERP 自動匯入，完工回寫 | 廠商待補 | WorkOrder 模型欄位已設計為支援 ERP key（wo_no），但無實際 API 介接。 | 廠商需實作 ERP Adapter（REST/EDI），並定義雙向資料映射規格。 | — |
| 10 | 整合 | PLC 即時控制 — 從 MES 下發控制指令至 PLC | 部分實作 | EquipmentAdapter 介面已定義 read() 與 write() 抽象方法。SimulatorAdapter 僅模擬讀取，無法下發。 | 廠商需實作 PLCAdapter.write(tag, value)，連接 PLC（Rockwell/Siemens），並取得設備讀寫權限。 | 查看 |
Demo 技術架構說明
- 後端：Python Flask + SQLAlchemy（SQLite，可換 PostgreSQL/MSSQL）
- 狀態機：Batch.transition_to() 嚴格管控 RunStatus 流轉；異常狀態回滾
- Gate 機制：BLOCK 策略（非 WARN）；API 回傳 409 + code: gate_blocked
- EBR：EBREvent append-only；任何操作皆寫入事件，無法修改或刪除
- PLC 介面：EquipmentAdapter ABC 已定義；換 PLCAdapter 無需修改業務層
- SPC 匯出：SPCExport 含所有 ParameterReading + IPQCRecord JSON；廠商可直接對接 SPC 系統
- 測試：31 個 pytest 測試，覆蓋 gate 邏輯、狀態機、API 合約