fix: lock pchome growth ui copy guardrails

docs/AI_INTELLIGENCE_MODULE_SOT.md

@@ -780,3 +780,5 @@ POSTGRES_HOST=momo-db
 | 2026-06-26 | 靜態資源部署必須保持容器可讀 | V10.701 起部署 SOP 改用 Git 物件打包差異檔，並以測試檢查 `web/static` 檔案可被容器讀取，避免 macOS / iCloud 工作目錄權限造成正式 `/static/*` 500，讓全站 CSS/JS 不再因檔案模式回歸而失效。 |
 | 2026-06-26 | 治理頁也要用營運情境語，不得渲染 raw caller、服務代碼或錯誤日誌 | V10.702 起 AI 流量頁把 caller/provider/上下文改成「使用情境、建議路徑、作戰素材」；服務更新監控頁隱藏 branch/sha/error log/pod 名稱等工程細節，改用「更新流程、服務元件、診斷線索」語言；缺貨頁移除英文 Vendor Stockout。 |
 | 2026-06-26 | 關鍵決策框架不得因資料不足整段消失 | V10.703 起 AI 流量頁的「情境 × 知識命中矩陣」改為永遠顯示；資料不足時顯示營運空狀態，避免使用者看不到頁面應該如何判讀。 |
+| 2026-06-26 | 使用者頁不得把提交、分支、JSON/API 或 raw caller 當主訊息 | V10.704 起成本治理、AI 分工、AI 健康檢查與登入頁再收斂：raw caller/server 改成使用情境與服務元件，JSONL/API/PostgreSQL/Session/CSRF 等工程語改成檢查紀錄、健康檢查服務、資料服務與工作階段。 |
+| 2026-06-26 | 全站 UI/UX 工作重點必須文件化並納入入口索引 | V10.704 起新增 `docs/guides/pchome_growth_ui_ux_guardrails.md` 並由 `AGENTS.md` 索引；所有前台頁面以「提升 PChome 業績、快速判斷、直接下一步」為共同目標，避免後續工作再偏回局部文案修補。 |

docs/guides/pchome_growth_ui_ux_guardrails.md

@@ -0,0 +1,26 @@
+# PChome Growth UI/UX Guardrails
+
+本專案所有使用者可見頁面，都必須服務同一個產品目標：
+
+> 讓營運者更快判斷如何提升 PChome 業績，並能直接採取下一步。
+
+## 不可偏離的工作重點
+
+1. 每個頁面都要有清楚的營運目的、目前狀態與下一步。
+2. 使用者不應看到工程實作細節，例如資料庫欄位、raw caller、commit、branch、JSON、API、endpoint、模型名稱或錯誤堆疊。
+3. 比價、缺貨、匯入、AI 建議、觀測與服務健康頁，都要用同一套 PChome 業績成長語言：主推、守價、補比價、供貨風險、成長缺口、建議路徑、使用情境、服務元件。
+4. 資料不足時不能整段消失，要顯示可理解的空狀態與下一步。
+5. 不得把工作視窗溝通、部署交接、工程判斷或維護工作摘要搬到前台。
+
+## 每次 UI/UX 修改的驗收
+
+至少要完成：
+
+- 本地測試：`tests/test_frontend_v2_assets.py`
+- 相關業務測試：`tests/test_pchome_revenue_growth_service.py`
+- 正式 smoke：檢查 `/health` 版本、核心頁 HTTP 200、可見文案無 raw terms、靜態資源 HTTP 200
+- 如果頁面有 PChome/MOMO 商品比較，必須能一眼看到兩平台價格與可同時開啟的外部賣場連結
+
+## 判斷標準
+
+如果頁面需要使用者理解「這是什麼欄位、哪個模型、哪個 pipeline、哪個 commit、哪個 API」才知道下一步，這個 UI 就是不合格。