diff --git a/docs/AI_INTELLIGENCE_MODULE_SOT.md b/docs/AI_INTELLIGENCE_MODULE_SOT.md index 69db6a2..df24cf0 100644 --- a/docs/AI_INTELLIGENCE_MODULE_SOT.md +++ b/docs/AI_INTELLIGENCE_MODULE_SOT.md @@ -109,7 +109,7 @@ - 2026-07-03 起 `/observability/ppt_audit_history` 必須採密集 AI 視覺 QA 工作台：首屏使用 `data-density-guardrail="compact-ppt-workbench"`，以「預覽就緒、視覺審核、修復閉環」短標籤承接 PPT 產線狀態；hero 說明、KPI 小註、runtime/env var、DB/table wording 與頁尾重複標題不得佔用第一層視覺，畫面先保留最新簡報、產線健康度、最近可預覽簡報、工作隊列、視覺問題追蹤、產出紀錄與修復流程。 - 2026-07-03 起高可見 AI observability surfaces 必須有 route-level rendered HTML readback guard；`/observability/overview`、`/observability/ai_calls`、`/observability/quality_trend`、`/observability/budget`、`/observability/business_intel`、`/observability/host_health`、`/observability/rag_queries`、`/observability/agent_orchestration`、`/observability/promotion_review`、`/observability/ppt_audit_history` 必須在 Flask client render 後仍保留 compact density marker，且不得漏出 `PPT_VISION_ENABLED=`、`PPT_AUTO_GENERATION_ENABLED=`、`ppt_generation_runs`、DB write raw wording、manual/human gate primary wording、Artifact retention / Compact 回讀等產品面不該可見的 engineering copy。 - 2026-07-03 起高可見 AI surface HTML readback 必須納入 runtime AI smoke：`/api/ai-automation/surface-html-readback` 會 read-only 檢查 10 個 AI observability template contract，`/api/ai-automation/smoke` 需包含 `AI surface HTML readback` 檢查，`/api/ai-automation/scheduled-health-summary` 需輸出 `ai_surface_html_readback` family；此檢查不得寫 DB、不得送通知、不得要求 browser，失敗時下一個機器動作是 `repair_ai_surface_html_contract`。 -- 2026-07-03 起整站 UI/UX 專業化必須由 Sitewide UI/UX Agent 管理：`/api/ai-automation/sitewide-ui-ux-agent` 會掃描真正頁面模板、排除 partial/components/base layouts，輸出高優先頁、compact guardrail、raw engineering issue 與 next machine action；`/api/ai-automation/sitewide-ui-ux-repair-package` 會產生 no-write controlled repair package。當前 Agent 判定為 55 個頁面模板、31 個高優先模板、24 個已具 compact guardrail、5 個待專業化、0 個 raw engineering leak；`ai_history`、`ai_recommend`、`admin/ppt_audit_preview`、`cicd_dashboard`、`daily_sales`、`dashboard`、`edm_dashboard`、`growth_analysis`、`pchome_crawler`、`price_comparison`、`sales_analysis` 與 `vendor_stockout_history_v2` 已完成 controlled UI/UX repair，下一個機器動作為繼續套用 `apply_sitewide_ui_ux_controlled_repairs` 到 `vendor_stockout_import_v2`、`vendor_stockout_index_v2`、`vendor_stockout_list_v2`、`vendor_stockout_send_email_v2` 與 `vendor_stockout_vendor_management_v2`。 +- 2026-07-03 起整站 UI/UX 專業化必須由 Sitewide UI/UX Agent 管理：`/api/ai-automation/sitewide-ui-ux-agent` 會掃描真正頁面模板、排除 partial/components/base layouts，輸出高優先頁、compact guardrail、raw engineering issue 與 next machine action；`/api/ai-automation/sitewide-ui-ux-repair-package` 會產生 no-write controlled repair package。當前 Agent 判定為 55 個頁面模板、31 個高優先模板、29 個已具 compact guardrail、0 個待專業化、0 個 raw engineering leak，Sitewide Agent 狀態為 `ok`，repair package 為 `no_op`。四批 controlled UI/UX repair 已完成 AI observability、AI 建議、PPT/CI/CD/業績/比價/成長/供貨風險高優先 surface；下一個機器動作為 `keep_sitewide_ui_ux_agent_monitoring`，後續只接受 Agent 新增 issue 或更高階 visual/mobile QA 的證據驅動修復。 - 2026-07-02 起 `/ai_intelligence` 商品明細與單品作戰詳情的四格價格證據必須可測：PChome 價格、MOMO 參考價、差距、可信度需以 `data-evidence` 固定，並以 `aria-label="價格證據"` 對應可掃描區塊；候選待確認或缺資料只能顯示「候選待確認 / 待補」，不得捏造價格或讓使用者打開 raw payload 才知道判斷依據。 - 2026-07-02 起 `/ai_intelligence` 必須是密集 AI 工作台，不得退回大段文字說明頁：首屏與明細可見內容只保留短狀態、數字、四格證據與下一步按鈕；KPI note、benchmark detail、alert 副句、策略說明、decision copy、來源長句與單品 reason list 不得佔用第一層視覺。`tests/test_ai_intelligence_text_density_guardrails.py` 必須鎖住 `data-density-guardrail="compact-ai-workbench"`、短任務文案、detail meta 與 hidden explanatory copy。 - 2026-07-02 起 `/observability/overview` 也必須採密集 AI 觀測工作台：首屏以 `data-density-guardrail="compact-observability-workbench"`、`AI 觀測 / 風險優先 / 下一步` 與 golden signals 先呈現狀態、數字與操作入口；hero lede、signal note、route desc、host meta 與資料來源長句不得佔用第一層視覺。`tests/test_observability_text_density_guardrails.py` 必須鎖住 compact marker 與 hidden explanatory copy。 diff --git a/docs/guides/external_professional_benchmark.md b/docs/guides/external_professional_benchmark.md index 28060f1..271d606 100644 --- a/docs/guides/external_professional_benchmark.md +++ b/docs/guides/external_professional_benchmark.md @@ -83,7 +83,7 @@ Baymard 的商品頁與比較 UX 研究強調：使用者需要清楚的 product - AI visual QA surface rollout: `/observability/ppt_audit_history` 已套用 compact AI visual QA workbench guardrails；`tests/test_ppt_audit_text_density_guardrails.py` 鎖住首屏短標籤、預覽/審核/修復核心訊號與 non-raw env/table wording。 - Route HTML readback rollout: high-visibility AI observability surfaces 已新增 Flask route-level rendered HTML guard；`tests/test_admin_observability_routes.py::test_high_visibility_ai_surfaces_route_html_readback_keeps_compact_contract` 鎖住 10 個 route 的 compact density marker 與 non-raw engineering wording。 - Runtime HTML readback rollout: `/api/ai-automation/surface-html-readback` 與 AI smoke 已接入 high-visibility AI surface contract readback；`tests/test_ai_automation_smoke_service.py` 鎖住 10 個 surface、退化偵測、smoke check 與 scheduled health family。 -- Sitewide UI/UX Agent rollout: `/api/ai-automation/sitewide-ui-ux-agent` 掃描真正頁面模板並產生整站專業化 inventory；`/api/ai-automation/sitewide-ui-ux-repair-package` 會輸出 no-write controlled repair package，把主流產品頁原則轉成可排序、可驗證的修復項。第二批 controlled repair 已把 PPT 預覽、服務更新監控、當日業績、商品舊入口與 EDM 舊入口加入 compact workbench guardrails；第三批已把成長報表、PChome 商品監控、比價決策台、業績作戰分析與缺貨歷史納入 compact workbench guardrails，Agent 基線收斂到 24 個 compact guardrail / 5 個待專業化 surface。 +- Sitewide UI/UX Agent rollout: `/api/ai-automation/sitewide-ui-ux-agent` 掃描真正頁面模板並產生整站專業化 inventory；`/api/ai-automation/sitewide-ui-ux-repair-package` 會輸出 no-write controlled repair package，把主流產品頁原則轉成可排序、可驗證的修復項。四批 controlled repair 已把 AI 建議、PPT 預覽、服務更新監控、當日業績、商品/EDM 舊入口、成長報表、PChome 商品監控、比價決策台、業績作戰分析與供貨風險頁群納入 compact workbench guardrails，Agent 基線收斂到 29 個 compact guardrail / 0 個待專業化 surface。 ## 下一步 TODO 候選 diff --git a/docs/memory/current_execution_queue_20260524.md b/docs/memory/current_execution_queue_20260524.md index 80f9869..c302b14 100644 --- a/docs/memory/current_execution_queue_20260524.md +++ b/docs/memory/current_execution_queue_20260524.md @@ -172,7 +172,7 @@ - 10 個 AI 觀測台頁面必須符合新版字體、字級、暖墨色、焦糖 accent、點陣視覺與 responsive 規範。 - 全站主要頁面需通過 desktop / mobile overflow guard。 - 表格與圖表只允許在局部容器橫向滾動，不可造成整頁無限延伸。 -- 2026-07-03 起以 Sitewide UI/UX Agent 排序全站專業化工作，不再靠人工逐頁猜測；目前 55 個頁面模板 / 31 個高優先頁中，compact guardrail 已由 14 提升到 24，待專業化 surface 由 15 降到 5。第三批已完成 `growth_analysis`、`pchome_crawler`、`price_comparison`、`sales_analysis` 與 `vendor_stockout_history_v2`，下一批依 Agent repair package 順序處理 vendor stockout 剩餘五頁。 +- 2026-07-03 起以 Sitewide UI/UX Agent 排序全站專業化工作，不再靠人工逐頁猜測；目前 55 個頁面模板 / 31 個高優先頁中，compact guardrail 已由 14 提升到 29，待專業化 surface 由 15 降到 0。第四批已完成 vendor stockout 剩餘五頁，repair package 進入 `no_op`，下一步轉為 production monitoring 與 desktop/mobile visual QA。 ## 8. 效能與可觀測性 diff --git a/templates/vendor_stockout_import_v2.html b/templates/vendor_stockout_import_v2.html index 09ff052..efac143 100644 --- a/templates/vendor_stockout_import_v2.html +++ b/templates/vendor_stockout_import_v2.html @@ -9,7 +9,10 @@ {% block ewooo_content %} {# Upload action is implemented in page-vendor-import.js via fetchWithCSRF('/vendor-stockout/api/import/excel', ...). #} -
+
@@ -20,6 +23,11 @@

