# i3 FM 設計原型 — PRD/ARD 合規審查報告

| 項目 | 內容 |
| --- | --- |
| 審查範圍 | `pages/*.html` 全部 20 個頁面（PRD 18 頁 + 2 個 AI 提案頁） |
| 審查基準 | docs/PRD.md v1.0（§3 角色權限、§4 頁面要求、§5 Session 驗收、§6 NFR）、docs/ARD.md v1.0（§5 數據模型、§6 介面、§7 RLS、§8 保安、§9 部署） |
| 審查日期 | 2026-09-10 |
| 審查方式 | 並行 subagent 逐頁唯讀審計（8 組）＋ Captain 親審 2 頁；無修改任何檔案 |
| 總評 | **18 個 PRD 頁面全部存在、全部有 PRD §4 核心元素**；0 頁完全不合格；9 頁 ✅／近✅，9 頁 ⚠️ 有落差。落差集中喺「權限語義無 UI 呈現」「個別 Session 驗收項欠奉」「數據口徑不一致」三類。 |

---

## 1. 總計分表

| # | 頁面 | 判定 | 一句總結 |
| --- | --- | --- | --- |
| 1 | home.html | ✅ 跟足 | 三大分組＋18 頁全部可達；額外 AI／簡報／文件組已自我標示「提案」 |
| 2 | login.html | ⚠️ | 站點三選項＋v1.4.2＋Root 入口都有，但 Root 入口死連結；token 區係「Pinguo」殘留 |
| 3 | dashboard.html | ⚠️ | 5 KPI＋7 日能耗＋header 四件齊；行動連結全部 `#`；警報詞彙偏離 ARD 六系統 |
| 4 | ticket-pool.html | ⚠️ 高度合規 | 統計／篩選／票號齊；SLA 只有 60 分一級、欠 30 分/4h/24h 參數化；無 field 只限指派註記 |
| 5 | maintenance.html | ⚠️ 重大缺口 | 分組「待處理」≠「新單」；狀態機缺「待驗收」；缺票單轉工單；完工缺「結果」欄 |
| 6 | maintenance-plan.html | ⚠️ 輕微 | 統計／頻率／狀態／5 個保養例子全齊；缺「標記完成→執行記錄」操作；「消防喉喉嘴檢查」日期標逾期但下次執行喺未來 |
| 7 | end-of-day.html | ⚠️ 輕微 | 8 項清單原序齊、86% 進度、簽署閘門文案有；缺「凍結＋audit_log」UI、缺逐項操作者 |
| 8 | alert-cockpit.html | ✅（小項） | 統計（自動19＋手動4）＋四篩選＋新增規則齊；缺手動開警報按鈕；通知鈴紅點無數目 |
| 9 | emergency.html | ⚠️ | 開始應變／INC-092／快照 #128／值班表齊；到場 18 分超標 15 分卻用成功綠（語義色錯）；「3 組」≠動員人數；缺結束應變流程 |
| 10 | compliance.html | ⚠️ | 8 項事項＋四狀態＋審計日期 2026-10-12 齊；權限（僅 owner/admin 可改狀態）無 UI 證據；到期限期口徑不一 |
| 11 | audit-log.html | ✅（小項） | 180 日／不可修改／CSV／1,284 條／六動作篩選齊；「排程任務」「異常偵測」超出 ARD enum |
| 12 | energy-analysis.html | ⚠️ 輕微 | 總能耗/峰值 312kW@18:00/平均/碳排 1,892kg＋24h 曲線＋breakdown＋今日/本月/本年齊；匯出死連結；Pinguo 殘留 demo 區 |
| 13 | vendor-scoring.html | ⚠️ 輕微 | 8 欄排名表齊（含合約到期 2027-01-31 原例）＋Top3 卡＋評分規則掣；缺 expiry 停權狀態／評分加權公式明示 |
| 14 | monthly-report.html | ⚠️ | 版面齊；**同比做咗環比「較上月」**；缺手動重新生成；缺「只計已完成日結月份」閘門 |
| 15 | users-roles.html | ⚠️ | 列表五欄齊；**邀請流程（揀角色→link→7日→即棄→自設密碼）完全欠奉**；3 展示標籤 ↔ 7 角色無映射；無 site_members 一對多提示 |
| 16 | sites.html | ✅（小項） | 統計 6/5/1/2＋六站點卡＋新增站點齊；「在線 5」vs 卡片 4 在線自相矛盾；Root 唯讀註腳與「新增站點」張力 |
| 17 | architecture.html | ⚠️ | 三層架構＋數據流＋核心決定齊；**ARD 6 項技術細節欠奉**（TLS 明示、排程 jobs、離線優先 v1.4.2、Gateway buffer、container、快照上報）；「Equipment CRUD／SQL Import」ARD 冇對應（ground truth 互相唔對齊） |
| 18 | access-control.html | ✅ 跟足 | 7 角色樹＋8×7 矩陣逐格吻合＋三張決策卡一致——全 repo 最貼近 ground truth 嘅頁面 |
| 19 | ai-architecture.html | ✅（提案） | Pi Agent Harness 雙 Agent 草案；無硬性矛盾；Agent 自動開單缺服務身份/RLS/audit 交接定義 |
| 20 | ai-plan.html | ✅（提案） | 主動偵測＋自動派單提案；無硬性矛盾；P1/P2/P3 用詞與 PRD 優先級撞名 |

