ewoooc/docs/guides/pchome_growth_ui_ux_guardrails.md

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 就是不合格。