fix: professionalize marketplace product ux
This commit is contained in:
ogt
@@ -1,8 +1,8 @@
|
||||
# PChome 業績成長自動化作戰系統 — AI 競價情報模組 Single Source of Truth
|
||||
|
||||
> **最後更新**: 2026-06-18 (台北時間)
|
||||
> **狀態**: 🟢 四 AI Agent 自動化閉環已落地；LLM 路由紅線升級為 Ollama-first 三主機級聯；PChome 後台業績匯入韌性已補強；產品定位正名為「PChome 業績成長自動化作戰系統」；外部市場來源正規化層、自動同步、作戰清單與價格參考表優先讀取、CSV 備援預檢、前台操作入口、高可見頁面繁中化守門、比價/作戰 UI 工作台化、GCP embedding 熔斷延後處理、110 proxy rescue 與 direct host health skip 已建立
|
||||
> **適用版本**: V10.627
|
||||
> **最後更新**: 2026-06-26 (台北時間)
|
||||
> **狀態**: 🟢 四 AI Agent 自動化閉環已落地；LLM 路由紅線升級為 Ollama-first 三主機級聯；PChome 後台業績匯入韌性已補強；產品定位正名為「PChome 業績成長自動化作戰系統」；外部市場來源正規化層、自動同步、作戰清單與價格參考表優先讀取、CSV 備援預檢、前台操作入口、高可見頁面繁中化守門、比價/作戰 UI 工作台化、跨平台來源治理與商品身份 UI 契約已建立，GCP embedding 熔斷延後處理、110 proxy rescue 與 direct host health skip 已建立
|
||||
> **適用版本**: V10.708
|
||||
|
||||
---
|
||||
|
||||
@@ -55,7 +55,10 @@
|
||||
- 使用者可見 UI、Telegram 與報表文案必須白話、可行動，優先使用「商品對應」「可直接比價」「待補對應」「放大價格優勢」「檢查售價與活動」等營運語言，避免把 `identity_v2`、`match_score`、`candidate queue` 等工程詞直接丟給使用者。
|
||||
- `services/pchome_revenue_growth_service.py` 是第一版只讀作戰清單：讀 PChome 後台業績與已驗證 MOMO 外部價格參考，輸出 `/api/ai/pchome-growth/opportunities`。此服務不呼叫 LLM、不抓外站、不寫 DB。
|
||||
- 2026-06-15 只讀盤點確認：`daily_sales_snapshot."商品ID"` 與 `competitor_prices.competitor_product_id` 在正式資料中直接重疊為 0。因此第一版作戰清單不得硬接兩邊 ID；若沒有可驗證對應，只能輸出「先補商品對應」任務。
|
||||
- 蝦皮與酷澎暫停接入，不進作戰清單、不發告警；後續只可透過 official API / provider API / manual CSV 進 `external_offers` 類正規化層，並清楚標示資料品質。
|
||||
- 外部主流平台不得只限 PChome / MOMO 視角；MOMO 是已接入參考來源，Shopee、Lazada、Amazon、Google Merchant / Shopping、TikTok Shop、LINE 購物、Rakuten、Yahoo 購物、露天、品牌官網 / Shopify、Meta Commerce 與 Coupang 必須先納入來源治理契約。未取得合法穩定來源前只能顯示「待接入 / 不進告警」，不得假裝 AI 已監控或抓到促銷。
|
||||
- 所有外部平台資料進作戰清單前必須正規化為同一商品報價格式：平台商品 ID、商品名稱、賣場連結、商品圖、售價、促銷/券/活動、庫存、資料時間、取得方式、同款狀態、資料可信度。缺商品 ID、缺賣場連結、缺圖片時，UI 必須明確顯示待補狀態，不得留下空白、破圖或資料庫欄位名稱。
|
||||
- 商品清單、AI 挑品、比價覆核與待確認候選必須採商品身份優先 UI：縮圖、商品 ID、平台、賣場連結、價格/促銷狀態、可信度與下一步動作需在同一商品區塊內可一眼掃描；AI 建議不得只顯示長段理由，必須同時提供可開啟的賣場入口。
|
||||
- 蝦皮與酷澎等未接入來源暫停接入，不進作戰清單、不發告警；後續只可透過 official API / provider API / manual CSV 進 `external_offers` 類正規化層，並清楚標示資料品質。
|
||||
- V10.607 新增 `external_market_sources` / `external_offers` 正規化層與 `/api/ai/pchome-growth/source-contract` 只讀 API。MOMO 先以既有比價快取橋接進來源狀態；蝦皮與酷澎只保留 official API、provider API、manual CSV contract，預設暫停且不進告警。
|
||||
- V10.608 新增 `/api/ai/pchome-growth/external-offers/csv-dry-run` 與 AI 情報頁「外部報價預檢」。CSV 預檢只讀、不寫 DB；逐列回報「可使用」「需人工確認」「不能使用」，並支援中文表頭，避免格式小錯造成整批匯入失敗。
|
||||
- V10.609 明確把外部報價主路徑改為自動化：`run_external_offer_sync_task` 每 4 小時將已確認同款的既有比價快取同步進 `external_offers`。CSV 只保留為 API / crawler / provider 失敗時的備援預檢入口，不是日常營運主流程。
|
||||
@@ -784,3 +787,8 @@ POSTGRES_HOST=momo-db
|
||||
| 2026-06-26 | 全站 UI/UX 工作重點必須文件化並納入入口索引 | V10.704 起新增 `docs/guides/pchome_growth_ui_ux_guardrails.md` 並由 `AGENTS.md` 索引；所有前台頁面以「提升 PChome 業績、快速判斷、直接下一步」為共同目標，避免後續工作再偏回局部文案修補。 |
|
||||
| 2026-06-26 | 待確認商品必須能並排比較兩家賣場 | V10.705 起 `ai_intelligence` 與 `price_comparison` 的 MOMO 待確認候選都要以 PChome/MOMO 兩欄比較卡呈現，並提供「同時開兩家賣場」主要操作；不得只顯示候選摘要或只放單一平台連結。 |
|
||||
| 2026-06-26 | 外部促銷活動要進商業情報與 PChome 解法 | V10.705 起商業情報頁新增外部促銷活動監控，從 24h 外部價格/折扣訊號推導外部低價壓力或促銷訊號，並用守價、組合、曝光、會員四類 PChome 業績提升解法承接。 |
|
||||
| 2026-06-26 | 商品型 UI 必須顯示商品身份與賣場操作 | V10.706 起商品看板、AI 挑品與 MOMO 待確認候選需在主要商品區塊顯示商品圖、商品 ID、平台賣場連結、價格/可信度與下一步；缺圖需顯示「待補圖片」，不得留下破圖、空白或資料庫欄位名稱。 |
|
||||
| 2026-06-26 | 外部主流平台需先納入來源治理 | V10.706 起外部來源契約擴充到 Shopee、Lazada、Amazon、Google Merchant / Shopping、Rakuten、Yahoo 購物、Meta Commerce 與 Coupang；未接合法穩定來源前標示待接入且不進告警，避免假裝 AI 已完成監控。 |
|
||||
| 2026-06-26 | 外部來源視野不可停在少數平台 | V10.707 起外部來源契約再補 TikTok Shop、LINE 購物、露天、品牌官網 / Shopify；所有待接來源必須在 UI 顯示為待接入且不進告警，等官方 API、商品 feed、供應商 API 或人工 CSV 通過品質門檻後才可進作戰清單。 |
|
||||
| 2026-06-26 | 同版 CSS 修正必須跳版本破快取 | V10.707 起 UI 修正若影響 `web/static` 資產，必須同步提升 `SYSTEM_VERSION`，讓正式 HTML 的 `?v=` 參數改變；不得在同一版本號下修改 CSS 後宣稱使用者一定看得到。 |
|
||||
| 2026-06-26 | AI 挑品賣場操作必須固定可見 | V10.708 起 AI 挑品清單在桌面寬度固定「AI 建議 / 賣場操作」欄，橫向查看價格與更新欄時仍能直接開 MOMO / PChome 賣場；手機版維持卡片式堆疊。 |
|
||||
|
||||
@@ -12,6 +12,8 @@
|
||||
4. 資料不足時不能整段消失，要顯示可理解的空狀態與下一步。
|
||||
5. 不得把工作視窗溝通、部署交接、工程判斷或維護工作摘要搬到前台。
|
||||
6. 外部促銷活動、折扣、價格壓力與平台活動訊號，必須被整理成「PChome 現況對比」與「業績提升解法」，不能只顯示外部事件本身。
|
||||
7. 商品型頁面必須把商品身份放在主要視覺區：商品圖、平台商品 ID、商品名稱、售價、賣場連結、可信度與下一步不得分散到難以掃描的位置。
|
||||
8. 外部主流平台來源治理不得只看 PChome / MOMO；Shopee、Lazada、Amazon、Google Merchant / Shopping、TikTok Shop、LINE 購物、Rakuten、Yahoo 購物、露天、品牌官網 / Shopify、Meta Commerce、Coupang 等來源至少要有待接入契約。未接合法穩定來源前只能標示待接入，不得假裝已監控。
|
||||
|
||||
## 每次 UI/UX 修改的驗收
|
||||
|
||||
@@ -21,7 +23,10 @@
|
||||
- 相關業務測試：`tests/test_pchome_revenue_growth_service.py`
|
||||
- 正式 smoke：檢查 `/health` 版本、核心頁 HTTP 200、可見文案無 raw terms、靜態資源 HTTP 200
|
||||
- 如果頁面有 PChome/MOMO 商品比較，必須能一眼看到兩平台價格與可同時開啟的外部賣場連結
|
||||
- 如果頁面有商品列、AI 挑品或候選卡，必須能一眼看到商品圖、商品 ID 與可點擊賣場；缺圖只能顯示「待補圖片」等可診斷狀態，不得破圖或空白
|
||||
- 如果商品表格需要橫向捲動，關鍵賣場操作欄必須固定或重複在可見區，不能讓使用者為了開兩家賣場而找不到按鈕
|
||||
- 如果頁面有外部促銷或競品活動訊號，必須至少提供守價、組合、曝光或會員回饋等 PChome 可執行解法
|
||||
- 如果 CSS/JS 在同一輪修正後重新部署，必須同步提升 `SYSTEM_VERSION`，確保正式頁的靜態資源版本參數改變，不讓使用者瀏覽器繼續使用舊樣式
|
||||
|
||||
## 判斷標準
|
||||
|
||||
|
||||
Reference in New Issue
Block a user