docs: record knowledge governance flow rollout [skip ci]

This commit is contained in:
Your Name
2026-06-03 09:29:08 +08:00
parent ae6a335ec4
commit eaad1a34a6

View File

@@ -1,3 +1,44 @@
## 2026-06-03Knowledge Base 治理流程圖上線
**背景**:上一輪已讓 Knowledge Base 看到 KM 陳舊治理是否接到 AwoooP Work Items統帥要求頁面不要再只堆文字必須用圖、表、流程讓使用者快速理解「跑到哪個階段、誰主責、是否已自動處理或仍需人工」。本輪把 `KM 需要更新` 的接續處理做成 `偵測 → Owner Review → 乾跑預覽 → Owner 確認 → 寫回 KM → 比例回測` 的流程圖。
**本次調整**
- `/zh-TW/knowledge-base``Work Items 接續狀態` 補上 `治理流程圖`,用 6 個節點呈現目前階段。
- 流程節點直接吃 live governance API`stale_count``stale_ratio``pending_owner_reviews``ready_count``blocked_count``completion_audit_total``stale_ratio_recheck_total``entries_to_threshold`
- 顯示 `讀取不寫入`,並保留 Work Items 深連結KB 頁只做可視化,不新增寫入按鈕。
- 明確保留治理邊界:真正 KM writeback 必須在 AwoooP Work Items 內完成單筆 dry-run preview + owner confirm不在 KB 頁繞過審核。
- `apps/web/messages/zh-TW.json` / `en.json` 補齊 i18n保持鏡像一致。
**本機驗證**
- `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-governance-flow-20260603.tsbuildinfo` 通過。
- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過KB route size `57.2 kB`
- 本機 production server桌機顯示 `治理流程圖`、6 個流程節點與 `讀取不寫入``horizontalOverflow=0``canScrollVertical=true`
- 本機 390px流程節點全存在`horizontalOverflow=0``canScrollVertical=true`
**正式部署**
- Code commit`dc6039c6 fix(web): show knowledge governance flow`
- Gitea code-review run`3604` / run number `2498` / success。
- Gitea CD run`3603` / run number `2497` / tests `5078` success、build-and-deploy `5079` success、post-deploy-checks `5080` success。
- Deploy marker`ae6a335e chore(cd): deploy dc6039c [skip ci]`
- K8s`awoooi-api``awoooi-web``awoooi-worker` image 均為 `dc6039c6eac7efcd9fe6cad3d63e44de45e5d14a`
**正式驗證**
- CD post-deployAlert Chain smoke `9/9`、監控覆蓋率 `100.0%`、SourceLink canary recorded、Playwright smoke `5 passed`
- Live API`/api/v1/ai/governance/km-stale-owner-review-burndown?project_id=awoooi``stale_count=2272``total_count=2500``stale_ratio=0.909``threshold=0.2``entries_to_threshold=1772``pending_owner_reviews=10``completed_owner_reviews=1``completion_audit_total=1``stale_ratio_recheck_total=1``writes_on_read=false`
- Live API`/api/v1/ai/governance/km-stale-owner-review-completion-queue?project_id=awoooi&status_bucket=all``pending_count=10``ready_count=10``blocked_count=0``completed_count=1``failed_count=0``writes_on_read=false``batch_writes_allowed=false`
- Production 桌機:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=dc6039c-kb-governance-flow-prod` 顯示流程節點、`2,272``90.9%``10 筆等待 owner 審核``10 筆可乾跑0 筆卡住``1 筆已有 completion audit``1 筆已回測;距離門檻仍差 1,772 筆`Work Items 深連結仍帶 `work_item_id=c0a62d49-448b-4223-ae80-1abb6e361260``horizontalOverflow=0``canScrollVertical=true`
- Production 手機 390px同樣顯示 6 個流程節點、live ratio、dry-run ready、read-only`horizontalOverflow=0``canScrollVertical=true`
**進度更新**
- Knowledge Base 產品化可讀性由 `70%` 上修至 `74%`
- 前端設計系統 / i18n / 素材治理由 `56%` 上修至 `57%`
- KM owner-review / completion 可治理鏈由 `84%` 上修至 `86%`
- CI/CD SourceLink / API rollout 健康維持 `100%`
- 首頁產品化入口維持 `80%`AwoooP/HITL 維持 `99.2%`
- 完整 AI 自動化飛輪維持 `67%`:本輪把 `preview → confirm → writeback → recheck` 的狀態在前端產品化呈現,但沒有新增新的自動寫入或自動修復能力;下一步應在 Work Items 裡把單筆 owner review 的 preview / confirm 互動做成更清楚的操作面板,實際消化 `10` 筆 ready item。
## 2026-06-03Knowledge Base Work Items 接續狀態串接
**背景**統帥追問「KM 需要更新」這類治理告警後續到底由誰處理、陳舊數據怎麼處理,以及前端是否要同步呈現已完成與正在推進的工作。上一輪已把 KM 來源、Incident、Playbook、審核缺口視覺化本輪接續把 Knowledge Base 的陳舊治理缺口接到 AwoooP Work Items讓操作者能直接看到 owner-review queue 的真實狀態與可處理入口。