---

## 2. 跨頁 Top Gaps（按嚴重度）

### 高（影響 PRD 驗收）
1. **權限語義普遍無 UI 呈現**：field「只限指派」（ticket-pool/maintenance 0 處）、合規「僅 owner/admin 可改狀態」（只有查看死鏈）、users-roles 無 invite 邊界/expiry 欄、dashboard 側欄對 staff 顯示 Root 專屬「站點管理」——PRD §3/§5 多個驗收項喺設計層已經無承載。
2. **maintenance.html 狀態機缺「待驗收」＋缺「票單轉工單」**（Session 8 核心流程）。
3. **users-roles.html 邀請流程完全欠奉**（Session 4 核心 UI：揀角色→link→7日→即棄→自設密碼）。
4. **monthly-report 同比（YoY）做咗環比（MoM）**——三個 KPI delta 語義錯誤（S19 驗收 1）。
5. **login「Root 登入中央控制台」死連結**（S2 驗收 2）＋ dashboard 全部行動連結 `#`。

### 中（一致性／口徑）
6. **architecture.html ↔ ARD 六項缺漏**：TLS 明示、排程 jobs、離線優先 v1.4.2、Gateway 本地 buffer／補送、container 部署、快照上報；反向有「Equipment CRUD／SQL Import」係 ARD 冇嘅（兩份 ground truth 要對齊）。
7. **數據自相矛盾**：sites「在線 5」vs 卡片 4 在線；dashboard 未處理警報 3 vs 列表 2；end-of-day 86% vs 7/8=87.5%；maintenance-plan「消防喉喉嘴檢查」下次執行 09-15（未來）卻標逾期。
8. **警報詞彙偏離 ARD**：dashboard 用「結構／其他」分類、「中／低」等級、「已認領」狀態；audit-log 來源「排程任務」、結果「異常偵測」超出 enum；緊急應變語義色（超標用綠）。
9. **Session 細項欠奉**：警報缺手動開警報＋通知鈴數目；應變缺結束應變／結論、動員用「組」非「人數」；月報缺重新生成＋日結閘門；日結缺凍結／audit UI；票務 SLA 得一級。

### 低（工程／設計系統）
10. **Token「兩套方言」**：doc 頁家族（--state-danger, SF Mono）vs app-shell 家族（--state-error, JetBrains Mono）；login/energy/vendor/users-roles 內嵌「Pinguo — Consumer imaging product」殘留 token＋demo 區（~110 行未用 CSS）。
11. **CDN 依賴 vs「離線優先 v1.4.2」矛盾**：多頁依賴 Tailwind browser CDN＋unpkg lucide（斷網即失效／圖示消失）；architecture 等 4 頁載入 lucide 但完全無用（死依賴）。
12. 主題切換／繁中 EN 按鈕全部係裝飾（無 .dark toggle、無 i18n 字典）——PRD §6.3 雙語＋主題屬 NFR。
13. 零散：`cell-mono` 無定義、architecture「部屬」錯字、ai-architecture「WO-4821」唔跟 WO-2409-xxx 格式、compliance header 同其他頁唔一致。

---

## 3. 正面發現

- 18 個 PRD 頁面**一頁不少**，全部有側欄／header shell、lang="zh-Hant"、light/dark token、v1.4.2 標示、home 入口。
- **access-control.html 係模範頁**：8×7 矩陣逐格同 PRD §3.2 吻合，三張決策卡一字不差。
- 數字樣本同 PRD 高度同步：站點 6/5/1/2、審計日期 2026-10-12、合約到期 2027-01-31、快照 #128、票 T-2026-09xx、工單 WO-2409-xxx。
- 技術健康良好：**全 20 頁零重複 id、零斷鏈、標籤配對全過**。
- 兩個 AI 提案頁有自覺標示「提案，未入 PRD/ARD」，同 ground truth 無硬性矛盾。

## 4. 建議下一步

1. P0 修復：maintenance 狀態機＋票單轉工單、users-roles 邀請流程 modal、monthly-report 同比、login Root 連結、dashboard 行動連結。
2. 統一權限語義呈現方式（角色徽章／禁用態／提示），對齊 access-control.html 矩陣。
3. 統一詞彙表（警報六系統／四狀態、七角色標籤）並清理「Pinguo」殘留 token。
4. architecture.html 補 ARD 六項＋同 ARD 對齊 Equipment/SQL Import。
5. 離線化 CDN 依賴（lucide 圖示本地化）或修正「離線優先」主張。

（報告完）