feat(web): consolidate navigation IA shell

docs/workplans/2026-06-25-awoooi-navigation-ia-consolidation.md

@@ -0,0 +1,75 @@
+# AWOOOI 導航與頁面資訊架構整合決策表
+
+> 日期：2026-06-25（台北時間）
+> 基線：`gitea/main=3466fa995944b25ff627046c40f9121a449538f3`
+> 目標：把左側導航、AwoooP 二層菜單、頁內 tabs 與重複頁面整合成專業 AI 營運產品資訊架構。
+> 邊界：本輪先調整導航曝光與 AwoooP contextual rail；不刪除路由、不改 API、不開 runtime gate。
+
+## 1. 設計原則
+
+1. 左側 Sidebar 只放「主工作區」，不再列出所有下鑽頁。
+2. 子頁入口放在對應工作區的 contextual rail，不和全域導航重複。
+3. Page tabs 只做「同一頁的視角切換」，不能再承擔主導航。
+4. 舊頁保留為 deep link / redirect / tab panel，直到資料鏈與 smoke 完成後才刪除。
+5. 所有新增頁面必須先有 API truth / read model，不允許只做靜態展示頁。
+
+## 2. 新主導航
+
+| 主工作區 | 入口 | 吸收 / 別名頁 | 角色 |
+|---|---|---|---|
+| 指令中心 | `/` | 首頁 tabs | 全域狀況與最重要 action-required。 |
+| AwoooP 操作台 | `/awooop` | `/awooop/work-items`、`/awooop/runs`、`/awooop/approvals`、`/awooop/contracts`、`/awooop/tenants`、`/alerts`、`/authorizations` | AI 自動化、事故、工作項、批准與全產品資產入口。 |
+| 可觀測性 | `/observability` | `/monitoring`、`/apm`、`/errors`、`/apps`、`/services`、`/topology` | 主機、服務、網站、工具、SLO、告警與 blast radius 拓樸。 |
+| 知識與自動化 | `/knowledge-base` | `/knowledge`、`/automation`、`/auto-repair`、`/drift`、`/neural-command` | KM、PlayBook、腳本、排程、dry-run worker 與自動化候選。 |
+| IwoooS（治理與安全） | `/governance` | `/iwooos`、`/code-review`、`/security-compliance`、`/security`、`/compliance` | Owner gate、資安 posture、Agent market、Code Review / release safety；Sidebar 保留 `iwooos-security` sentinel。 |
+| 營運 | `/operations` | `/deployments`、`/tickets`、`/cost`、`/billing`、`/action-logs`、`/reports` | 部署、工單、成本、帳務、報表與 action ledger。 |
+| 系統工具 | `/terminal`、`/settings`、`/classic`、`/help` | hidden / bottom | 低頻管理與相容入口。 |
+
+## 3. 頁面處置決策
+
+| 頁面 | 決策 | 何時刪除或 redirect | 下一步 |
+|---|---|---|---|
+| `/awooop` | 保留為 AwoooP command overview | 不刪 | 改成 Situation Strip + Agent Flow + Risk Matrix + Action Rail。 |
+| `/awooop/work-items` | 保留下鑽 | 不刪 | 改成 operator queue；manual item 必須有 SOP rail。 |
+| `/awooop/runs` | 保留下鑽 | 不刪 | 改成 execution timeline；raw evidence 進 drawer。 |
+| `/awooop/approvals` | 保留下鑽 | 不刪 | 改成 decision tree；stuck approval 要顯示 owner / next action。 |
+| `/awooop/contracts` | 保留下鑽 | 不刪 | 合約與 gate 改為 matrix，不再純表格。 |
+| `/awooop/tenants` | 保留並升級 | 不刪 | 變成全產品 coverage heatmap + topology；吸收各產品納管狀態。 |
+| `/alerts` | 降級為 AwoooP / Observability 下鑽 | 等 AwoooP incident center 完成後 redirect | 告警不再單獨成主頁；與 incident timeline 串接。 |
+| `/authorizations` | 降級為 AwoooP Approvals 別名 | Approvals parity 完成後 redirect | 合併批准狀態鏈與 owner gate。 |
+| `/observability` | 保留主工作區 | 不刪 | 加入 host / service / product topology 與 SLO heatmap。 |
+| `/monitoring`、`/apm`、`/errors`、`/apps`、`/services` | 合併為 Observability tabs | Observability tabs 完成 parity 後 redirect | 保留深連結到 `?tab=`。 |
+| `/topology` | 合併為 Observability topology view | Topology parity 完成後 redirect | 改為拓樸 tab 或 drawer。 |
+| `/knowledge-base` | 保留主工作區 | 不刪 | 修資料鏈，顯示 KM / PlayBook / scripts / schedules trust ledger。 |
+| `/knowledge` | redirect / alias | 已是 redirect 候選 | Sidebar 改指 `/knowledge-base`。 |
+| `/automation` | 合併為 Knowledge & Automation tabs | 自動化 tabs 完成 parity 後 redirect | Auto-repair / drift / neural command 改為同一頁視角。 |
+| `/auto-repair`、`/drift`、`/neural-command` | 降級為 Knowledge & Automation 下鑽 | parity 完成後 redirect | 不再當主導航。 |
+| `/governance` | 保留主工作區 | 不刪 | 改成 AgentOps governance cockpit，減少長文字卡。 |
+| `/iwooos` | 保留安全 posture 下鑽 | 不刪 | 改成 governance / security 的 security posture view。 |
+| `/code-review` | 保留 release safety 下鑽 | 不刪 | 合併全產品 pre/post deploy gate。 |
+| `/security-compliance`、`/security`、`/compliance` | 合併到 Governance / Security | parity 完成後 redirect | 不再重複展示 IwoooS / compliance 資訊。 |
+| `/operations` | 保留主工作區 | 不刪 | 部署 / 工單 / 成本 / 日誌 / 帳務統一入口。 |
+| `/deployments`、`/tickets`、`/cost`、`/billing`、`/action-logs`、`/reports` | 合併為 Operations tabs | parity 完成後 redirect | 保留可搜尋 deep link。 |
+| `/terminal`、`/settings`、`/help` | 系統工具 | 不刪 | 從主流程分離。 |
+| `/classic`、`/demo` | 相容 / legacy | 有替代頁後移除主導航 | 不再推為主要產品入口。 |
+| `/users`、`/notifications` | Admin candidate | 等 Admin 工作區設計 | 暫不新增主導航，避免膨脹。 |
+
+## 4. 本輪已實作
+
+| 項目 | 狀態 |
+|---|---|
+| Sidebar 改為主工作區導向 | 完成 |
+| AwoooP 子頁搬到 contextual workflow rail | 完成 |
+| Command Palette 空查詢只顯示主工作區與快速動作 | 完成 |
+| `/knowledge` sidebar 入口改指 `/knowledge-base` | 完成 |
+| 子頁 deep link 保留 | 完成 |
+
+## 5. 下一輪必做
+
+| 優先級 | 工作 | 驗收 |
+|---|---|---|
+| P0 | AwoooP Overview / Runs / Work Items / Approvals 共用 Situation Strip / Agent Flow / Action Rail | desktop / mobile 首屏能一眼看懂卡點與下一步 |
+| P0 | Tenants coverage heatmap | 16 產品、31 routes、10 repos、owner / smoke / runtime gate 一張圖看懂 |
+| P0 | Observability topology | 主機 / 服務 / 網站 / 告警 / SLO 關聯可視化 |
+| P0 | Knowledge / Automation trust ledger | KM、PlayBook、腳本、排程、dry-run、verifier 有統一沉澱面板 |
+| P1 | 開始 redirect 舊頁 | 只有在父頁 `?tab=` parity 與 production smoke 通過後執行 |