docs(governance): 記錄 P1-005 正式驗證 [skip ci]

This commit is contained in:
Your Name
2026-06-05 14:35:45 +08:00
parent 620b2c3a42
commit d1b4e5a3cc
3 changed files with 27 additions and 30 deletions

View File

@@ -1,4 +1,4 @@
## 2026-06-05P1-005 服務健康缺口與過期端點本地完成
## 2026-06-05P1-005 服務健康缺口與過期端點正式上線
**背景**:接續 P1-004 AI Provider 路由矩陣正式驗證,依工作清單推進 `P1-005`。本段只建立 committed service health gap matrix、只讀 API 與治理頁顯示;不做 live probe / external probe、不重啟 service / pod / host、不修改 endpoint / ConfigMap、不讀 Secret / Redis / DB payload、不發 Telegram / AwoooP 通知、不觸發 workflow / deploy / reload / runtime execution。
@@ -17,21 +17,35 @@
**本地驗證**
- JSON parse 通過:`service_health_gap_matrix_2026-06-05.json``service_health_gap_matrix_v1.schema.json`、automation backlog / inventory snapshots、zh-TW / en messages。
- 目標測試通過service health gap matrix service / API、automation inventory / backlog snapshot service / API 共 `25 passed`
- 目標測試通過service health gap matrix service / API、automation inventory / backlog snapshot API、AI provider route matrix service / API 共 `22 passed`
- Python py_compile 通過:`apps/api/src/services/service_health_gap_matrix.py``apps/api/src/api/v1/agents.py`
- zh-TW / en i18n key 差異 `0`web typecheck 通過Next production build 通過,治理頁 First Load JS `387 kB``source-control-owner-response-guard.py``security-mirror-progress-guard.py``git diff --check` 通過。
- 本地 API readbackservice health gap matrix 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`backlog 回 overall `88%`、done `21/24`inventory 回 tasks `31`
**待補**
- 推送 Gitea 後等待 deploy marker補 production API readback 與 desktop / mobile browser smoke再更新正式驗證紀錄
**正式部署**
- Code commit`1007a1bc feat(governance): 新增服務健康缺口矩陣`
- Deploy marker`620b2c3a chore(cd): deploy 1007a1b [skip ci]`
- Gitea code-review `#2609` 成功CD `#2608` 成功並推回 deploy marker。
**正式驗證**
- Production `/api/v1/health` 200`healthy`、environment `prod`、mock_mode `false`
- Production `/api/v1/agents/service-health-gap-matrix` 200schema `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`service restart / endpoint change / active probe allowed counts 全部 `0`
- Production `/api/v1/agents/automation-backlog-snapshot` 200current `P1-005`、next `P1-006`、overall `88%`、done `21/24`
- Production `/api/v1/agents/automation-inventory-snapshot` 200current `P1-005`、next `P1-006`、tasks `31`
- Production browser smoke
- Desktop `1440x1000``https://awoooi.wooo.work/zh-TW/governance?tab=automation-inventory&_v=620b2c3a-p1-005-prod-desktop-clean`
- Mobile `390x844``https://awoooi.wooo.work/zh-TW/governance?tab=automation-inventory&_v=620b2c3a-p1-005-prod-mobile`
- 皆確認:`服務健康缺口與過期端點``P1-005``P1-006``88%``健康目標``過期端點``健康缺口``不可誤讀合約``允許入口` 可見。
- Desktop / mobile`horizontalOverflow=0`、overflowing elements `0`、內容危險操作入口 `0`、錯誤文字 `0`、production 相關 console error `0`
- 截圖:`/tmp/awoooi-p1-005-service-health-prod-desktop-clean-620b2c3a.png``/tmp/awoooi-p1-005-service-health-prod-mobile-620b2c3a.png`
**邊界**
- Live probe、external health probe、service / pod / host restart、rollout restart、endpoint / ConfigMap 修改、provider switch、paid API call、Secret payload read、通知發送、workflow / deploy / reload / runtime execution 全部仍未批准。
- P1-005 UI / API 可見只代表 committed service health gap matrix 完成,不代表任何健康檢查已 live 執行,也不代表 runtime gate、S4.9 owner response gate 或 security acceptance gate 已提高。
**下一步**
1. 完成本輪 build、Gitea push、正式 deploy marker 追蹤與 production smoke
2. P1-006在 UI 顯示更細緻的 service health evidence cards
1. P1-006在 UI 顯示更細緻的 service health evidence cards
2. P1-007建立 service health 失敗限定 Telegram / AwoooP 對應;成功 smoke 不即時通知,避免洗版
## 2026-06-05P1-004 AI Provider 路由矩陣正式上線

View File

