平台化需求地圖
查看使用者需求是否已納入,以及已符合、部分符合、尚未符合。
開啟這裡是專案總覽入口,先回答「目前完成了什麼、哪些還沒做、我的需求是否已被納入」,再連到細節文件。
正式網站:https://hs-device-control-template-docs.pages.dev/第一階段已完成控制核心;第二階段 A 已完成 MySQL TaskStore 與 Schema Automation PoC;第二階段 B 已完成 DB LogWriter / TraceStore 第一版、manual-only xUnit 驗證入口、真實 DB 驗證前確認清單、TaskTraceStore 查詢邊界設計、Apply 安全策略與測試 DB DDL 與真實 DB 驗證通過紀錄;第三階段 3C 已完成 Application contract 第一版實作、完成稽核與線上驗收,但 API、ServiceHost、外部 DLL 與多設備單元實作仍屬後續正式平台。
控制核心、ConsoleHost、Adapter、Log、Config 與驗證節點已完成。
第二階段 A / B 已完成;DB LogWriter / TraceStore、測試 DB DDL、task_log_traces 寫入 / 查詢 / cleanup、TaskTraceStore 查詢邊界與 Schema Apply 安全策略已收斂。
包含資料庫、WebApi、ServiceHost、WinForms、真實硬體與部署成熟度。
| 第三階段主線 | 目前狀態 | 目前邊界 | 下一個可執行項目 |
|---|---|---|---|
| 3A Trace 查詢能力 | 已完成 | 已新增 ITaskTraceStore、Core 查詢 DTO、MySqlTaskTraceStore fake gateway 查詢、HasMore 分頁、遮罩與錯誤測試,並完成測試 DB write/read/cleanup 補驗:寫入 2 筆、查回 2 筆、cleanup 刪除 2 筆。 | 3A 已收斂,作為 3B 前置基礎。 |
| 3B DB 初始化安全流程 | 完成稽核與線上驗收已完成 | 程式 commit 13c14ca 已新增 ManualApplyPreview model、builder、PlanHash、CanApply=False、風險分級、ConsoleHost 顯示與完成稽核;文件網站已完成首頁、稽核頁與 status.json 內容比對;仍未執行 DDL 或正式 Apply。 | 可另行確認真實 DB read-only preview 驗證。 |
| 3C Service / API 入口 | 線上驗收已完成 | 程式 commit aee6ab6 已新增 Application 專案、測試專案、Task / Device / Schema / Health contract 與薄 service;Application tests 15 passed,solution tests 453 passed;文件網站已完成 3C 線上內容比對;尚未導入 WebApi / ServiceHost,不改啟動方式。 | 可進入 3D Plugin / 多設備單元邊界分析。 |
| 3D Plugin / 多設備單元 | 尚未開始 | 已有 Adapter 抽象與 DeviceId 基礎,尚未載入外部 DLL 或建立資源鎖。 | 整理平台化擴充需求與風險。 |
程式狀態由程式 repo push 後同步;進度快照在完成可驗收節點後整理。
aee6ab6 分支:poc/nmodbus-tcp用「已符合 / 部分符合 / 尚未符合」標示目前狀態,避免把後續平台能力誤看成已完成。
| 需求 | 目前狀態 | 現在已具備 | 尚未完成 / 所屬階段 |
|---|---|---|---|
| 程式邏輯、設備動作可由 JSON 或工具編程,不影響核心 | 部分符合 | 已有 JSON 設定、Config Loader / Mapper / Validator、Workflow 與 Adapter 抽象。 | 圖形化工具、設定版本控管、熱更新與回滾屬後續平台。 |
| 使用 API 呼叫,由 Server 控制設備狀態並查詢設備狀態 | 尚未符合 | 已有 Workflow / Adapter / Task / Log 基礎,第二階段已補上 TaskStore 與 node_executions 持久化驗證。 | WebApi、API contract、認證授權與設備狀態 API 屬第三階段。 |
| 控制端透過 Service 掌握順序控制或控制裝置 | 尚未符合 | ConsoleHost 已可驗證核心流程。 | ServiceHost、背景常駐、任務佇列、重啟恢復屬第三階段。 |
| 裝置可動態載入外部 DLL,例如馬達、面板或其他設備模組 | 尚未符合 | 已有 IDeviceAdapter 抽象作為擴充基礎。 | Plugin Loader、DLL 掃描、版本控管與載入安全屬第三階段。 |
| 一台控制主機管理多個設備單元 | 部分符合 | 已有 DeviceId、Adapter Dispatcher、Workflow 綁定設備與 DeviceId Log。 | ControlUnitId / StationId、Resource Lock、Command Queue、急停與狀態隔離屬第三階段。 |
這裡只列邊界,不取代細節文件;需要完整歷程時進入開發進度總覽或 docs 索引。
task_log_traces schema class、LogEntry mapper、payload sanitizer、fake gateway 測試、fallback、HS_MYSQL_LOGWRITER_* gate、查詢 / cleanup helper、測試 DB DDL 建表與真實 DB 寫入 / 查詢 / cleanup 驗證已完成。首頁保留五個主要入口,其餘細節收進下方「其他文件」。
查看使用者需求是否已納入,以及已符合、部分符合、尚未符合。
開啟查看百分比、完成時間、測試數、commit 與長期平台進度。
開啟查看第二階段 A / B 已完成內容與後續階段保留項。
開啟查看 3A Trace 查詢、3B DB 初始化、3C Service / API、3D Plugin / 多設備單元的狀態與下一步。
開啟確認 DB 初始化安全 preview 的資料模型、風險分類、輸出格式與停止線。
開啟逐項確認 ManualApplyPreview 進程式實作前的七項決策。
開啟查看第一版安全預覽、測試結果與後續停止線。
開啟確認 ManualApplyPreview 第一版是否可驗收完成,以及後續仍需確認的項目。
開啟確認文件 repo push 後,Cloudflare Pages 首頁、稽核頁與 status.json 已反映最新 3B 狀態。
開啟確認 ServiceHost、WebApi、Application Service、DTO、權限與停止線。
開啟逐項確認 Application Service、ServiceHost、WebApi、Task Control、Device Status、Schema Preview 與停止線。
開啟唯讀盤點程式 repo 結構、可承接能力、候選檔案、測試策略與停止線。
開啟Application contract 第一版已完成,提交前變更範圍、測試證據與建議 commit 訊息已整理。
開啟確認文件 repo push 後,Cloudflare Pages 首頁、第三階段儀表板、3C 提交前確認頁與 status.json 已反映 3C 狀態。
開啟查找所有規劃、驗證紀錄、實作前確認與開發日誌。
開啟