平台化需求地圖
查看使用者需求是否已納入,以及已符合、部分符合、尚未符合。
開啟這裡是專案總覽入口,先回答「目前完成了什麼、哪些還沒做、我的需求是否已被納入」,再連到細節文件。
正式網站: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 第一版實作、完成稽核與線上驗收,3D Plugin / 多設備單元已完成邊界分析、決策確認、contract 草案、contract 決策確認表、完成稽核、程式 repo 唯讀結構檢查與線上查驗;API、ServiceHost、Plugin Loader、外部 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,不改啟動方式。 | 3C 已收斂,3D 邊界分析已建立。 |
| 3D Plugin / 多設備單元 | 程式 repo 結構檢查線上查驗完成 | 已整理外部 DLL、多設備單元、Resource Lock、Command Queue、Plugin metadata、設定版本與停止線,並完成 3D contract 草案 / 實作前確認表、決策確認表、完成稽核、線上驗收、程式 repo 唯讀盤點與結構檢查線上查驗;尚未載入外部 DLL、建立 Plugin Loader、改 Adapter public contract 或修改 config schema。 | 整理 3D Application contract 草案 / 實作前確認表。 |
程式狀態由程式 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 抽象作為擴充基礎,3D 已建立 Plugin 邊界分析。 | Plugin Loader、DLL 掃描、版本控管與載入安全仍需另行確認後才可實作。 |
| 一台控制主機管理多個設備單元 | 部分符合 | 已有 DeviceId、Adapter Dispatcher、Workflow 綁定設備與 DeviceId Log,3D 已整理 ControlUnitId / StationId / DeviceId 邊界。 | 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 狀態。
開啟確認 Plugin DLL、多設備單元、Resource Lock、Command Queue、設定版本與停止線。
開啟逐項確認多設備單元命名、Resource Lock、Command Queue、Plugin metadata、Adapter contract 與停止線。
開啟確認多設備單元 DTO、Resource Lock、Command Queue、Plugin metadata、測試策略與停止線。
開啟逐項回覆多設備單元 contract、Resource Lock、Command Queue、Plugin metadata 與停止線。
開啟確認 3D contract 前置節點已完成,並保留 Plugin Loader、DLL、Adapter contract 與 config schema 停止線。
開啟確認文件 repo push 後,Cloudflare Pages 首頁、第三階段儀表板、3D 稽核頁與 status.json 已反映 3D 狀態。
開啟唯讀盤點 Application、Adapter dispatcher、config schema 與 Plugin Loader 停止線,確認 3D contract 承接位置。
開啟確認文件 repo push 後,Cloudflare Pages 首頁、新結構檢查頁、第三階段儀表板與 status.json 已反映結構檢查狀態。
開啟查找所有規劃、驗證紀錄、實作前確認與開發日誌。
開啟