75 lines
4.0 KiB
Markdown
75 lines
4.0 KiB
Markdown
# Current Execution Queue 2026-05-24
|
||
|
||
> 目的：把目前使用者要求的核心產品優化整理成單一執行佇列，避免 UI、比價、PPT、AI 觀測台與部署驗證漏項。
|
||
> 原則：準確率優先；不放寬 MOMO / PChome 全域比對門檻；正式部署不碰 `momo-db`；每個工作流都需有測試或正式 smoke。
|
||
|
||
## 0. 部署與驗證通道基準
|
||
|
||
- 確認 `main`、Gitea、正式環境版本一致。
|
||
- 修復或確認 SSH / Gitea / 188 hop 可用。
|
||
- 每次上線只 recreate `momo-app`、`scheduler`、`telegram-bot`，禁止使用 `--remove-orphans`，禁止影響 `momo-db`。
|
||
|
||
## 1. MOMO / PChome 核心比價準確率
|
||
|
||
- 查正式 `competitor_match_attempts` 最新狀態分布與高量低信心 cohort。
|
||
- 以小批次 pilot 處理 `recoverable_low_score`，優先品線：
|
||
- DASHING DIVA
|
||
- aroma / diffuser / essential oil
|
||
- lip / cosmetic variant
|
||
- private-care / body-care
|
||
- 只新增窄範圍、可解釋 matcher 規則。
|
||
- 保留 `MIN_MATCH_SCORE`、`identity_veto`、既有正式候選覆寫保護。
|
||
- 驗收：`matched` 有增加、目標 `low_score` 下降、`needs_review` 不異常上升、無明顯跨色號/跨款式/跨劑型錯配。
|
||
|
||
## 2. 商品列表與人工覆核閉環
|
||
|
||
- 商品列表不得再大量顯示籠統「待對比」。
|
||
- 將狀態拆成：尚未搜尋、價格過期待刷新、近門檻可救回、證據不足、既有強配對保護、已排除、需單位價比較、找不到同款。
|
||
- 每筆覆核要顯示候選 PChome 商品、候選價、match score、診斷原因、下一步動作。
|
||
- 人工採用 / 否決 / 單位價 / 補搜尋必須能回寫 review queue，並影響 feeder 後續行為。
|
||
|
||
## 3. 12 Agent 決策信封整合
|
||
|
||
- `decision_envelope` 已接到 NemoTron 價格告警與人工覆核，下一步要讓 OpenClaw、ElephantAlpha、PPT QA 與 review queue 共用同一份 evidence contract。
|
||
- 告警不得再輸出空泛「預期效益」；必須帶資料品質、證據來源、HITL 邊界與 trace id。
|
||
- Agent 建議只能輔助排序與分析，不得繞過 matcher / feeder / review service 寫正式價格。
|
||
|
||
## 4. 業績分析資料與圖表修復
|
||
|
||
- 修正即時業績匯入 `snapshot_date text = date` 類型錯誤。
|
||
- `/daily_sales`、`/growth_analysis` 圖表不得空白；需保留原本圖表並升級成更專業的呈現。
|
||
- 圖表需通過 runtime nonblank canvas 檢查與手機版 responsive。
|
||
- daily/growth/PPT 必須共用 `competitor_intel_repository` 的比價資料出口，避免價差方向或統計口徑分裂。
|
||
|
||
## 5. PPT 視覺 QA 與自動簡報產線
|
||
|
||
- 每日、每週、每月、每季、半年、年度簡報需依排程產出。
|
||
- 每次產出與視覺 QA 結果必須完整寫入 DB。
|
||
- `/observability/ppt_audit_history` 必須清楚顯示 runtime 狀態、產出狀態、視覺 QA、問題追蹤與可預覽檔案。
|
||
- PPTX / PDF 預覽需可站內直接開啟，不能只下載。
|
||
|
||
## 6. 外部 BI / 協作入口
|
||
|
||
- `/metabase` 不可空白，需顯示可診斷 bridge 狀態或可用替代入口。
|
||
- `/grist` / 資料協作連結不得連到其他專案站。
|
||
- 側欄與 topbar 外部工具入口要統一走 momo-pro bridge route。
|
||
|
||
## 7. AI 觀測台與全站 UI/UX
|
||
|
||
- 10 個 AI 觀測台頁面必須符合新版字體、字級、暖墨色、焦糖 accent、點陣視覺與 responsive 規範。
|
||
- 全站主要頁面需通過 desktop / mobile overflow guard。
|
||
- 表格與圖表只允許在局部容器橫向滾動，不可造成整頁無限延伸。
|
||
|
||
## 8. 效能與可觀測性
|
||
|
||
- 持續降低 `/daily_sales`、`/growth_analysis`、商品看板、PChome queue、PPT audit 首屏 TTFB。
|
||
- 避免 worker cold start 重查重算；必要時使用共享快取與指紋失效。
|
||
- 111 fallback 只作最後救急；持續監控 GCP-A / GCP-B / 111 用量與 circuit breaker。
|
||
|
||
## 9. 每輪收尾
|
||
|
||
- Focused tests → full pytest 或合理範圍回歸 → production smoke。
|
||
- 更新 SOT / memory / TODO。
|
||
- 推 Gitea，正式部署，確認 `/health` 版本。
|
||
- 記錄未完成與下一輪入口。
|