補齊供貨風險資料，先保住主推商品供貨。

+
+ 資料匯入 + 欄位檢查 + 缺貨批次 +
回總覽 diff --git a/templates/vendor_stockout_index_v2.html b/templates/vendor_stockout_index_v2.html index f35505c..80258e5 100644 --- a/templates/vendor_stockout_index_v2.html +++ b/templates/vendor_stockout_index_v2.html @@ -8,7 +8,10 @@ {% endblock %} {% block ewooo_content %} -
+
@@ -20,6 +23,11 @@

處理缺貨風險，避免主推商品斷貨。

+
+ 即時指標 + 補貨入口 + 通知追蹤 +
diff --git a/templates/vendor_stockout_list_v2.html b/templates/vendor_stockout_list_v2.html index faca083..e4ba253 100644 --- a/templates/vendor_stockout_list_v2.html +++ b/templates/vendor_stockout_list_v2.html @@ -9,7 +9,10 @@ {% block ewooo_content %} {% set status_labels = {'pending': '待發送', 'sent': '已發送', 'failed': '失敗', 'duplicate': '重複', 'unknown': '未標記'} %} -
+
@@ -20,6 +23,11 @@

先看待發送與失敗，避免主推商品斷貨拖累業績。

+
+ 待發送優先 + 失敗補救 + 供貨天數 +
diff --git a/templates/vendor_stockout_send_email_v2.html b/templates/vendor_stockout_send_email_v2.html index 8e30a59..db8aa72 100644 --- a/templates/vendor_stockout_send_email_v2.html +++ b/templates/vendor_stockout_send_email_v2.html @@ -5,12 +5,21 @@ {% endblock %} {% block content %} -
+
供貨風險

