docs(web): record t100 dashboard flow rollout [skip ci]

2026-05-20 11:55:45 +08:00
parent 20026d4671
commit 1d6636cd0d
2 changed files with 118 additions and 0 deletions
--- a/docs/LOGBOOK.md
+++ b/docs/LOGBOOK.md
@@ -1,3 +1,113 @@
+## 2026-05-20｜T100 首頁 Incident flow 階段語意修正
+
+**觸發**：
+
+- 使用者指出首頁很多數據與「小龍蝦進度條」看起來沒有正常運作。
+- Production 盤點確認首頁與 Work Items 主要 API 目前皆為 200，資料面不是壞掉；但首頁 IncidentCard 只靠 pipeline 節點顏色表達 active stage，截圖或純文字很容易看成「告警 / AI 偵測 / AI 分析 / 提案生成 / 等待授權 / 執行 / 完成」全部都已完成。
+- 這會削弱 AwoooP 作為 AI 自動化管理介面的可信度：Operator 需要直接看到「目前卡在哪一階段」與「下一步」。
+
+**Production diagnosis**：
+
+```text
+Work Items browser network:
+  -> 11/11 target APIs responded 200
+  -> recurrence summary: open_work_item_group_total=9, automation_gap_group_total=8
+  -> governance queue total=211
+  -> knowledge review drafts total=119
+  -> dedupe schema=km_review_draft_dedupe_v1
+  -> drift fingerprint state: HIGH×0, MEDIUM×0, INFO×0
+  -> consoleErrors=0, pageErrors=0
+  -> screenshot /tmp/awoooi-t100-work-items-production-network.png
+
+Home browser network:
+  -> 16/16 target requests responded 200
+  -> active incidents=448
+  -> auto disposition rate=34%
+  -> runs/list total=6910
+  -> ai-route-status 200, dashboard snapshot 200
+  -> consoleErrors=0, pageErrors=0
+  -> screenshot /tmp/awoooi-t100-home-production.png
+```
+
+**修正**：
+
+- `IncidentCard` 新增 `FLOW_STAGE_ORDER` 與 `nextFlowStage()`。
+- 每張 IncidentCard 在 FlowPipeline 下方新增固定 summary：
+  - `目前階段: <stage>`
+  - `下一步: <stage>`
+- 新增 zh-TW / en i18n：
+  - `flowCurrentLabel`
+  - `flowNextLabel`
+  - `flowComplete`
+  - `flowStages.*`
+  - `aiProposalPreview`
+- 順手清理同檔既有 UI 技術債：授權 / 拒絕按鈕移除符號拼字串，AI 提案 preview 改為 i18n template，避免把符號當 UI icon / literal string。
+
+**邊界**：
+
+- 本輪只修首頁 IncidentCard 的顯示語意，不改 incident 狀態、不改 pipeline stage 推導、不改自動修復 / approval 流程。
+- 後續仍需把每張卡的「目前階段」與真正 truth-chain / timeline stage 做更深的逐事件對齊；T100 先解決「截圖上無法判斷卡在哪一步」的產品可讀性問題。
+
+**Local verification**：
+
+```text
+pnpm --dir apps/web exec next lint --file 'src/components/incident/incident-card.tsx'
+  -> No ESLint warnings or errors
+pnpm --dir apps/web exec tsc --noEmit --pretty false
+  -> ok
+node -e 'JSON.parse(...)'
+  -> i18n json ok
+NEXT_PUBLIC_API_URL=https://awoooi.wooo.work pnpm --dir apps/web run build
+  -> compiled and generated 90/90 static pages
+Local Playwright with mocked read-only API:
+  -> incident-flow-summary visible
+  -> text: 目前階段: AI 偵測 / 下一步: AI 分析
+  -> pageErrors=0
+  -> screenshot /tmp/awoooi-t100-home-flow-summary-local.png
+git diff --check
+  -> pass
+```
+
+**Production deploy / smoke**：
+
+```text
+Code commit:
+  0c1f1264 fix(web): clarify incident flow stage on dashboard
+
+Deploy marker:
+  20026d46 chore(cd): deploy 0c1f126 [skip ci]
+
+Gitea Actions:
+  1907 Code Review -> success in 11s
+  1906 CD tests -> success in 3m57s
+  1906 CD build-and-deploy -> success in 3m42s
+  1906 CD post-deploy-checks -> success in 1m49s
+
+GET https://awoooi.wooo.work/api/v1/health
+  -> healthy, prod, mock_mode=false
+
+Production Playwright:
+  -> first 5 incident-flow-summary nodes visible
+  -> examples:
+     目前階段: 告警收到 / 下一步: AI 偵測
+     目前階段: AI 偵測 / 下一步: AI 分析
+  -> bodyIncludesCurrent=true
+  -> bodyIncludesNext=true
+  -> consoleErrors=0, pageErrors=0
+  -> screenshot /tmp/awoooi-t100-home-flow-summary-production.png
+```
+
+**目前進度更新**：
+
+- AwoooP 告警可觀測鏈：約 99.3%
+- 低風險自動修復閉環：約 95%
+- 前端 AI 自動化管理介面同步：約 99.25%
+- 治理告警可讀性 / 可處置性：約 99.35%
+- AI Agent ownership 可追溯性：約 98.4%
+- KM healthcheck 派工可追蹤性：約 99.8%
+- Hermes KB growth 草稿 / owner review 閉環：約 99.7%
+- 完整 AI 自動化管理產品化：約 98.0%
+
 ## 2026-05-20｜T99 Governance event 精準回看錨點 + stale response race fix

 **觸發**：
