From d668c3873c7bae9625f0f1fc986dbc616a25b6d0 Mon Sep 17 00:00:00 2001 From: ogt Date: Thu, 25 Jun 2026 11:32:44 +0800 Subject: [PATCH] fix: make help and empty states action oriented --- config.py | 2 +- docs/AI_INTELLIGENCE_MODULE_SOT.md | 1 + templates/admin/ppt_audit_history.html | 10 ++--- templates/ai_intelligence.html | 4 +- templates/ai_recommend.html | 12 +++--- templates/daily_sales.html | 2 +- templates/growth_analysis.html | 2 +- templates/index.html | 27 ++++++------- templates/login.html | 2 +- templates/system_settings.html | 2 +- tests/test_pchome_revenue_growth_service.py | 43 +++++++++++++++++++++ 11 files changed, 74 insertions(+), 33 deletions(-) diff --git a/config.py b/config.py index c4537a7..2e40c96 100644 --- a/config.py +++ b/config.py @@ -402,7 +402,7 @@ YOUTUBE_API_KEY = os.getenv('YOUTUBE_API_KEY', '') # ========================================== # 系統版本與路徑 # ========================================== -SYSTEM_VERSION = "V10.664" +SYSTEM_VERSION = "V10.665" LOG_FILE_PATH = os.path.join(BASE_DIR, 'logs/system.log') public_url = PUBLIC_URL # 用於模板顯示 diff --git a/docs/AI_INTELLIGENCE_MODULE_SOT.md b/docs/AI_INTELLIGENCE_MODULE_SOT.md index ce6cbf9..3a76a22 100644 --- a/docs/AI_INTELLIGENCE_MODULE_SOT.md +++ b/docs/AI_INTELLIGENCE_MODULE_SOT.md @@ -741,3 +741,4 @@ POSTGRES_HOST=momo-db | 2026-06-25 | UI/UX 不可只修首頁，導覽主入口必須同一套 PChome 業績提升語言 | V10.662 起作戰、分析、營運、AI 助手主入口與廠商缺貨子工具都使用短句對齊「評估、分析、建議、解法、治理」流程；首頁今日行動卡維持 980px 上限與高對比主按鈕，禁止回到全寬長文說明。 | | 2026-06-25 | 首頁今日行動 CTA 不可被全域 Bootstrap guard 蓋成透明或低對比 | V10.663 起 `#commandTaskButton.growth-command-alert-action` 使用精準 selector 與 `background-color` hard override，正式 smoke 必須量測按鈕背景與卡片寬度。 | | 2026-06-25 | 系統、舊入口與觀測台頁首不可用長篇工程說明取代決策用途 | V10.664 起舊入口、系統管理與 AI 觀測台頁首統一改為短句，聚焦資料新鮮度、成本、品質、RAG 與自癒如何支援 PChome 業績判斷。 | +| 2026-06-25 | 說明、空狀態與登入頁不可停在教學口吻，必須提示下一個業績動作 | V10.665 起 AI 助手說明、業績空狀態、缺貨舊首頁、登入頁與 PPT 視覺 QA 空狀態改為行動導向短句，避免使用者在說明文字中迷路。 | diff --git a/templates/admin/ppt_audit_history.html b/templates/admin/ppt_audit_history.html index 0d2c151..ce91d55 100644 --- a/templates/admin/ppt_audit_history.html +++ b/templates/admin/ppt_audit_history.html @@ -62,7 +62,7 @@
視覺 QA 尚未就緒
- 目前不是模型能力問題，而是執行環境尚未完整開啟。 + 先補齊視覺 QA runtime，再判斷簡報品質。 {{ vision_status.summary }}
@@ -132,7 +132,7 @@
尚無紀錄 待命 - 按下「立即視覺 QA」後會在這裡顯示背景任務狀態。 + 啟動視覺 QA 後會顯示背景任務狀態。
{% endif %}
@@ -522,7 +522,7 @@ {% else %}
- 目前查無本月 DB 產出紀錄；下一次自動排程或手動補齊後，會寫入 ppt_generation_runs 並顯示在這裡。 + 本月尚無 DB 產出紀錄；先補排程或手動產出，再進行視覺 QA。
{% endif %} @@ -733,7 +733,7 @@

尚未形成 daily 審核統計。

-

排程或立即視覺 QA 完成後，這裡會顯示本月通過率、失敗檔案與修復建議。

+

先完成視覺 QA，再看本月通過率、失敗檔案與修復建議。