補貨通知紀錄

先處理失敗通知，讓補貨協調不中斷。

+
+ 送達狀態 + 失敗補救 + 通知追蹤 +
總覽 diff --git a/templates/vendor_stockout_vendor_management_v2.html b/templates/vendor_stockout_vendor_management_v2.html index 65575da..6fe2820 100644 --- a/templates/vendor_stockout_vendor_management_v2.html +++ b/templates/vendor_stockout_vendor_management_v2.html @@ -5,12 +5,21 @@ {% endblock %} {% block content %} -
+
供貨風險

供應商窗口

維護正確窗口；維護供應商與收件人，讓缺貨補救能快速送達。

+
+ 窗口品質 + 收件治理 + 補救送達 +
總覽 diff --git a/tests/test_ai_automation_smoke_service.py b/tests/test_ai_automation_smoke_service.py index 0f3281f..ff349c7 100644 --- a/tests/test_ai_automation_smoke_service.py +++ b/tests/test_ai_automation_smoke_service.py @@ -360,8 +360,8 @@ def test_sitewide_ui_ux_agent_inventory_scans_real_pages(): assert inventory["policy"] == "read_only_sitewide_ui_ux_agent_inventory_v1" assert inventory["summary"]["template_count"] >= 50 assert inventory["summary"]["high_priority_template_count"] >= 20 - assert inventory["summary"]["compact_guardrail_count"] >= 24 - assert inventory["summary"]["issue_surface_count"] <= 5 + assert inventory["summary"]["compact_guardrail_count"] >= 29 + assert inventory["summary"]["issue_surface_count"] == 0 assert inventory["summary"]["primary_human_gate_count"] == 0 assert inventory["summary"]["writes_database_count"] == 0 assert inventory["safety"]["writes_database"] is False @@ -382,6 +382,11 @@ def test_sitewide_ui_ux_agent_inventory_scans_real_pages(): assert "templates/price_comparison.html" not in issue_templates assert "templates/sales_analysis.html" not in issue_templates assert "templates/vendor_stockout_history_v2.html" not in issue_templates + assert "templates/vendor_stockout_import_v2.html" not in issue_templates + assert "templates/vendor_stockout_index_v2.html" not in issue_templates + assert "templates/vendor_stockout_list_v2.html" not in issue_templates + assert "templates/vendor_stockout_send_email_v2.html" not in issue_templates + assert "templates/vendor_stockout_vendor_management_v2.html" not in issue_templates def test_sitewide_ui_ux_repair_package_prioritizes_controlled_template_repairs(): diff --git a/web/static/css/page-vendor-import.css b/web/static/css/page-vendor-import.css index dffbc89..0975a51 100644 --- a/web/static/css/page-vendor-import.css +++ b/web/static/css/page-vendor-import.css @@ -49,6 +49,26 @@ line-height: 1.7; } +.stockout-import-modebar { + display: flex; + flex-wrap: wrap; + gap: 8px; + margin-top: 12px; +} + +.stockout-import-modebar span { + display: inline-flex; + align-items: center; + min-height: 28px; + padding: 0 10px; + color: var(--momo-text-secondary); + background: var(--momo-bg-paper); + border: 1px solid var(--momo-border-light); + border-radius: 4px; + font-size: 11px; + font-weight: 800; +} + .stockout-import-actions, .stockout-result-grid { display: flex; diff --git a/web/static/css/page-vendor-index.css b/web/static/css/page-vendor-index.css index a54958d..64a0c7a 100644 --- a/web/static/css/page-vendor-index.css +++ b/web/static/css/page-vendor-index.css @@ -61,6 +61,26 @@ line-height: 1.8; } +.vendor-modebar { + display: flex; + flex-wrap: wrap; + gap: 8px; + margin-top: 12px; +} + +.vendor-modebar span { + display: inline-flex; + align-items: center; + min-height: 28px; + padding: 0 10px; + color: var(--momo-text-secondary); + background: var(--momo-bg-paper); + border: 1px solid var(--momo-border-light); + border-radius: 4px; + font-size: 11px; + font-weight: 800; +} + .vendor-actions { display: flex; gap: 8px; diff --git a/web/static/css/page-vendor-list.css b/web/static/css/page-vendor-list.css index cb7784b..b53402f 100644 --- a/web/static/css/page-vendor-list.css +++ b/web/static/css/page-vendor-list.css @@ -54,6 +54,26 @@ line-height: 1.7; } +.stockout-modebar { + display: flex; + flex-wrap: wrap; + gap: 8px; + margin-top: 12px; +} + +.stockout-modebar span { + display: inline-flex; + align-items: center; + min-height: 28px; + padding: 0 10px; + color: var(--momo-text-secondary); + background: var(--momo-bg-paper); + border: 1px solid var(--momo-border-light); + border-radius: 4px; + font-size: 11px; + font-weight: 800; +} + .stockout-actions, .stockout-status-tabs, .stockout-pagination {