# 前導完成檢查表

## 1. 已完成

- 架構方向文件已拆分完成。
- 第一階段開工規格文件已拆分完成。
- Repository 分工已決定採用方案 B：文件 repo 與程式 repo 分開。
- 目前 repo 名稱已決定為 `hs-device-control-template-docs`。
- 未來程式碼 repo 名稱已建議為 `hs-device-control-template`。
- GitHub repository 已建立並推送：`Hongsen-tw/hs-device-control-template-docs`。
- Cloudflare Pages 正式文件網站已發布：https://hs-device-control-template-docs.pages.dev/
- 原始完整計畫書已移至 `archive/舊版計畫書/`。
- 文件首頁 `index.html` 已建立。
- 文件已整理為響應式網頁，支援手機閱讀。
- 文件已加入列印 / 匯出 PDF 按鈕。
- 第一階段技術基底已決定為 `.NET 5.0`。
- 第一階段測試框架已決定為 `xUnit`。
- 第一階段主要 Host 已決定為 `ConsoleHost`。
- 第一階段設備實作已決定先用 `Mock Adapter`。
- 第一階段 Log 策略已決定為 `Interface + FileLogWriter / ConsoleLogWriter / MemoryLogWriter`。
- 第一個代表流程已決定為「燈號導引 + Sensor 驗證」。
- `AGENTS.md` 已擴充為正式專案 AI 開發規範。
- 對話規則已納入 `AGENTS.md`：回答問題、完成分析或完成工作後，主動詢問下一步。
- 第一階段前端人工驗證範圍已確認：文件網站、手機閱讀版與 PDF / 列印版需要人工檢查；正式產品 UI 操作驗證延後到 WinForms Debug Tool 或 Web UI 階段。

## 2. 已確認的第一階段 MVP

- C# Solution 與基本專案結構。
- `HS.DeviceControl.Core`
- `HS.DeviceControl.Adapters`
- `HS.DeviceControl.ConsoleHost`
- `HS.DeviceControl.Core.Tests`
- `HS.DeviceControl.Adapters.Tests`
- `HS.DeviceControl.WorkflowSimulation.Tests`
- WorkflowNode / WorkflowEngine。
- StateMachine / TaskEngine。
- IDeviceAdapter 與 Mock Adapter。
- 標準 Result / ErrorInfo / ErrorCode。
- FileLogWriter / ConsoleLogWriter / MemoryLogWriter。
- devices.json / workflows.json / appsettings.json 範例。
- Config Validator。
- 單元測試與流程模擬測試。
- README.md 初版。
- AGENTS.md 初版。
- 前端人工驗證範圍與觸發時機。

## 3. 已確認的第一階段不做事項

- 不接真實硬體。
- 不做完整 WinForms Debug Tool。
- 不做正式 Web UI。
- 不做中央 Server。
- 不做多案場管理。
- 不做報表與統計分析。
- 不導入正式資料庫。
- 不做完整權限系統。
- 不把案場客製邏輯寫入共用 Core。

## 4. 待確認

- 是否要立即建立未來程式碼 repo `hs-device-control-template`。
- 是否要立即建立實際 C# Solution。
- README.md 是否要現在建立。
- 第一階段是否需要建立 `docs/` 資料夾並放入 HTML / Markdown 文件。
- `promt` 資料夾是否要整理、重新命名為 `prompt`，或移入 `archive`。
- 是否需要把目前 HTML 文件另存成 Markdown 版本，方便 Git diff 與後續維護。
- 是否需要匯出 PDF 版給主管或團隊確認。

## 5. 建議補強

- 建立 README.md，作為工程師快速進入專案的入口。
- 建立 `docs/` 資料夾，集中放架構方向、開工規格、Prompt Library、錯誤代碼表、Log 格式說明。
- 建立 `docs/prompt-library.md`，避免 Prompt 範例散落。
- 建立 `docs/error-codes.md`，讓錯誤碼可獨立維護。
- 建立 `docs/log-format.md`，明確定義 Log 欄位。
- 建立 `docs/workflow-schema.md`，明確定義 workflows.json。
- 建立 `docs/config-schema.md`，明確定義 devices.json / appsettings.json。

## 6. 開工前建議順序

1. 確認本檢查表。
2. 建立 README.md。
3. 整理 docs/ 文件資料夾。
4. 建立 C# Solution 與專案骨架。
5. 建立 Core 模型與 Result / ErrorCode。
6. 建立 WorkflowEngine / StateMachine / TaskEngine。
7. 建立 Mock Adapter。
8. 建立 ConsoleHost 代表流程。
9. 建立測試矩陣對應的 xUnit 測試。
10. 在需要畫面確認的節點執行前端人工驗證。
11. 驗收第一階段 MVP。