docs: record knowledge governance flow rollout [skip ci]
This commit is contained in:
@@ -1,3 +1,44 @@
|
||||
## 2026-06-03|Knowledge 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-deploy:Alert 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-03|Knowledge Base Work Items 接續狀態串接
|
||||
|
||||
**背景**:統帥追問「KM 需要更新」這類治理告警後續到底由誰處理、陳舊數據怎麼處理,以及前端是否要同步呈現已完成與正在推進的工作。上一輪已把 KM 來源、Incident、Playbook、審核缺口視覺化;本輪接續把 Knowledge Base 的陳舊治理缺口接到 AwoooP Work Items,讓操作者能直接看到 owner-review queue 的真實狀態與可處理入口。
|
||||
|
||||
Reference in New Issue
Block a user