@@ -1108,8 +1108,8 @@ UI
狀態變更:待辦 -> 完成。
證據service_health_gap_matrix_v1 schema / snapshotGET /api/v1/agents/service-health-gap-matrix治理頁服務健康缺口與過期端點區塊automation backlog 88%inventory tasks 31。
目前數字service health targets 10需處置 targets 5stale endpoints 3health gaps 5service restart / endpoint change / active probe / notification send / runtime execution allowed counts 全部 0backlog done 21/24overall 88%P1 95%WS3 監控自動化 100%。
驗證JSON parse 通過service health gap matrix service / API、automation inventory / backlog snapshot service / API 目標測試 `25 passed`Python py_compile 通過zh-TW / en i18n key 差異 `0`web typecheck 通過source-control-owner-response guard、security-mirror-progress guard、git diff --check 通過;本地 API readback 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`backlog 回 `88%`、done `21/24`inventory 回 tasks `31`。
正式驗證:code commit 推送 Gitea、取得 deploy marker 後補 production API readback 與 desktop / mobile browser smoke
驗證JSON parse 通過service health gap matrix service / API、automation inventory / backlog snapshot API、AI provider route matrix service / API 目標測試 `22 passed`Python py_compile 通過zh-TW / en i18n key 差異 `0`web typecheck 通過Next production build 通過source-control-owner-response guard、security-mirror-progress guard、git diff --check 通過;本地 API readback 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`backlog 回 `88%`、done `21/24`inventory 回 tasks `31`。
正式驗證code commit `1007a1bc` 已推 `gitea main`deploy marker `620b2c3a chore(cd): deploy 1007a1b [skip ci]`Gitea code-review `#2609` 成功、CD `#2608` 成功。Production health `healthy/prod/mock_mode=false`service health gap matrix API 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`、service restart / endpoint change / active probe allowed counts 全部 `0`backlog API 回 overall `88%`、done `21/24`inventory API 回 tasks `31`。Production desktop `1440x1000` 與 mobile `390x844` smoke 通過,`服務健康缺口與過期端點`、`P1-005`、`P1-006`、`88%`、`健康目標`、`過期端點`、`健康缺口`、`不可誤讀合約`、`允許入口` 可見production 相關 console error `0`、`horizontalOverflow=0`、overflowing elements `0`、內容危險操作入口 `0`
阻擋live probe、external health probe、service / pod / host restart、rollout restart、endpoint / ConfigMap 修改、provider switch、paid API call、Secret payload read、通知發送、workflow/deploy/reload/runtime execution 仍全部禁止。
下一步P1-006 在 UI 顯示 service health 證據卡。
```

View File

