feat(web): refine operator navigation IA
All checks were successful
CD Pipeline / tests (push) Successful in 1m26s
Code Review / ai-code-review (push) Successful in 13s
CD Pipeline / build-and-deploy (push) Successful in 4m10s
CD Pipeline / post-deploy-checks (push) Successful in 1m59s

This commit is contained in:
Your Name
2026-06-04 14:49:42 +08:00
parent 02cadee63e
commit 973fc7a455
7 changed files with 493 additions and 75 deletions

View File

@@ -28802,3 +28802,48 @@ production browser smoke:
- Frontend design system / i18n約 46%;盤點完成,但 primitives 與 AwoooP i18n 大掃除尚未實作。
- 完整自動修復 production claim約 3.5%;本輪是 UX/可視化進展,未提高 verified auto-repair execution success。
- 完整 AI Agent 自動化飛輪:約 66%;可視化與產品入口改善,但真正自動執行、驗證、學習閉環仍需下一波 API + executor + governance 工作。
## 2026-06-04 — 導航 IA 第一波與 AI 飛輪工作推進清單
**背景**
- 使用者批准繼續,要求優化目前導航列排列順序,解決「導航列菜單裡又有多個分頁」造成的使用體驗問題。
- 同時要求把新 session handoff 收斂成可執行 MD定義 P0/P1/P2 優先順序、細化工作項,且每階段完成後同步完成度與狀態。
**本輪完成**
- 新增 `docs/workplans/2026-06-04-navigation-and-ai-flywheel-workplan.md`
- 整合目前基線、Gitea push 規則、P0/P1/P2 phase、細項、驗收標準與完成度回報規則。
- Phase 0 導航 IA 本地驗證完成,完成度先推進到 `92%`,保留 Gitea / production 證據待推版後補齊。
- 全域 Sidebar 改成 operator-first IA
- 第一區改為處理佇列指令中心、AwoooP 總覽、工作鏈路、Run 監控、審批佇列、告警。
- 第二區改為真相與治理可觀測性、自動化、AI 治理、知識殿堂、IwoooS。
- 第三區改為營運:營運總覽、拓撲圖、部署管理、工單、成本分析。
- 系統與相容區保留終端、設定、經典 AI 中心;說明移到底部工具位。
- AwoooP shell 改為 i18n移除硬編 UI 文案。
- AwoooP 二級導航改成工作流順序總覽、工作鏈路、Run 監控、審批佇列、合約、租戶。
- Command Palette 補 AwoooP 總覽、工作鏈路、Run 監控、審批佇列,避免快捷導航與 Sidebar 分叉。
**參考設計原則**
- Material Design5 個以上 top-level destinations / 兩層以上 hierarchy 適合用 navigation drawer。
- Atlassian 新導航sidebar 承載高密度工作流top bar 留給 search / create 等 universal actions。
- IBM Carbon UI shellheader 是最高層left panel 承載產品導航,右側留給全域 utilities。
**驗證**
- `node -e "JSON.parse(...zh-TW.json); JSON.parse(...en.json); console.log('json ok')"``json ok`
- `pnpm --filter @awoooi/web typecheck` → success
- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` → success92 static pages generated。
- Local production server`http://127.0.0.1:3115`
- Desktop 1440Sidebar 順序為 `指令中心 / AwoooP 總覽 / 工作鏈路 / Run 監控 / 審批佇列 / 告警`section labels 顯示 `處理佇列 / 真相與治理 / 運維管理 / 系統與相容`
- Desktop AwoooP subnav`總覽 / 工作鏈路 / Run 監控 / 審批佇列 / 合約 / 租戶``總覽` 為 active。
- Desktop `horizontalOverflow=0`
- Mobile 390Sidebar collapsed titles 含 `指令中心 / AwoooP 總覽 / 工作鏈路 / Run 監控 / 審批佇列 / 告警`AwoooP subnav 可橫向滾動。
- Mobile `horizontalOverflow=0`
- `git diff --check` → pass。
**目前狀態**
- Phase 0 導航 IA`92%`;本地完整驗證完成,待 commit / Gitea main / production smoke 後補到 `100%`
- 首頁產品化入口:維持 `88%`
- AI provider readability維持 `88%`
- Runs visibility`88% → 90%`,因 Run 監控已成為全域一級入口。
- Work Items readability`84% → 88%`,因工作鏈路已成為全域一級入口。
- Design system`54% → 58%`,因 Sidebar / AwoooP shell / Command Palette 導航語意與 i18n 開始收斂。
- 完整 AI 自動化飛輪:維持 `69%`,本輪是 IA 與工作推進清單,不宣稱自動執行閉環進步。