--- a/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md
+++ b/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md
@@ -2377,6 +2377,14 @@ Phase 6 完成後
 - Production：`739a8e0f feat(governance): link work items to event history` 已推 Gitea main；deploy marker `55e642ee chore(cd): deploy 739a8e0 [skip ci]`；T99b `93070600 fix(governance): keep event history filter responses ordered` 已推 Gitea main；deploy marker `a0e56bba chore(cd): deploy 9307060 [skip ci]`。Production health healthy/prod/mock_mode=false。`GET /ai/governance/events?event_id=c459f507-bec5-4930-815c-cf8bd66b413e&size=20` 回 total=1 且 ids 只含該 event。Production Playwright 直連 `/zh-TW/governance?tab=events&event_id=...` 只送一個帶 event_id 的 request，response total=1，表格 footer 顯示 `每頁 20 筆 · 1`，consoleErrors=0 / pageErrors=0，截圖 `/tmp/awoooi-t99-governance-event-history-production-debug2.png`。
 - 目前進度更新：AwoooP 告警可觀測鏈約 99.25%；低風險自動修復閉環約 95%；前端 AI 自動化管理介面同步約 99.1%；治理告警可讀性 / 可處置性約 99.3%；AI Agent ownership 可追溯性約 98.4%；KM healthcheck 派工可追蹤性約 99.8%；Hermes KB growth 草稿 / owner review 閉環約 99.7%；完整 AI 自動化管理產品化約 97.9%。

+**T100 首頁 Incident flow 階段語意修正（2026-05-20 台北）**：
+- 觸發：首頁資料與 Work Items API 經 production browser network 驗證皆為 200，但 IncidentCard pipeline 只靠節點顏色表示 active stage；截圖/純文字會看成「告警 / AI 偵測 / AI 分析 / 提案生成 / 等待授權 / 執行 / 完成」全列完，Operator 難以判斷是否真的跑到哪一階段。
+- 修正：`IncidentCard` 新增 `FLOW_STAGE_ORDER` / `nextFlowStage()`，在 FlowPipeline 下方固定顯示 `目前階段` 與 `下一步`。補 zh-TW / en i18n `flowCurrentLabel`、`flowNextLabel`、`flowComplete`、`flowStages.*`、`aiProposalPreview`。順手移除授權/拒絕按鈕的符號拼字串，AI 提案 preview 改用 i18n template。
+- 邊界：T100 只修首頁 IncidentCard 顯示語意，不改 incident 狀態、不改 stage 推導、不改自動修復 / approval 流程。後續可再把每張卡的 stage 與 truth-chain / timeline events 做逐事件對齊。
+- Local verification：IncidentCard Next lint 無 warnings；`tsc --noEmit` ok；i18n JSON parse ok；production build 成功產出 90/90 static pages；local Playwright mocked read-only API 顯示 `目前階段: AI 偵測 / 下一步: AI 分析`，pageErrors=0，截圖 `/tmp/awoooi-t100-home-flow-summary-local.png`。
+- Production：`0c1f1264 fix(web): clarify incident flow stage on dashboard` 已推 Gitea main；deploy marker `20026d46 chore(cd): deploy 0c1f126 [skip ci]`；Gitea Code Review success、CD tests success、build-and-deploy success、post-deploy-checks success。Production health healthy/prod/mock_mode=false。Production Playwright 首頁 smoke 前 5 張 card 均顯示 `incident-flow-summary`，包含 `目前階段: 告警收到 / 下一步: AI 偵測` 與 `目前階段: AI 偵測 / 下一步: AI 分析`，consoleErrors=0 / pageErrors=0，截圖 `/tmp/awoooi-t100-home-flow-summary-production.png`。
+- 目前進度更新：AwoooP 告警可觀測鏈約 99.3%；低風險自動修復閉環約 95%；前端 AI 自動化管理介面同步約 99.25%；治理告警可讀性 / 可處置性約 99.35%；AI Agent ownership 可追溯性約 98.4%；KM healthcheck 派工可追蹤性約 99.8%；Hermes KB growth 草稿 / owner review 閉環約 99.7%；完整 AI 自動化管理產品化約 98.0%。
+
 ---

 ### 2026-04-20 晚 (台北) — C1-C4 全流程串接 — Playbook 鏈路保護（commit de2d34d）