3C Application contract commit / push 前確認
本文件整理 3C Application contract 第一版完成後，程式 repo 與文件 repo 在 stage / commit / push 前需要確認的範圍、驗證證據、停止線與建議 commit 訊息。
0. 確認結論
| 項目 | 結論 |
| 確認日期 | 2026-06-04 |
| 3C 節點 | Application contract 第一版 |
| 程式 repo | hs-device-control-template |
| 程式分支 | poc/nmodbus-tcp |
| 文件 repo | AI自動控制骨架 |
| 文件分支 | main |
| 程式測試 | Application tests 15 passed；solution tests 453 passed |
| 文件驗證 | JSON parse 通過；public/ 與來源檔 hash 比對通過 |
| 停止線 | 未新增 WebApi / ServiceHost、未新增 route、未執行 DDL / Apply |
| 建議動作 | 可進入 stage / commit；push 需使用者明確指示 |
1. 程式 repo 變更範圍
建議程式 repo 本次提交只包含 3C Application contract 第一版相關檔案：
| 類型 | 路徑 / 範圍 | 說明 |
| 修改 | HS.DeviceControl.sln | 將 Application 與 Application.Tests 加入 solution。 |
| 新增 | src/HS.DeviceControl.Application/ | Application contract、DTO、薄 service。 |
| 新增 | tests/HS.DeviceControl.Application.Tests/ | Task / Device / Schema / Health contract 測試。 |
主要新增內容包含 Task、Device、Schema、Health 四組 contract、DTO 與薄 service，以及對應測試。
2. 文件 repo 變更範圍
| 類型 | 路徑 / 範圍 | 說明 |
| 新增 | docs/service-api-boundary-analysis.* | 3C Service / API 邊界分析。 |
| 新增 | docs/service-api-decision-confirmation.* | 3C Service / API 決策確認表。 |
| 新增 | docs/service-api-code-structure-preimplementation-checklist.* | 程式 repo 結構檢查與實作前確認。 |
| 新增 | docs/service-api-application-contract-preimplementation-checklist.* | Application contract 草案與實作前確認。 |
| 新增 | docs/service-api-application-contract-decision-confirmation.* | Application contract 七項決策確認。 |
| 新增 | docs/service-api-application-contract-implementation-record.* | Application contract 第一版實作紀錄。 |
| 新增 | docs/service-api-application-contract-3c-completion-audit.* | 3C 完成稽核表。 |
| 新增 | docs/service-api-application-contract-commit-push-precheck.* | 本次 commit / push 前確認。 |
| 修改 | README.*、docs/README.* | 補 3C 文件索引與閱讀順序。 |
| 修改 | docs/phase-three-dashboard.* | 3C 狀態更新為 Application contract 第一版完成。 |
| 修改 | index.html、progress.json、status.json、開發進度總覽.* | 首頁與進度狀態同步到 3C 完成。 |
| 修改 | public/ 對應檔案 | 靜態網站發布包同步。 |
3. 已完成驗證
| 驗證項目 | 結果 |
dotnet test tests\HS.DeviceControl.Application.Tests\HS.DeviceControl.Application.Tests.csproj | 15 passed、0 failed |
dotnet test HS.DeviceControl.sln | 453 passed、0 failed |
| JSON UTF-8 parse | progress.json、status.json 與 public/ 對應檔案通過 |
public/ hash 比對 | 來源檔與 public/ 對應檔案一致 |
| 3C 舊狀態掃描 | 目前收尾檔未命中舊狀態 |
| 污染字串掃描 | 本輪收尾文件與新程式碼未命中 |
| 邊界停線掃描 | 未發現 ASP.NET route、controller、background service、DDL / Apply 實作 |
已知提醒：solution 測試仍會出現既有 .NET 5.0 EOL warning NETSDK1138，不影響本次測試通過判定。
4. 停止線確認
| 停止線 | 是否符合 |
不新增 ServiceHost 專案 | 符合 |
不新增 WebApi 專案 | 符合 |
| 不新增 API route / controller / endpoint / middleware | 符合 |
| 不導入認證授權、queue、background service 或 web framework 套件 | 符合 |
不執行 DB DDL、ALTER TABLE、正式 Apply | 符合 |
| 不修改 Core / Adapter / Infrastructure 既有 public method 簽章 | 符合 |
| 不修改啟動方式 | 符合 |
| 不 push、force push、reset、rebase 或刪除分支 | 符合，尚未執行 |
5. 建議 commit 訊息
程式 repo 建議 commit：
新增 3C Application contract 第一版
- 新增 Application 專案與 Task / Device / Schema / Health contract
- 新增 Application contract 測試
- 將 Application 與 Application.Tests 加入 solution文件 repo 建議 commit：
整理 3C Application contract 文件與提交前確認
- 新增 3C Service / API 分析、決策、實作與完成稽核文件
- 新增 3C commit / push 前確認
- 同步 README、第三階段儀表板、首頁、進度 JSON 與 public 發布包6. 建議執行順序
- 先 stage / commit 程式 repo，讓 3C Application contract 程式變更成為可追蹤節點。
- 再 stage / commit 文件 repo，讓文件狀態對應程式 repo 的 3C 完成節點。
- push 程式 repo 後，確認 remote branch
poc/nmodbus-tcp已更新。 - push 文件 repo 後，查部署狀態並整理線上驗收紀錄。
7. 後續執行狀態
- 程式 repo 已於 2026-06-05 stage / commit / push。
- 程式 repo commit：
aee6ab6。 - 程式 repo branch：
poc/nmodbus-tcp。 - 文件 repo 已於 2026-06-05 stage / commit / push。
- 文件 repo commit：
71ec8fb。 - 文件網站已完成 Cloudflare Pages 線上內容比對。
- 已整理 3C Application contract 線上驗收紀錄。
8. 結論
3C Application contract 第一版已完成程式 repo push、文件 repo push 與線上驗收。建議下一步進入 3D Plugin / 多設備單元邊界分析，或另行確認真實 DB read-only ManualApplyPreview 驗證。