View File

@@ -0,0 +1,229 @@
# 2026-06-04 導航 IA 與 AI 自動化飛輪推進清單
> 本文件是本輪工作推進 handoff 與執行清單。AI 自動化飛輪的架構事實仍以 `docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md` 為唯一事實來源;本文件只負責排序、拆工、驗收與狀態追蹤。
## 目前基線
| 項目 | 狀態 |
| --- | --- |
| Repo/worktree | `/private/tmp/awoooi-iwooos-next-gate-20260604` |
| 推版規則 | 只推 Gitea`git push gitea HEAD:main`GitHub 只讀備份 |
| 最新完成 commit | `e5230c92 feat(web): compact homepage diagram atlas` |
| 最新 LOGBOOK commit | `30670c79 docs(logbook): record homepage diagram atlas rollout [skip ci]` |
| 正式站驗證 | `https://awoooi.wooo.work/zh-TW?_v=e5230c92-diagram-atlas-prod` |
| 首頁產品化入口 | 88% |
| AI provider readability | 88% |
| Runs visibility | 88% |
| Work Items readability | 84% |
| Design system | 54% |
| 完整 AI 自動化飛輪 | 69% |
## Session 啟動固定檢查
- [x] `git fetch gitea main`
- [x] `git status --short`
- [x] `git log --oneline -8`
- [x] 讀 MASTER §0 / §1 / §8、`docs/HARD_RULES.md``docs/LOGBOOK.md`
- [x] `project_current_status.md` 超過 2 天,需先做狀態同步
## 導航 IA 原則
| 原則 | 本輪落地 |
| --- | --- |
| 主入口按工作流排序,不按技術模組排序 | 先放指令中心、AwoooP、工作鏈路、Runs、審批、告警 |
| 左側導覽承載跨頁任務入口 | 把高頻 AwoooP 子頁與告警入口提到全域側欄 |
| 頁內 tabs 只表示同一頁的視角 | Observability / Automation / Operations 的 tabs 後續逐步拆成可掃描子入口 |
| Header 保留全域動作 | Search / command palette / profile / notification 維持在 header 或快捷指令 |
| Mobile 不藏真任務 | 側欄保持可滾動,長標籤需可換行或收合顯示 |
參考來源:
- Material Design navigation drawer5 個以上 top-level destinations 與兩層以上導航階層,適合用 drawer。
- Atlassian navigation redesign用 sidebar 提升跨專案工作效率top bar 留給 search / create 等 universal actions。
- IBM Carbon UI shellheader 是最高層導航left panel 承載產品導航,右側留給全域 utilities。
## 推進規則
1. 每個 phase 完成後更新本文件的完成度與狀態。
2. 每個可部署 phase 都更新 `docs/LOGBOOK.md`
3. 前端變更必跑 i18n JSON parse、TypeScript、build 與 Browser desktop/mobile smoke。
4. 涉及正式站聲明必用 production API / browser / Gitea run 證據,不引用舊報告。
5. 每個 phase 完成後推 `gitea main`,除非該 phase 明確標記為純本地盤點且不可部署。
## Phase 0 - 導航 IA 第一波
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P0 |
| 目標 | 先修目前最直觀的 UX 阻塞全域導航排序混亂、AwoooP 頁內入口難掃描、部分 UI 文字硬編。 |
| 狀態 | 本地驗證完成,待 Gitea 推版 |
| 完成度 | 92% |
細項:
- [x] 以「處理佇列 / 真相與治理 / 營運 / 系統」重排 Sidebar。
- [x]`AwoooP 總覽``工作鏈路``Run 監控``審批佇列``告警` 提升為全域可見入口。
- [x] AwoooP shell 改為 i18n移除硬編文案。
- [x] AwoooP 二級導航改為工作流順序:總覽 → 工作鏈路 → Run 監控 → 審批佇列 → 合約 → 租戶。
- [x] 保留 `classic` 相容入口,但移入系統區。
- [x] 驗證 desktop / mobile 無水平溢出,導航可見。
驗收:
- [x] `node -e "JSON.parse(...zh-TW.json); JSON.parse(...en.json)"`
- [x] `pnpm --filter @awoooi/web typecheck`
- [x] `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build`
- [x] Browser desktop 1440pxSidebar 顯示新順序AwoooP secondary nav 顯示新順序。
- [x] Browser mobile 390px`horizontalOverflow=0`
- [ ]`gitea main` 並記錄 run / production 證據。
## Phase 1 - P0 AI 自動化飛輪真相盤點
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P0 |
| 狀態 | 未開始 |
| 目標完成度 | 完整 AI 自動化飛輪 69% → 75% |
細項:
- [ ]`auto_execute_success_rate` SLO 違反原因,對照最近自動修復任務。
- [ ] 盤點流程是否真跑完alert ingest → classify → rule match → MCP evidence → PlayBook → approval gate → Ansible/repair → verifier → KM → postmortem。
- [ ] 補 timeline event每個 incident 必須看到 stage、handler、AI action、manual need。
- [ ] Telegram 告警補 stage、next action、blocked reason、auto/manual。
- [ ] 建立風險分級與 approval gate 對照表,釐清中低風險是否允許 AI 自動修復。
- [ ] 確認 MCP / 自建 MCP 實際 tool call、evidence、result 有被前端顯示。
驗收:
- [ ] DB / API / browser 都能查到同一 incident 的 stage timeline。
- [ ] Telegram 訊息可不開前端判斷目前流程狀態。
- [ ] 低風險自動修復權限與人工 gate 條件有可驗證表格。
## Phase 2 - P0 告警資料鏈路
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P0 |
| 狀態 | 未開始 |
| 目標完成度 | 告警資料鏈路可判讀性 → 90% |
細項:
- [ ] 所有 Telegram 告警完整寫入 DB不只送訊息。
- [ ] 告警關聯 Sentry、SigNoz、Alertmanager、K8s、host logs、run timeline。
- [ ] 建立告警 dedupe / fingerprint / recurrence 統計,降低重複轟炸。
- [ ] 修「詳情 / 歷史」HTTP 400 或查不到事件。
- [ ] 修 postmortem 瞬間大量重複通知。
- [ ] 修 Config Drift 重複告警,確認 PR 已建立後的採納 / 關閉 / baseline / TTL 狀態。
驗收:
- [ ] 同一 fingerprint 可看到 recurrence 次數、最新來源、處置狀態。
- [ ] 詳情 / 歷史連結不再 400。
- [ ] 重複通知有 DB 證據與 TTL 判讀。
## Phase 3 - P0 AI Provider / Agent 主責
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P0 |
| 狀態 | 未開始 |
| 目標完成度 | AI provider readability 88% → 95% |
細項:
- [ ] 強制確認 Ollama 使用順序GCP-A → GCP-B → 111 → Gemini fallback。
- [ ] 查為什麼會跑到 111 Ollama而不是先 GCP-A/GCP-B。
- [ ] Gemini 僅 fallback不禁用。
- [ ] Hermes 作 KM / E7 自動知識主責。
- [ ] OpenClaw 作告警分類、規則匹配、PlayBook 脈絡摘要,不直接批量改 KM。
- [ ] ElephantAlpha 作 read-only 稽核與高風險 review。
- [ ] 前端顯示每次 AI routeprovider、model、fallback 原因、token、latency、result。
驗收:
- [ ] `/api/v1/platform/ai-route-status` 與 run detail 顯示同一 route truth。
- [ ] 任何 fallback 都有原因與 latency。
- [ ] 前端不再只顯示概念性 provider 文案。
## Phase 4 - P0 KM 劣化治理
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P0 |
| 狀態 | 未開始 |
| 目標完成度 | KM / Governance workflow 58% → 80% |
細項:
- [ ] 處理 `knowledge_degradation`stale KM ratio 需低於 20%。
- [ ] 建立 `run_kb_growth_healthcheck` 真正排程與執行紀錄。
- [ ] Hermes 反查 Incident / Sentry / SigNoz / PlayBook產生 KM 更新草稿。
- [ ] 高影響 KM 必須 owner review 後寫入。
- [ ] Work Items / Knowledge Base 顯示 stale 條目、owner、來源、引用次數、下一步。
- [ ] Telegram 文案改成白話治理品質警報,避免誤判為服務故障。
驗收:
- [ ] stale 候選有 owner review queue。
- [ ] healthcheck 有 schedule / last run / result。
- [ ] KM 草稿與採納狀態可從前端查到。
## Phase 5 - P1 前端產品化
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P1 |
| 狀態 | 未開始 |
| 目標完成度 | 首頁產品化入口 88% → 95%Design system 54% → 70% |
細項:
- [ ] 首頁繼續從大量文字改成圖、表、流程、矩陣。
- [ ] 抽共用 visual componentsswimlane、matrix、diagram atlas、timeline、state machine、topology。
- [ ] AwoooP Runs 補完整事件時間線、AI route、MCP evidence、repair/verifier result。
- [ ] Work Items 補 owner review rail、KM task、blocking reason、next step。
- [ ] Approvals 補風險門、批准後實際是否執行、執行結果。
- [ ] Alerts 補 recurrence、fingerprint、Sentry/SigNoz/K8s 關聯。
- [ ] Monitoring / Cost / Tickets 接真實資料,移除空洞文案。
- [ ] 所有文案 i18n不硬編中文/英文。
- [ ] 禁用 emoji 當 UI icon改 lucide/icons。
- [ ] 確認首頁與各頁 mobile 可上下滾動、`horizontalOverflow=0`
## Phase 6 - P1 Ansible / PlayBook / Auto Repair
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P1 |
| 狀態 | 未開始 |
| 目標完成度 | Ansible / AutoRepair gate 可視化 52% → 80% |
細項:
- [ ] 盤點 Ansible 是否真正被 AI automation 使用,而不是只存在 repo。
- [ ] PlayBook 要有 trust score、成功 / 失敗回寫、版本、owner、適用條件。
- [ ] 自動修復不能只推薦重啟,要依 MCP evidence 與 PlayBook trust 決策。
- [ ] 自動修復完成後 verifier 驗證,失敗才升級人工。
- [ ] 每次修復都回寫 KM / PlayBook / incident timeline。
## Phase 7 - P1 既有紅燈驗證
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P1 |
| 狀態 | 未開始 |
細項:
- [ ] Production PostgreSQL 直接查 RLS policy不引用舊報告。
- [ ]`.claude/settings.json` token 是否真在 repo/worktree若有移除並輪換。
- [ ] 查 110 swap、188 certbot、188 memory、GCP-B live usage。
- [ ] 查 GitHub workflow 是否仍可能觸發競爭 K3s。
- [ ] 查 188 local Ollama 是否仍有 direct `OLLAMA_URL` caller確認後再清理不直接 uninstall。
## Phase 8 - P2 技術債 / 清理
| 欄位 | 內容 |
| --- | --- |
| 優先級 | P2 |
| 狀態 | 未開始 |
細項:
- [ ] 清理前端舊版本、空洞首頁、無效進度條、小龍蝦進度條資料源。
- [ ] 清掉假資料、硬編 IP、舊 fallback copy、舊 navigation 版本差異。
- [ ] 把已完成與推進中的工作同步到前端,不把聊天內容原文寫成頁面文案。
- [ ] LOGBOOK 持續記錄每階段完成項、commit、Gitea run、正式站證據、整體進度。
## 狀態更新紀錄
| 時間 | Phase | 完成度 | 狀態 |
| --- | --- | --- | --- |
| 2026-06-04 | Phase 0 | 0% | 建立工作清單,開始導航 IA 第一波 |
| 2026-06-04 | Phase 0 | 92% | 導航 IA 本地驗證完成,待 Gitea 推版與正式站證據 |