智慧設備順序控制系統共用骨架
本專案用於建立可重複使用、可擴充、可維護、可追蹤的智慧設備順序控制系統共用骨架。
適用場景包含醫院智慧藥局、智慧調劑台、電子紙、RFID、燈號導引、門禁、秤重、藥櫃、傳送櫃、PLC / IO 控制等。
正式文件網站
https://hs-device-control-template-docs.pages.dev/
目前階段
目前處於前導作業與第一階段開工準備。
第一階段目標是先完成可驗證的控制核心，而不是一次完成完整平台。
Repository 定位
本 repository 採用「方案 B：文件 repo 與程式 repo 分開」。
目前 repo：
hs-device-control-template-docs用途：
- 前導文件
- 架構方向
- 第一階段開工規格
- AI / Codex 工作規則
- docs 文件
- public 靜態網站發布包
未來正式程式碼 repo：
hs-device-control-template用途：
- .NET 5.0 Solution
- Core Library
- Device Adapters
- ConsoleHost
- Tests
- config / samples
執行檔、安裝包與部署包不放入文件 repo。未來可使用 GitHub Releases、CI/CD artifact 或公司內部檔案庫管理。
第一階段技術決策
- .NET 版本：
.NET 5.0 - 測試框架：
xUnit - 第一階段 Host：
ConsoleHost - 第一階段設備：
Mock Adapter - 第一階段 Log：
Interface + FileLogWriter / ConsoleLogWriter / MemoryLogWriter - 第一個代表流程：
燈號導引 + Sensor 驗證
第一階段 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。
- 建立單元測試與流程模擬測試。
第一階段不做事項
- 不接真實硬體。
- 不做完整 WinForms Debug Tool。
- 不做正式 Web UI。
- 不做中央 Server。
- 不做多案場管理。
- 不做報表與統計分析。
- 不導入正式資料庫。
- 不做完整權限系統。
- 不把案場客製邏輯寫入共用 Core。
文件入口
docs 文件索引
- docs/README.md
- docs/prompt-library.md
- docs/error-codes.md
- docs/log-format.md
- docs/workflow-schema.md
- docs/config-schema.md
歸檔資料
開工前建議順序
- 確認前導完成檢查表。
- 確認架構方向與開工規格。
- 確認 AGENTS.md。
- 建立 C# Solution 與專案骨架。
- 建立 Core 模型與 Result / ErrorCode。
- 建立 WorkflowEngine / StateMachine / TaskEngine。
- 建立 Mock Adapter。
- 建立 ConsoleHost 代表流程。
- 建立 xUnit 測試。
- 驗收第一階段 MVP。
Git 規則
- Commit 訊息需使用繁體中文。
- Commit 訊息需清楚描述本次變更目的。
- 避免使用
update、fix、change等過於籠統的訊息。