fix: hide raw import errors in UI

config.py

@@ -402,7 +402,7 @@ YOUTUBE_API_KEY = os.getenv('YOUTUBE_API_KEY', '')
 # ==========================================
 # 系統版本與路徑
 # ==========================================
-SYSTEM_VERSION = "V10.711"
+SYSTEM_VERSION = "V10.712"
 LOG_FILE_PATH = os.path.join(BASE_DIR, 'logs/system.log')
 public_url = PUBLIC_URL  # 用於模板顯示
 

docs/AI_INTELLIGENCE_MODULE_SOT.md

@@ -2,7 +2,7 @@
 
 > **最後更新**: 2026-06-26 (台北時間)
 > **狀態**: 🟢 四 AI Agent 自動化閉環已落地；LLM 路由紅線升級為 Ollama-first 三主機級聯；PChome 後台業績匯入韌性已補強；產品定位正名為「PChome 業績成長自動化作戰系統」；外部市場來源正規化層、自動同步、作戰清單與價格參考表優先讀取、CSV 備援預檢、前台操作入口、高可見頁面繁中化守門、比價/作戰 UI 工作台化、跨平台來源治理與商品身份 UI 契約已建立，GCP embedding 熔斷延後處理、110 proxy rescue 與 direct host health skip 已建立
-> **適用版本**: V10.711
+> **適用版本**: V10.712
 
 ---
 
@@ -796,3 +796,4 @@ POSTGRES_HOST=momo-db
 | 2026-06-26 | 部署前備份入口必須備到專案根目錄 | V10.709 起根目錄 `backup_system.py` 與 `scripts/tools/backup_system.py` 共用同一套備份流程，預設打包專案根目錄並排除 `.env`、Google token、`.git`、runtime volume 與既有 backups，避免只備到 `scripts/tools` 或把敏感 runtime 檔案包入備份。 |
 | 2026-06-26 | 低頻頁也不得藏工程 scaffold 或 raw fallback | V10.710 起市場情報停用頁移除舊 preview scaffold 註解，只保留營運可讀狀態與下一步；PChome 爬蟲匯出操作改為下載商品清單；AI 建議頁若外部訊號未整理成結構，不再直接顯示 raw content，而是提示重新整理或補商品線索。 |
 | 2026-06-26 | 前台不得用爬蟲當使用者主語 | V10.711 起 PChome、設定、舊入口、market intel 與任務確認文字統一使用「商品監控 / 資料擷取 / 監控來源」，不再把「爬蟲」當頁首、導覽、CTA 或提示主語；內部 route/key 可保留以降低部署風險。 |
+| 2026-06-26 | 匯入與設定頁不得回吐 raw 後端錯誤 | V10.712 起自動匯入與系統設定頁的未知錯誤 fallback 只顯示使用者可執行的下一步；Google Drive、格式、同步與資料處理異常可分類成營運文案，但不得把 SQL、snapshot、資料表欄位、driver error 或原始 exception 直接顯示在前台。 |

docs/guides/pchome_growth_ui_ux_guardrails.md

@@ -15,6 +15,7 @@
 7. 商品型頁面必須把商品身份放在主要視覺區：商品圖、平台商品 ID、商品名稱、售價、賣場連結、可信度與下一步不得分散到難以掃描的位置。
 8. 外部主流平台來源治理不得只看 PChome / MOMO；Shopee、Lazada、Amazon、Google Merchant / Shopping、TikTok Shop、LINE 購物、Rakuten、Yahoo 購物、露天、品牌官網 / Shopify、Meta Commerce、Coupang 等來源至少要有待接入契約。未接合法穩定來源前只能標示待接入，不得假裝已監控。
 9. 前台頁首、導覽、CTA 與提示不得把「爬蟲」當使用者主語；應使用「商品監控、資料擷取、監控來源、價格來源」等營運語言。內部 route / key 可維持相容，但不得外露成主要文案。
+10. 前台錯誤 fallback 不得直接回傳後端 raw message；未知錯誤也必須轉成「下一步怎麼處理」的營運語言，原始 exception、資料庫表名、欄位名、driver error、runtime error 只可留在內部 log 或維護介面。
 
 ## 每次 UI/UX 修改的驗收
 

templates/auto_import_index.html

@@ -329,7 +329,7 @@
       }
       return '檢查檔案後重新匯入；若重複失敗，請通知維護人員。';
     }
-    return raw || '等待系統更新任務狀態。';
+    return '等待系統更新任務狀態；若重複停在異常，請通知維護人員。';
   }
 
   // ───── 工具 ─────

templates/system_settings.html

@@ -219,7 +219,7 @@ function toImportActionMessage(message) {
     ) {
         return '業績資料處理未完整完成，請重新匯入最新檔案；若重複失敗請通知維護人員。';
     }
-    return raw;
+    return '系統操作暫時沒有完成，請稍後重試；若重複失敗請通知維護人員。';
 }
 
 function uploadSalesReport() {

tests/test_frontend_v2_assets.py

@@ -734,6 +734,8 @@ def test_utility_pages_keep_operator_copy_professional():
     assert "簡報線上預覽" in ppt_preview
     assert "下載簡報檔" in ppt_history
     assert "送出後更新日報、成長分析與今日作戰清單" in auto_import
+    assert "等待系統更新任務狀態；若重複停在異常" in auto_import
+    assert "return raw ||" not in auto_import
     assert "缺少必要資料時，會先停止匯入" in stockout_import
     assert "先選擇供應商缺貨 Excel 檔。" in vendor_import_js
     assert "使用情境" in ai_calls
@@ -750,6 +752,9 @@ def test_utility_pages_keep_operator_copy_professional():
     assert "健康檢查服務" in ai_automation
     assert "上線證據" in code_review
     assert "資料服務" in login
+    system_settings = (ROOT / "templates/system_settings.html").read_text(encoding="utf-8")
+    assert "系統操作暫時沒有完成，請稍後重試" in system_settings
+    assert "return raw;" not in system_settings
 
     forbidden = [
         "工作視窗",
@@ -791,6 +796,11 @@ def test_utility_pages_keep_operator_copy_professional():
         "Commit:",
         "變更檔案:",
         "查看系統日誌",
+        "could not locate runnable browser",
+        "daily_sales_snapshot",
+        "realtime_sales_monthly",
+        "snapshot_date",
+        "psycopg2",
     ]
     for marker in forbidden:
         assert marker not in combined