# 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 通過後執行 |