@@ -766,7 +766,7 @@ {% endif %} {% if not vision_enabled %}
- 為什麼這頁空？ + 先補視覺 QA 條件
  • PPT_VISION_ENABLED=false
  • 188 主機需安裝 LibreOffice
    • diff --git a/templates/ai_intelligence.html b/templates/ai_intelligence.html index b9f972f..66711bb 100644 --- a/templates/ai_intelligence.html +++ b/templates/ai_intelligence.html @@ -2894,7 +2894,7 @@

    正在整理處理建議

    -

    讀取商品、業績與比價狀態後，這裡會顯示最適合的下一步。

    +

    先整理業績、比價與資料狀態，再決定下一步。

    @@ -3192,7 +3192,7 @@
    - 自動來源不足時，再用這裡檢查備援資料品質。 + 自動來源不足時，先檢查備援資料品質。
diff --git a/templates/ai_recommend.html b/templates/ai_recommend.html index c9e432f..289e535 100644 --- a/templates/ai_recommend.html +++ b/templates/ai_recommend.html @@ -26,7 +26,7 @@ Gemini 備援 {{ '檢查中' if gemini_status is none else ('✓' if gemini_status else '✗') }} - @@ -409,26 +409,26 @@
-
使用說明
+
銷售動作
1 -
輸入商品名稱

可直接輸入或從右側熱銷商品點選

+
選商品

優先挑高業績、下滑或有價差壓力的商品。

2 -
選擇文案風格

吸睛活潑、專業權威、溫馨感性、限時急迫

+
選策略語氣

依價格優勢、補貨或活動曝光選文案方向。

3 -
點擊生成文案

AI 會根據市場趨勢自動生成銷售文案

+
產生建議

把商品證據轉成可追蹤的銷售動作。

- 小技巧：使用「AI 智慧搜尋」可獲得更多市場洞察，點選「商品洞察」可分析競品與市場定位。 + 下一步：文案產出後，回到業績成長指揮台追蹤是否帶動商品處理。

diff --git a/templates/daily_sales.html b/templates/daily_sales.html index 343b509..362010f 100644 --- a/templates/daily_sales.html +++ b/templates/daily_sales.html @@ -82,7 +82,7 @@

{{ error }}

-

請前往 系統設定頁面 匯入當日業績 Excel 檔案。

+

先到 系統設定 匯入當日業績，才能判斷下滑與價差壓力。

{% else %} diff --git a/templates/growth_analysis.html b/templates/growth_analysis.html index d5fea87..0e49c3b 100644 --- a/templates/growth_analysis.html +++ b/templates/growth_analysis.html @@ -43,7 +43,7 @@

尚未匯入可分析的業績資料

-

{{ empty_message|default('匯入月度業績資料後，這裡會顯示 YTD、AOV、訂單數與成長趨勢。') }}

+

{{ empty_message|default('先匯入月度業績資料，再評估成長、AOV 與毛利缺口。') }}

{% endif %} diff --git a/templates/index.html b/templates/index.html index 807d41c..b7daf56 100644 --- a/templates/index.html +++ b/templates/index.html @@ -86,34 +86,31 @@

- 系統使用說明 + 缺貨處理順序

- 基本流程 + 先補供貨風險

    -
  1. 下載 Excel 範本，填入缺貨商品資料
    2. -
  2. 在「缺貨清單」使用 Excel 匯入功能上傳檔案
    3. -
  3. 在「缺貨清單」中檢視並編輯資料
    4. -
  4. 在「廠商管理」中設定廠商郵件
    5. -
  5. 在「缺貨清單」勾選商品後發送郵件通知廠商
    6. -
  6. 在「發送歷史」中查看執行結果
    7. +
  7. 匯入缺貨 Excel，先建立正式缺貨資料。
    8. +
  8. 在缺貨清單鎖定待發送與失敗項目。
    9. +
  9. 補齊廠商收件人，讓通知能送達。
    10. +
  10. 發送缺貨通知，避免主推商品斷貨。
    11. +
  11. 回看發送歷史，補救失敗通知。

- 功能特色 + 業績保護重點

    -
  • 自動偵測重複資料並標記
    • -
  • 支援一次匯入多筆缺貨記錄
    • -
  • 依廠商分組自動產生郵件附件
    • -
  • 郵件發送前可預覽內容
    • -
  • 完整的操作記錄與錯誤追蹤
    • -
  • 支援失敗郵件重新發送
    • +
  • 先處理高業績商品的缺貨風險。
    • +
  • 重複資料自動標記，避免通知混亂。
    • +
  • 依廠商分組通知，縮短補貨溝通時間。
    • +
  • 失敗通知可重送，避免補救斷線。
diff --git a/templates/login.html b/templates/login.html index ecf308c..48103e4 100644 --- a/templates/login.html +++ b/templates/login.html @@ -280,7 +280,7 @@ EwoooC

營運數據工作台

-

商品、活動、廠商缺貨與 AI 觀測台都在同一個控制面。登入後會回到正式資料頁面。

+

登入後先看 PChome 業績、價差、缺貨與 AI 建議。