@@ -3535,24 +3535,6 @@ Phase 6 完成後
**裁決:** P1-003 只完成 read-only observability contract matrix 與降噪候選顯示。不得把 Prometheus rule count、Alertmanager grouping、SigNoz / Sentry heartbeat、Grafana dashboard JSON、OTEL/Event Exporter evidence 或 classification gap 解讀成 alert rule 變更、receiver/route 變更、OpenClaw receiver 授權、silence、dashboard import、webhook 修改、secret 讀取、通知發送、deploy/reload/workflow 或 runtime execution 批准。成功 smoke 不即時通知洗版;失敗與需處置才進批准流程。
### 2026-06-05 下午 (台北) — P1-005 服務健康缺口與過期端點本地完成
**觸發**:統帥批准繼續,接續 P1-004 正式驗證後推進 `docs/ai/AI_AGENT_AUTOMATION_WORKLIST_2026-06-04.md` 的 P1-005只建立 committed service health gap evidence、只讀 API 與治理頁顯示。
**已推進:**
- P1-005新增 `service_health_gap_matrix_v1` schema 與 `docs/evaluations/service_health_gap_matrix_2026-06-05.json`,涵蓋 API / Web / AI provider / Observability / Gitea / Backup / Security edge 的服務健康目標、健康缺口與過期端點 reference。
- P1-005新增 `GET /api/v1/agents/service-health-gap-matrix` 與 service guard強制驗證 read-only mode、operation / approval boundaries、rollup consistency、target / health gap / stale endpoint evidence、operator denial 與禁止 secret payload key。
- P1-005治理頁 `/zh-TW/governance?tab=automation-inventory` 新增「服務健康缺口與過期端點」區塊;顯示健康目標、需處置、過期端點、健康缺口、不可誤讀合約與允許入口 0不新增任何執行按鈕。
- 目前數字service health targets `10`;需處置 targets `5`stale endpoints `3`health gaps `5`service restart / endpoint change / active probe / notification send / runtime execution allowed counts 全部 `0`automation backlog done `21/24`、overall `88%`、P1 `95%`inventory tasks `31`
- 本地驗證JSON parse 通過service health gap matrix service / API、automation inventory / backlog snapshot service / API 目標測試 `25 passed`Python py_compile 通過zh-TW / en i18n key 差異 `0`web typecheck 通過。
**待補驗證:**
1. Next production build。
2. `source-control-owner-response-guard.py``security-mirror-progress-guard.py``git diff --check`
3. 推送 Gitea 後取得 deploy marker補 production API readback 與 desktop / mobile browser smoke。
**裁決:** P1-005 只完成 service health gap matrix 的 committed evidence、API 與治理頁顯示。不得把 `service_health_gap_matrix_v1`、健康目標、過期端點、health gaps、source mismatch、owner attestation 或 UI 可見解讀成 live probe、服務重啟、endpoint / ConfigMap 修改、通知發送、provider switch、paid API call、Secret payload read、workflow / deploy / reload 或 runtime execution 批准。
### 2026-06-05 下午 (台北) — P1-004 AI Provider 路由矩陣正式上線
**觸發**:統帥批准繼續,要求依 `docs/ai/AI_AGENT_AUTOMATION_WORKLIST_2026-06-04.md` 的優先順序推進,並在每階段同步完成度、工作狀態、驗證節點與正式環境頁面檢查。
@@ -3571,7 +3553,7 @@ Phase 6 完成後
**裁決:** P1-004 只完成 read-only AI provider route matrix 與治理頁顯示。不得把 `ai_provider_route_matrix_v1`、Ollama 三層、Gemini final fallback、OpenClaw / Nemo RCA lane、Nemotron blocked candidate、legacy models registry 或 provider route source gaps 解讀成 provider 切換、付費呼叫、fallback 調整、OpenClaw 取代、Nemotron 升級、shadow / canary、Secret payload 讀取、workflow / deploy / reload 或 runtime execution 批准。
### 2026-06-05 下午 (台北) — P1-005 服務健康缺口與過期端點本地完成
### 2026-06-05 下午 (台北) — P1-005 服務健康缺口與過期端點正式上線
**觸發**:統帥批准繼續,並要求治理頁避免文字牆、以圖表 / 卡片 / 專業資訊架構呈現完整資訊,同時強化決策支援覆蓋率的參考性。
@@ -3581,9 +3563,10 @@ Phase 6 完成後
- P1-005治理頁 `/zh-TW/governance?tab=automation-inventory` 新增「服務健康缺口與過期端點」區塊;以 KPI、摘要磚、健康目標卡、過期端點清單、健康缺口清單與不可誤讀合約呈現降低文字牆閱讀負擔不新增任何執行按鈕。
- 目前數字service health targets `10`;需處置 targets `5`stale endpoints `3`health gaps `5`service restart / endpoint change / active probe / notification send / runtime execution allowed counts 全部 `0`automation backlog done `21/24`、overall `88%`、P1 `95%`、WS3 `100%`inventory tasks `31`
- 本地驗證JSON parse 通過service health gap matrix service / API、automation inventory / backlog snapshot API、AI provider route matrix service / API 目標測試 `22 passed`Python py_compile 通過zh-TW / en i18n key 差異 `0`web typecheck 通過Next production build 通過,治理頁 First Load JS `387 kB`source-control-owner-response guard、security-mirror-progress guard、`git diff --check` 通過;本地 API readback 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`backlog 回 `88%`、done `21/24`inventory 回 tasks `31`
- 正式環境code commit `1007a1bc`deploy marker `620b2c3a chore(cd): deploy 1007a1b [skip ci]`Gitea code-review `#2609` 成功、CD `#2608` 成功。Production service health gap matrix API 回 `service_health_gap_matrix_v1`、current `P1-005`、next `P1-006`、targets `10`、需處置 `5`、stale endpoints `3`、health gaps `5`、service restart / endpoint change / active probe allowed counts 全部 `0`backlog API 回 overall `88%`、done `21/24`inventory API 回 tasks `31`。Production desktop `1440x1000` 與 mobile `390x844` smoke 通過,`服務健康缺口與過期端點``P1-005``P1-006``88%``健康目標``過期端點``健康缺口``不可誤讀合約``允許入口` 可見production 相關 console error `0``horizontalOverflow=0`、overflowing elements `0`、內容危險操作入口 `0`
**待補**
1. Gitea push 後取得 deploy marker補 production API readback 與 desktop / mobile browser smoke
2. P1-006在 UI 顯示更細緻的 service health evidence cards
**下一步**
1. P1-006在 UI 顯示更細緻的 service health evidence cards
2. P1-007建立 service health 失敗限定 Telegram / AwoooP 對應;成功 smoke 不即時通知,避免洗版
**裁決:** P1-005 只完成 read-only service health gap matrix、API 與治理頁顯示。不得把 `service_health_gap_matrix_v1`、健康目標、過期端點、健康缺口、需處置清單或不可誤讀合約解讀成 live health check 已執行、服務重啟批准、endpoint 修改批准、通知發送批准、runtime gate 提高、S4.9 owner response gate 提高或 security acceptance 已成立。