From 4018a05983851be19ab7dbd970df5d5942a72eba Mon Sep 17 00:00:00 2001 From: Your Name Date: Wed, 3 Jun 2026 01:12:02 +0800 Subject: [PATCH] docs: record knowledge base overview rollout [skip ci] --- docs/LOGBOOK.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 6d36f218d..6667b6b07 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,40 @@ +## 2026-06-03｜Knowledge Base 視覺摘要與真分類治理落地 + +**背景**：統帥要求前端不能只堆大量文字，必須用圖、表、專業資訊架構讓使用者快速理解產品狀態。本輪接續前端 UI/UX 與素材治理，先處理 production 上的 `/zh-TW/knowledge-base`：讓知識庫首頁不是單純列表，而是用真 API 資料呈現摘要、分類分佈與資料品質線索。 + +**本次調整**： +- `Knowledge Base` 搜尋列下方新增摘要面板：`總條目`、`目前列表`、`AI 萃取`、`已批准`，全部由 `/api/v1/knowledge` 回傳與目前載入列表推導，不補假資料。 +- 新增 `分類分佈` rail：第一版先接上視覺化；production 驗證時發現 API 真分類共有 17 類，不只原本固定四類，因此第二版改為 API 真分類排序 Top 8 + `其他分類`，避免面板誤導。 +- 清理 production 可見 i18n 技術債：列表中的 `knowledgeBase.category.postmortem/general` key 洩漏已修正為 `事後分析`、`通用` 等可讀分類；同時補 `AI治理`、`alert_handling`、`host_resource`、`incident_postmortem` 等現場分類翻譯與 fallback。 +- 修正 KB 頁響應式結構：左側分類、主列表、詳情 panel 在窄版改為縱向堆疊，toolbar 可換行，桌機與手機皆不得水平溢出。 + +**本機驗證**： +- `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-visual-overview-20260603-r2.tsbuildinfo` 通過；第二版 `--tsBuildInfoFile /tmp/kb-category-i18n-20260603.tsbuildinfo` 通過。 +- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過；第二版 KB route size `52.5 kB`。 +- 本機 production server：`http://127.0.0.1:3046/zh-TW/knowledge-base` Browser 驗證 overview labels 存在、`horizontalOverflow=0`；390px Playwright 驗證 `horizontalOverflow=0`、`canScrollVertical=true`、`hasLeakedCategoryKeys=false`。 + +**正式部署**： +- 第一版 code commit：`894a4b2f fix(web): add knowledge base overview rails`。 +- 第一版 Gitea code-review run：`3590` / run number `2484` / success。 +- 第一版 Gitea CD run：`3589` / run number `2483` / tests success、build-and-deploy success、post-deploy-checks success。 +- 第一版 deploy marker：`2c706cfc chore(cd): deploy 894a4b2 [skip ci]`。 +- 第二版 code commit：`a748a082 fix(web): prevent knowledge category key leaks`。 +- 第二版 Gitea code-review run：`3592` / run number `2486` / success。 +- 第二版 Gitea CD run：`3591` / run number `2485` / tests success、build-and-deploy success、post-deploy-checks success。 +- 第二版 deploy marker：`c4a63157 chore(cd): deploy a748a08 [skip ci]`。 + +**正式驗證**： +- Health：`https://awoooi.wooo.work/api/v1/health` → `status=healthy`、`environment=prod`、`mock_mode=false`、`version=1.0.0`。 +- Production 桌機：`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=a748a08-kb-category-prod` 顯示真資料 `總條目=2,494`、`目前列表=50`、`AI 萃取=50`；分類分佈顯示 `AI 治理 41%`、`基礎設施 22%`、`AI 系統 10%`、`通用 9%`、`告警處理 9%`、`其他分類 3%`；`hasLeakedCategoryKeys=false`、`horizontalOverflow=0`。 +- Production 手機 390px：overview labels 存在、真分類翻譯存在、`其他分類` 存在、`hasLeakedCategoryKeys=false`、`horizontalOverflow=0`、`canScrollVertical=true`。 + +**進度更新**： +- 前端設計系統 / i18n / 素材治理由 `49%` 上修至 `51%`。 +- Knowledge Base 產品化可讀性由 `35%` 上修至 `50%`：已完成摘要、分類分佈、真分類翻譯、基本響應式；仍缺少引用鏈圖、KM freshness 分層、Incident / Sentry / SigNoz / PlayBook 來源圖。 +- 首頁產品化入口維持 `80%`；AwoooP/HITL 維持 `99.2%`；完整 AI 自動化飛輪仍維持約 `66%`，本輪是前端可視化與資料呈現治理，沒有新增自動修復能力。 + ## 2026-06-03｜前端 UI/UX 與素材治理同步盤點啟動 **背景**：統帥追問前端是否也需要同步盤點 UI/UX 與素材。結論：需要，而且必須和 AI 自動化飛輪、AwoooP 操作台、告警流程呈現一起治理；目前問題不只是文案，而是過多文字牆、流程/拓樸/圖表不足、正式 UI 仍混用 emoji 作為產品圖示、可復用素材庫薄弱，導致使用者難以快速判斷「現在跑到哪個階段、誰主責、是否自動修復、何時要人工介入」。