智慧設備順序控制系統共用骨架|文件首頁

已將原計畫書拆成「架構方向」與「第一階段開工規格」兩份文件,並加入開發進度追蹤,方便主管溝通、工程開工、手機閱讀與後續匯出 PDF。

正式網站:https://hs-device-control-template-docs.pages.dev/

自動同步

最新程式狀態

此區由程式 repo push 後自動同步,反映最新 commit;不代表進度百分比已更新。

目前階段
程式 repo poc/nmodbus-tcp 分支已更新:整理第一階段驗收總結
最新更新
2026-05-29
程式 repo
hs-device-control-template
程式最新版本
7da3b24 分支:poc/nmodbus-tcp
整理第一階段驗收總結
狀態同步
已由 github-actions 更新
下一步
檢視最新 commit 與測試結果,必要時同步更新開發進度文件。

正在讀取程式 repo 狀態資料...

人工快照

開發進度快照

此區由人工在完成可驗收節點後整理,不一定每次 commit 都更新。

100%
第一階段骨架
進度判讀:第一階段驗收總結已確認,第一階段正式標記完成

第一階段進度代表本階段約定交付範圍的驗收狀態,不代表長期完整平台成熟度。目前第一階段驗收總結已完成並由使用者確認,第一階段驗收進度正式標記為 100%。長期完整平台仍為 39%,資料庫、WebApi、ServiceHost、WinForms、真實硬體與正式部署能力列入第二階段或長期進度。dotnet test 最新通過 244 個測試。

長期平台46%
自動測試303
快照版本c09da28
第二階段進度63%

第二階段已完成 MySqlSchemaInspector 實作前確認清單,下一步需確認是否允許導入 MySqlConnector。

第二階段目前聚焦 MySQL TaskStore PoC 與 Schema 自動化。真實 metadata 讀取仍需另行確認套件導入、連線資訊與 DB 權限。

專案邊界

階段完成 / 未完成邊界

第一階段已作為 ConsoleHost 與共用骨架驗收範圍;第二階段目前進入 MySQL TaskStore 與資料持久化規劃 / PoC 範圍。

第一階段已完成

ConsoleHost 共用骨架驗收

  • Core / Workflow / StateMachine / TaskEngine 骨架完成。
  • Config Loader / Config Mapper / ConsoleHost 設定啟動完成。
  • Mock Adapter、Adapter Data、Workflow 條件轉移與 Log 承接完成。
  • Modbus TCP Adapter 第一版、錯誤輸出、節點歷程與人工驗證紀錄完成。
  • 第一階段測試與人工驗證節點已整理,階段進度標記 100%。
第一階段未完成 / 不納入

移出第一階段邊界

  • MySQL 任務持久化、正式資料庫建表與查詢不屬於第一階段。
  • WebApi、ServiceHost、WinForms Debug Tool 不屬於第一階段交付。
  • 真實案場硬體連線驗收、長時間穩定性與部署維運列入後續階段。
  • .NET 版本升級屬於正式化前評估,不影響第一階段驗收結論。
第二階段已完成

MySQL TaskStore 前置與設計

  • 第二階段規劃總覽與第一個主軸選型完成。
  • MySQL 5.6.2 相容性、行前連線資訊與填寫範本完成。
  • MySQL 套件選型、Schema 自動建表設計與 schema Class 初稿完成。
  • Schema Attribute、SQL Generator、Dry Run、Inspector mock 與 ConsoleHost Dry Run 顯示已推進。
  • Schema Automation 第一輪收尾、真實 MySQL Inspector 前置確認與 MySqlSchemaInspector 實作前確認已完成。
第二階段未完成 / 待推進

資料持久化與正式入口

  • MySQL 實際連線測試與權限確認尚未完成。
  • TaskStore 實作、資料寫入 / 查詢 / 狀態恢復測試尚未完成。
  • 啟動時自動建立 Table / Column / Index 的執行器尚未完成。
  • WebApi、ServiceHost、WinForms Debug Tool 仍未進入實作。
進度追蹤

開發進度總覽

追蹤每個模組的狀態、預計完成時間、實際完成時間、對應 repo 與備註。

目前主軸

MySqlSchemaInspector 實作前確認

整理實作位置、套件導入條件、query builder、row mapping、測試案例與人工驗證節點。

行前資料

MySQL 行前連線資訊

列出進入程式實作前需確認的 Host、Port、Database、User、Password 提供方式與權限。

工程入口

README

工程師與 Codex 進入專案時的第一份文件,包含目前階段、第一階段決策、MVP 範圍與文件索引。

完整索引

docs 文件索引

集中放置規劃、設計、驗證紀錄、Prompt Library、錯誤代碼、Log 格式與開發日誌。

第二階段 / MySQL 文件

目前第二階段以 MySQL TaskStore PoC 與 Schema Attribute 為主軸,相關設計集中在這裡。

第一階段 / 驗收收尾

第一階段完成標準與前導檢查表保留在收合區,避免首頁被歷史文件淹沒。

架構與開工文件

長期方向與第一階段開工規格仍可從首頁進入,但預設收合,讓首頁先呈現目前進度。