開發進度總覽
追蹤每個模組的狀態、預計完成時間、實際完成時間、對應 repo 與備註。
最新程式狀態
- 目前階段
- 程式 repo poc/nmodbus-tcp 分支已更新：整理第一階段驗收總結
- 最新更新
- 2026-05-29
- 程式 repo
- hs-device-control-template
- 程式最新版本
7da3b24分支：poc/nmodbus-tcp
整理第一階段驗收總結- 狀態同步
- 已由 github-actions 更新
- 下一步
- 檢視最新 commit 與測試結果，必要時同步更新開發進度文件。
開發進度快照
100%
第一階段骨架
進度判讀：第一階段驗收總結已確認，第一階段正式標記完成
46%
303
c09da28
65%
第二階段已完成 Query Builder / Row Mapper 實作前確認，下一步可進入程式 repo 結構檢查。
階段完成 / 未完成邊界
第一階段已完成
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 前置確認、Query Builder / Row Mapper 設計與實作前確認已完成。
第二階段未完成 / 待推進
資料持久化與正式入口
- MySQL 實際連線測試與權限確認尚未完成。
- TaskStore 實作、資料寫入 / 查詢 / 狀態恢復測試尚未完成。
- 啟動時自動建立 Table / Column / Index 的執行器尚未完成。
- WebApi、ServiceHost、WinForms Debug Tool 仍未進入實作。
Query Builder / Row Mapper 實作前確認
列出準備新增的 class、method、測試檔、影響範圍與必須停下確認的停止線。
MySQL 行前連線資訊
列出進入程式實作前需確認的 Host、Port、Database、User、Password 提供方式與權限。
README
工程師與 Codex 進入專案時的第一份文件，包含目前階段、第一階段決策、MVP 範圍與文件索引。
docs 文件索引
集中放置規劃、設計、驗證紀錄、Prompt Library、錯誤代碼、Log 格式與開發日誌。
第二階段 / MySQL 文件
目前第二階段以 MySQL TaskStore PoC 與 Schema Attribute 為主軸，相關設計集中在這裡。
第二階段規劃總覽
整理第一階段驗收完成後的 MySQL、ServiceHost / WebApi、真實設備 Adapter 與 .NET 升級規劃方向。
第一個主軸選型
比較 MySQL、ServiceHost / WebApi、真實設備 Adapter、.NET 升級與維運觀測。
MySQL PoC 確認清單
整理 MySQL 5.6.2 相容性、TaskStore PoC 範圍、資料保存邊界、驗收標準與決策。
MySQL 套件選型
比較 MySqlConnector、Dapper、Pomelo EF Core 與 MySql.Data，建議第一版 PoC 先採用 MySqlConnector。
MySQL 自動建表設計
規劃由 C# Class 維護欄位型別、索引與描述，並於啟動時自動建立缺少的 Table / Column / Index。
MySQL schema Class 初稿
整理 TaskStore PoC 第一版四個 record class 的欄位、MySQL 型別、索引與描述。
Schema Attribute 與 SQL 產生器
整理 Attribute 使用方式、SQL Generator 邊界、MySQL 5.6.2 DDL 規則與後續實作順序。
SQL Generator 實作前確認
確認第一版只做 CREATE TABLE SQL 字串、型別白名單、命名規則、測試與禁止範圍。
SQL Generator 實作驗證
記錄 MySqlSchemaSqlGenerator 第一版完成內容、270 個測試結果、限制與下一步。
ALTER TABLE / Initializer 確認
確認 ALTER TABLE、Schema Initializer、Dry Run 與真實 MySQL 連線的自動化分級與禁止範圍。
ALTER TABLE Dry Run 實作
記錄 ALTER TABLE SQL 產生器、Dry Run Plan、278 個測試結果與尚未進入真實 DB 的邊界。
Schema Inspector 確認
整理 information_schema 只讀查詢範圍、MySQL 5.6.2 注意事項、測試策略與停下確認項目。
Inspector 介面確認
整理 ISchemaInspector、mock inspector、schema snapshot 回傳模型與單元測試範圍。
Inspector mock 實作
記錄 ISchemaInspector、mock inspector、SchemaInspectResult 與 286 個測試驗證結果。
Dry Run 串接設計
整理 SchemaDryRunPlanner 的責任邊界、輸入輸出、錯誤處理與測試案例。
Dry Run 串接實作
記錄 SchemaDryRunPlanner 第一版、297 個測試結果與尚未接入真實 DB 的邊界。
Dry Run 承接設計
整理 ConsoleHost 顯示、Schema Initializer、DryRun / Apply 分離與真實 MySQL 導入前條件。
Dry Run 顯示確認
確認 ConsoleHost 顯示格式、formatter、測試清單與只顯示 SQL preview 的禁止範圍。
Dry Run 顯示實作
記錄 ConsoleHost Schema Dry Run 顯示第一版、mock preview、測試結果與不連 DB / 不執行 DDL 的限制。
Dry Run 顯示驗證
整理 ConsoleHost 實際輸出，確認 Workflow 結果、Schema dry run、SQL preview 與安全警告皆符合預期。
Initializer DryRun 設計
定義 Schema Initializer 協調流程、DryRun / Apply 分離、ConsoleHost 接入策略與驗收標準。
Initializer DryRun 實作確認
確認第一版只建立 SchemaInitializer、request/result model、Core tests 與 MockSchemaInspector 串接。
Initializer DryRun 實作紀錄
記錄 SchemaInitializer 第一版、313 個測試結果與尚未接入真實 DB 的邊界。
Initializer ConsoleHost 接入設計
規劃 ConsoleHost 透過 SchemaInitializer 取得 dry run result，並保留既有啟動方式。
Initializer ConsoleHost 實作確認
確認下一步只做 formatter、demo request 與顯示測試，不連 MySQL、不執行 DDL。
Initializer ConsoleHost 實作紀錄
記錄 ConsoleHost 接入 SchemaInitializer、318 個測試結果與仍不連 DB / 不執行 DDL 的限制。
Initializer DryRun 人工驗證
整理 ConsoleHost 實際輸出，確認 initializer dry run 與 SQL preview 的實際效果。
Schema Automation 收尾
確認第一輪 mock / dry run / ConsoleHost 顯示與人工驗證已完成，並列出進入真實 MySQL Inspector 前的確認項。
真實 MySQL Inspector 前置確認
整理唯讀 DB metadata、連線安全、MySQL 5.6.2 注意事項、測試策略與停止條件。
MySqlSchemaInspector 實作前確認
整理實作位置、MySqlConnector 導入條件、query builder、row mapping、測試案例與人工驗證節點。
Query Builder / Row Mapper 設計
整理不連 DB 的查詢產生器、metadata row mapper、snapshot assembly 與單元測試。
Query Builder / Row Mapper 實作前確認
列出準備新增的 class、method、測試檔、影響範圍與停止線。
第一階段 / 驗收收尾
第一階段完成標準與前導檢查表保留在收合區，避免首頁被歷史文件淹沒。