手冊首頁 ／ Guidant AI 功能 SPEC 手冊
Guidant AI 功能 SPEC 手冊
給誰看：新到職的全端工程師，以及需要查「某個功能怎麼運作」的維護者。
怎麼用：從下面的功能群找到你要改的頁面，開該頁的 spec——13 節固定結構，含前後端檔案地圖、API、DB、頁面邏輯與已知坑。
結構：一個頁面 spec = 一條 FE route；頁內 dialog / tab 都寫在該頁 spec 內。
先讀這些（新人第一天）
- BE
開發環境：
docs/user-manual/developer-setup-guide.md（或docs/system-design/的 Setup Guide docx） - 系統全貌（技術）：
docs/交付文件/v1.8.0/GAI-SD-01 系統架構 - 系統全貌（業務）：GAI-SD-07 功能規格總覽（稽核生命週期 + UC）
- 然後回來這裡，按你被指派的功能開頁面 spec
兩種查法
- 知道功能領域（要改稽核流程 / 證據 / 合規框架…）→ 用下面的「功能群 → 頁面 索引」，或直接看左側選單（按領域分組，與 repo 目錄一致）。
- 只知道在產品畫面哪個選單（照著 UI 找）→ 用「產品選單 → spec 對照表」。
產品選單 → spec 對照表（照畫面找）
對齊系統實際的左側選單。同一份 spec 可能對應多個選單入口。
| 產品選單位置 | 對應頁面 spec |
|---|---|
| 專案任務 › 專案儀表板 | 專案儀表板 |
| 專案任務 › 我的任務 | 我的任務 |
| 專案任務 › 專案列表 | 專案列表頁 |
| 專案任務 › 稽核管理 | 我的稽核 |
| 專案任務 › 專案摘要報表 | 專案摘要報表 |
| 合規稽核 › 範本管理 | 範本管理 / 合規資源庫 |
| 合規稽核 › 合規框架管理 | 合規框架管理 |
| 合規稽核 › 稽核流程範本 | BPMN 稽核範本管理 |
| 合規稽核 › 工具外掛管理（目前選單停用） | 工具外掛管理 |
| 溝通協作 › 公告檢視 | 公告檢視 |
| 溝通協作 › 公告管理 | 公告管理 |
| 溝通協作 › 問卷管理 | 問卷管理頁 |
| 溝通協作 › 回饋管理 / 回饋檢視 | 回饋管理 |
| 租戶組織 › 租戶管理 | 租戶管理 |
| 租戶組織 › 部門管理 | 部門管理 |
| 租戶組織 › 使用者管理 | 使用者管理 |
| 租戶組織 › 角色權限管理 | 角色權限管理 |
| 系統管理 › 選單管理 | 選單管理 |
| 系統管理 › 資訊系統盤點 | 資訊系統盤點 |
| 系統管理 › 設備管理 | 設備管理 |
| 系統管理 › 操作日誌 | 操作日誌 |
| 系統設定 › 通知頻道設定 | 通知頻道設定（Telegram / Discord） |
| 系統設定 › SMTP 設定 | SMTP 伺服器設定 |
| 系統設定 › LDAP 設定 | LDAP 設定 |
| 系統設定 › 儲存設定 | 儲存設定 |
| 系統設定 › 檔案 Agent 管理 | 檔案 Agent 管理 |
| 系統設定 › 雲端整合 | 雲端整合 |
| 系統設定 › 議題整合設定 | 議題整合設定 |
| AI 分析 › AI 儀表板 | AI 儀表板 |
| （登入前，非選單） | 登入、忘記 / 重設密碼 |
選單裡沒有獨立入口的流程子頁（專案規劃 / 建立 / 設定、稽核計畫填寫 / AR 判定 / POA&M、各匯入精靈、問卷設計器 / 填寫、證據分類覆核 / 報表、個人資料、背景服務）從父流程進入 — 查它們用左側「功能群 → 頁面 索引」。
功能群 → 頁面 索引
各群先讀
_overview（頁面地圖 / 共用狀態機 / 核心資料模型）再進各頁。完整頁面清單見左側選單（按領域分組、與 repo 目錄一致）；下表為各群總覽入口。