diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index d6b33152..28a37f62 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,42 @@ +## 2026-06-03|Knowledge Base 引用鏈圖與陳舊處理佇列落地 + +**背景**:統帥持續要求前端從文字牆改成圖、表、流程、拓樸與可快速理解的產品介面。本輪接續 Knowledge Base 品質軌道,新增「引用鏈圖」與「陳舊處理佇列」,讓操作者一眼看出 KM 來源、Incident / Playbook 覆蓋、審核缺口與下一步處理方向。 + +**本次調整**: +- `/zh-TW/knowledge-base` 摘要區新增 `引用鏈圖`,用 5 個節點呈現 `來源 → KM → Incident → Playbook → 審核` 覆蓋率。 +- 新增 `陳舊處理佇列`,用目前列表的真欄位計算 `7 天未更新`、`缺 Incident`、`缺 Playbook`、`待 Owner 審核`。 +- 右側 KM 詳情新增 `單筆證據鏈`,逐筆顯示來源、Incident、Playbook、審核狀態,避免使用者只能讀長文猜目前卡在哪個治理節點。 +- mobile layout 改為 `min-height`,desktop 才鎖定視窗高度,避免 Knowledge Base 內容增加後手機不能上下滾動。 +- 所有數字只來自既有 API 欄位:`source`、`status`、`updated_at`、`related_incident_id`、`related_playbook_id`、`tags`;沒有新增假資料,也沒有宣稱新增自動修復能力。 + +**本機驗證**: +- `cmp -s apps/web/messages/zh-TW.json apps/web/messages/en.json` 通過。 +- `git diff --check` 通過。 +- `pnpm --dir apps/web exec tsc --noEmit --tsBuildInfoFile /tmp/kb-lineage-20260603.tsbuildinfo` 通過。 +- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過;KB route size `54.6 kB`。 +- 本機 Browser:桌機與 390px 手機皆顯示 `引用鏈圖`、`陳舊處理佇列`、`資料品質軌道`,`horizontalOverflow=0`、`canScrollVertical=true`。 +- 本機因 production API CORS 對 `127.0.0.1` origin 失敗,KB 以空資料狀態驗證排版;真資料改由 production 驗證收斂。 + +**正式部署**: +- Code commit:`a1cc3828 fix(web): add knowledge lineage map`。 +- Gitea code-review run:`3600` / run number `2494` / success。 +- Gitea CD run:`3599` / run number `2493` / tests `5070` success、build-and-deploy `5071` success、post-deploy-checks `5072` success。 +- Deploy marker:`cc3b25d9 chore(cd): deploy a1cc382 [skip ci]`。 + +**正式驗證**: +- Health:`https://awoooi.wooo.work/api/v1/health` → `status=healthy`、`environment=prod`、`mock_mode=false`、`version=1.0.0`,9 個 components up;Ollama provider health 顯示 `ollama_gcp_a`、`ollama_gcp_b`、`ollama_local` 均 reachable。 +- K8s:`awoooi-api 2/2`、`awoooi-web 2/2`、`awoooi-worker 1/1`,image 均為 `a1cc38288bbb68c664dab538a9b0159ff98211ff`。 +- CD post-deploy:Alert Chain smoke `9/9`、監控覆蓋率 `100.0%`、SourceLink canary `verification_status=applied_link_verified`、`applied_link_total=91`、Playwright smoke `5 passed`。 +- Production KB API:`/api/v1/knowledge?limit=50` 回 `total=2501`、`loaded=50`、`incident_linked=50`、`playbook_linked=6`、`signal_rich=50`。 +- Production 桌機:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=a1cc3828-kb-lineage-prod` 顯示引用鏈圖、陳舊佇列、`50 / 50` Incident 覆蓋、`6 / 50` Playbook 缺口、單筆證據鏈;`horizontalOverflow=0`、`canScrollVertical=true`。 +- Production 手機 390px:引用鏈圖、陳舊佇列與品質軌道皆存在,`horizontalOverflow=0`、`canScrollVertical=true`。 + +**進度更新**: +- Knowledge Base 產品化可讀性由 `60%` 上修至 `66%`。 +- 前端設計系統 / i18n / 素材治理由 `53%` 上修至 `54%`。 +- CI/CD SourceLink / API rollout 健康維持 `100%`。 +- 首頁產品化入口維持 `80%`;AwoooP/HITL 維持 `99.2%`;完整 AI 自動化飛輪仍約 `66%`,因本輪完成的是 KM 證據呈現與治理缺口視覺化,不是新的 AI 自動執行或自動修復能力。 + ## 2026-06-03|Knowledge Base 資料品質軌道與 CD SourceLink 紅燈修復 **背景**:統帥要求前端不要再以大量文字呈現 KM / 告警 / 自動化狀態,而要讓使用者用圖表快速理解資料品質與流程證據。本輪接續 Knowledge Base 可讀性治理,新增「資料品質軌道」;推版後 Gitea CD post-deploy 也暴露 `AwoooP Source Correlation Applied-Link Smoke` 對舊 incident status-chain 讀取 timeout,必須一併收斂。