開發日誌
本日誌記錄文件 repo 與未來程式 repo 的重要進度，方便回顧每次完成內容、完成時間與下一步。
2026-05-20
前導文件與網站發布
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| repo | hs-device-control-template-docs |
| 內容 | 建立架構方向、第一階段開工規格、README、docs 文件、前導完成檢查表 |
| 驗證 | GitHub repo 已推送，Cloudflare Pages 已發布 |
手機閱讀版與 PDF 版檢查
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| 內容 | 修正手機版排版、PDF 首頁空白頁、Markdown 文件列印標題重複 |
| 驗證 | 線上頁面已確認無水平溢出，PDF 頁數正常 |
開發進度追蹤規則
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| 內容 | 新增開發進度總覽與完成時間欄位規則 |
| 下一步 | 建立程式碼 repo 後，開始同步更新模組進度 |
程式 repo 建立
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| repo | @@HTML0@@ |
| 內容 | 建立智慧設備順序控制系統共用程式骨架 repository |
| 下一步 | 建立 .NET 5.0 Solution、Core、Adapters、ConsoleHost 與測試專案骨架 |
.NET 5.0 程式碼骨架初版
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| repo | @@HTML0@@ |
| commit | 96347b2 |
| 內容 | 建立 HS.DeviceControl.sln、Core、Adapters、ConsoleHost、Core.Tests、Adapters.Tests、WorkflowSimulation.Tests |
| 驗證 | dotnet test 通過 7 個測試；ConsoleHost 可執行燈號導引 + Sensor 驗證代表流程 |
| 注意 | .NET 5.0 會出現 EOL 警告，屬於目前指定版本的預期現象 |
| 下一步 | 補強 Workflow / Config / Log / TaskEngine 細節 |
註解撰寫規則
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| repo | 文件 repo / 程式 repo |
| 內容 | 新增中文註解、XML 註解、一般註解的撰寫規範 |
| 驗證 | 文件 repo 與程式 repo 均已加入 AGENTS.md；程式 repo 已啟用 XML 文件輸出設定 |
| 下一步 | 後續補強公開 API 時，同步補 XML 註解 |
程式碼 XML 註解補強
| 項目 | 內容 |
|---|
| 狀態 | 已完成 |
| 完成時間 | 2026-05-20 |
| repo | @@HTML0@@ |
| 內容 | Core 與 Adapters 的公開類別、介面、方法、屬性與 enum 補上繁體中文 XML 註解 |
| 驗證 | 公開 API 缺註解檢查無遺漏；dotnet test 通過 7 個測試 |
| 下一步 | 進入 Config / Workflow Schema / Log 格式與 TaskEngine 細節補強 |
後續記錄格式
每次重要開發後，建議新增一段：
## YYYY-MM-DD
### 模組或工作名稱
| 項目 | 內容 |
|---|---|
| 狀態 | 已完成 / 進行中 / 待確認 |
| 完成時間 | YYYY-MM-DD 或尚未完成 |
| repo | 文件 repo / 程式 repo |
| commit | commit hash 或 PR 連結 |
| 內容 | 本次完成的重點 |
| 驗證 | 測試、頁面檢查或人工確認 |
| 下一步 | 下一個建議動作 |