docs: record knowledge lineage rollout [skip ci]

This commit is contained in:
Your Name
2026-06-03 08:42:52 +08:00
parent cc3b25d933
commit ae645b5bc2

View File

@@ -1,3 +1,42 @@
## 2026-06-03Knowledge 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 upOllama 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-deployAlert 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-03Knowledge Base 資料品質軌道與 CD SourceLink 紅燈修復
**背景**:統帥要求前端不要再以大量文字呈現 KM / 告警 / 自動化狀態,而要讓使用者用圖表快速理解資料品質與流程證據。本輪接續 Knowledge Base 可讀性治理,新增「資料品質軌道」;推版後 Gitea CD post-deploy 也暴露 `AwoooP Source Correlation Applied-Link Smoke` 對舊 incident status-chain 讀取 timeout必須一併收斂。