diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 06122bd5..baf712a3 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,43 @@ +## 2026-06-26|D1D Knowledge Base 首屏補強:KM / PlayBook / RAG 缺口可見化 + +**背景**:使用者指出 KM、PlayBook、腳本、排程、自動化機制與 Verifier 沉澱結果在頁面看不到,會讓 AI 自動化成果等於沒有做。正式 API 讀回確認知識庫並非無資料:`/api/v1/knowledge?project_id=awoooi&limit=50` 回 `total=667`;真正問題是首屏沒有把「哪些資產有沉澱、哪些仍缺」說清楚,且 `/api/v1/knowledge/rag/stats` 顯示 RAG chunks / sources 仍為 `0 / 0`。 + +**完成內容**: +- `/zh-TW/knowledge-base` 的 `KM 自動化掌控台` 增加 `RAG 索引` 決策卡,直接顯示語意檢索索引是否沉澱。 +- `自動化資產沉澱總帳` 新增 `RAG / 向量索引` 一格,和 KM、PlayBook、腳本 / Ansible、排程 / 監控規則、Verifier 回寫並列。 +- 保留既有 KM 條目、owner review、stale ratio、品質軌道、引用鏈、陳舊處理佇列與 Work Items 接續狀態。 +- 不觸發 RAG indexing、不寫 KM、不 approve / archive、不提高 PlayBook trust、不送 Telegram、不開 runtime gate。 + +**Commit / deploy**: +- Code commit:`4309c02eb fix(web): surface knowledge RAG asset gap`。 +- Deploy marker:`ae6e68ac5 chore(cd): deploy 4309c02 [skip ci]`。 + +**正式 API 讀回**: +- `/api/v1/knowledge?project_id=awoooi&limit=50`:`total=667`,前 50 筆正常回傳。 +- `/api/v1/ai/governance/km-stale-candidates?project_id=awoooi&limit=5`:`total_stale=645`、`manual_review_required=true`、`writes_on_read=false`。 +- `/api/v1/ai/governance/km-stale-owner-reviews?project_id=awoooi&dispatch_status=pending&limit=5`:`total=10`。 +- `/api/v1/ai/governance/km-stale-owner-review-burndown?project_id=awoooi&limit=5`:`stale_ratio=0.967`、`threshold=0.2`、`entries_to_threshold=512`。 +- `/api/v1/knowledge/rag/stats`:`total_chunks=0`、`sources=0`。 + +**正式站驗證**: +- Desktop:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ae6e68ac-kb-rag-gap-desktop`,`667`、`645`、`Owner Review 10`、`RAG 索引 0`、`RAG / 向量索引`、`自動化資產沉澱總帳` 可見;`horizontalOverflow=false`、`tablists=0`、`appError=false`。 +- Mobile 首次 smoke 曾遇到主 KM 條目 API `502`,治理軌道仍顯示但列表數字暫為 0;重測 `https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ae6e68ac-kb-mobile-retest-2` 後正常顯示 `667`、`645`、`Owner Review 10`、`RAG 索引 0`,無 502,`horizontalOverflow=false`。 +- 截圖:`/tmp/awoooi-kb-rag-gap-desktop-ae6e68ac.png`、`/tmp/awoooi-kb-mobile-retest-ae6e68ac.png`。 + +**完成度**: +- IA-D1D Knowledge Base 自動化資產缺口前移:正式站 `100%`。 +- Knowledge / PlayBook 沉澱可視化:`20% -> 28%`。 +- 全站 UI / UX 專業化:維持 `42%`。 +- 真正 AI 自動化 runtime 閉環:仍 `15-25%`。 + +**後續缺口**: +- RAG index 仍 `0 / 0`,必須另開安全排程 / 索引任務,而不是在讀取頁面時寫入。 +- 需要把 PlayBook trust、腳本 / Ansible、排程 / 監控規則、Verifier 實體 ID、owner 與下一步下鑽補齊到 Work Items / Runs / Knowledge Base。 +- Mobile 首次 502 顯示資料鏈仍有瞬時不穩,應在後續補 retry / stale cache / partial hydration resilience。 + +**邊界**: +- 本段沒有寫入 KM、沒有索引 RAG、沒有 approve / archive、沒有修改 PlayBook trust、沒有發 Telegram、沒有 runtime execution。 + ## 2026-06-26|D1C Observability runtime gate 真相修復:只讀 API 不再誤算為自動執行授權 **背景**:正式站 `/zh-TW/observability` 已把主機、專案、網站前後台、服務、套件、工具、監控訊號與 AI Agent 決策鏈集中成總覽、矩陣、拓樸、流程、訊號合約、健康缺口與下鑽入口;但頁面首屏把 `read_only_api_allowed=true` 誤算進 runtime gate,造成 `執行閘門 2` / `自動執行授權 2` 的假性訊號。這會讓使用者以為 AI runtime 已可自動執行,與正式 API 邊界不符。 diff --git a/docs/workplans/2026-06-26-awoooi-ia-ux-reset-and-consolidation.md b/docs/workplans/2026-06-26-awoooi-ia-ux-reset-and-consolidation.md index 57957638..a4186564 100644 --- a/docs/workplans/2026-06-26-awoooi-ia-ux-reset-and-consolidation.md +++ b/docs/workplans/2026-06-26-awoooi-ia-ux-reset-and-consolidation.md @@ -1,8 +1,8 @@ # AWOOOI IA / UIUX 重整盤點與整合推進清單 日期:2026-06-26(台北時間) -基線:`gitea/main=54b50a337 chore(cd): deploy 83d7d86 [skip ci]` -狀態:D0 盤點完成;D1 全域導航 shell 已完成第一段正式部署,手機版改為抽屜式導航;D1B Tenants 資產 cockpit 已正式部署,將所有網站 / 專案 / 產品的判讀矩陣前移並收合長明細;D1C Observability 已修正 runtime gate 真相計數,正式站顯示 `執行閘門 0` / `自動執行授權 0`;後續仍需逐頁整併舊 route / tabs / 大量文字頁。 +基線:`gitea/main=ae6e68ac5 chore(cd): deploy 4309c02 [skip ci]` +狀態:D0 盤點完成;D1 全域導航 shell 已完成第一段正式部署,手機版改為抽屜式導航;D1B Tenants 資產 cockpit 已正式部署,將所有網站 / 專案 / 產品的判讀矩陣前移並收合長明細;D1C Observability 已修正 runtime gate 真相計數,正式站顯示 `執行閘門 0` / `自動執行授權 0`;D1D Knowledge Base 已把 KM / PlayBook / 腳本 / 排程 / Verifier / RAG 資產缺口前移到首屏;後續仍需逐頁整併舊 route / tabs / 大量文字頁。 ## 0. 這次先校正方向 @@ -84,7 +84,7 @@ | AwoooP 操作台產品化 | `68%` | `55%` | Work Items / Runs / Approvals 資料有,但還不像完整自動化控制台。 | | Tenants 全產品資產中心 | `68%` | `72%` | 已把 16 產品 / 專案、31 網站 / 服務入口、10 來源範圍與 57 可視資產前移成決策支援矩陣;明細預設收合。 | | Observability 專業拓樸 / 告警中心 | `38%` | `32%` | 已把主機、專案、網站、服務、套件、工具、訊號拓樸、告警流程與下鑽入口集中到 `/observability`,並修正 read-only API 誤算 runtime gate 的問題;仍需補真正告警漏斗、噪音治理與 AI 修復閉環。 | -| Knowledge / PlayBook 沉澱可視化 | `34%` | `20%` | 使用者看不到 KM、PlayBook、腳本、排程、Verifier 的完整沉澱。 | +| Knowledge / PlayBook 沉澱可視化 | `34%` | `28%` | `/knowledge-base` 已顯示 667 筆 KM、645 stale、Owner Review 10、RAG 索引 0,並把 KM / PlayBook / 腳本 / 排程 / Verifier / RAG 納入首屏資產總帳;仍需補 PlayBook trust、腳本、排程、Verifier 實體 ID 與可追蹤下鑽。 | | Code Review / Release Safety Gate | `58%` | `35%` | 還沒把所有產品 pre / post deploy gate 與惡意程式碼防護做成產品化流程。 | | 真正 AI 自動化 runtime 閉環 | `60-64%` | `15-25%` | 目前大量告警仍停在 owner review / manual required,不可再用治理卡假性拉高。 | @@ -179,6 +179,7 @@ | IA-D0-002 | Canonical route map | `AwoooProductShell` / sidebar / command palette 共用資料來源設計 | 完成草案 | | IA-D0-003 | PageTabs 去留清單 | 第 3 節轉成實作 issue / checklist | 完成 | | IA-D1C-001 | Observability runtime gate 真相修復 | read-only API 不再被算成自動執行授權;正式站 `執行閘門 0` / `自動執行授權 0` | 完成 | +| IA-D1D-001 | Knowledge Base 自動化資產缺口前移 | 首屏顯示 KM、PlayBook、腳本、排程、Verifier、RAG;正式站顯示 KM 667、stale 645、Owner Review 10、RAG 0 | 完成 | | IA-D0-004 | 優先頁視覺骨架 | Situation / Flow / Matrix / Topology / Evidence / Action component spec | 進行中:Tenants 已套用 Matrix / Drilldown | | IA-D1-001 | 導航實作 | Sidebar、手機抽屜、breadcrumb、context links、legacy route redirect plan | 部分完成:Sidebar / 手機抽屜正式站 100%;breadcrumb / redirect 待做 | | IA-D1-002 | Tenants 全產品資產 cockpit | 全域資產判讀矩陣、收合明細、正式站 desktop / mobile smoke | 完成 |