diff --git a/docs/AI_INTELLIGENCE_MODULE_SOT.md b/docs/AI_INTELLIGENCE_MODULE_SOT.md index 3218b00..b3053ba 100644 --- a/docs/AI_INTELLIGENCE_MODULE_SOT.md +++ b/docs/AI_INTELLIGENCE_MODULE_SOT.md @@ -105,6 +105,7 @@ - 2026-07-02 起 `/observability/business_intel` 必須採密集 AI 商業工作台：首屏使用 `data-density-guardrail="compact-business-workbench"`，以「戰果追蹤、閉環成效、競品訊號」短標籤承接 AI 商業狀態；hero 說明、決策節奏註解、KPI 小註、panel 說明與頁尾資料來源不得佔用第一層視覺，畫面先保留高信心未跟進、平均信心分、有效率、競品監測、外部促銷活動監控、策略族群、最近建議與閉環學習紀錄。 - 2026-07-02 起 `/observability/host_health` 必須採密集 AI runtime 工作台：首屏使用 `data-density-guardrail="compact-runtime-workbench"`，以「主機級聯、自癒閉環、成本節流」短標籤承接 AI runtime 狀態；hero 說明、KPI 小註與頁尾重複標題不得佔用第一層視覺，畫面先保留建議服務離線、AIOps 未解、自癒成功率、節流供應商、AI 建議服務主機、健康趨勢、自癒閉環、工具層與事件紀錄。 - 2026-07-02 起 `/observability/rag_queries` 必須採密集 AI 知識工作台：首屏使用 `data-density-guardrail="compact-knowledge-workbench"`，以「知識命中、省模閉環、回饋學習」短標籤承接 RAG 召回狀態；hero 說明、KPI 小註與頁尾重複標題不得佔用第一層視覺，畫面先保留查詢數、命中率、省模型、回饋分、查詢串流、使用情境品質與命中內容查閱。 +- 2026-07-03 起 `/observability/promotion_review` 必須採密集 AI 晉升例外工作台：首屏使用 `data-density-guardrail="compact-promotion-workbench"`，以「AI 例外、去重守門、防污染」短標籤承接知識晉升例外狀態；hero 說明、KPI 小註與頁尾重複標題不得佔用第一層視覺，畫面先保留待決策、知識庫、30 日採用、污染攔截、例外佇列、策略權重與最近知識；不得把人工審核呈現為 primary flow。 - 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 19df34c..bafdb35 100644 --- a/docs/guides/external_professional_benchmark.md +++ b/docs/guides/external_professional_benchmark.md @@ -79,6 +79,7 @@ Baymard 的商品頁與比較 UX 研究強調：使用者需要清楚的 product - AI business surface rollout: `/observability/business_intel` 已套用 compact AI business workbench guardrails；`tests/test_business_intel_text_density_guardrails.py` 鎖住首屏短標籤、商業戰果/閉環/競品核心訊號與 hidden explanatory copy。 - AI runtime surface rollout: `/observability/host_health` 已套用 compact AI runtime workbench guardrails；`tests/test_host_health_text_density_guardrails.py` 鎖住首屏短標籤、主機級聯/自癒/節流核心訊號與 hidden explanatory copy。 - AI knowledge surface rollout: `/observability/rag_queries` 已套用 compact AI knowledge workbench guardrails；`tests/test_rag_queries_text_density_guardrails.py` 鎖住首屏短標籤、知識命中/省模閉環/回饋學習核心訊號與 hidden explanatory copy。 +- AI promotion exception surface rollout: `/observability/promotion_review` 已套用 compact AI promotion workbench guardrails；`tests/test_promotion_review_text_density_guardrails.py` 鎖住首屏短標籤、AI 例外/去重守門/防污染核心訊號與 non-manual wording。 ## 下一步 TODO 候選 @@ -96,6 +97,7 @@ Baymard 的商品頁與比較 UX 研究強調：使用者需要清楚的 product - 已完成: `/observability/business_intel` 首屏以「戰果追蹤 / 閉環成效 / 競品訊號」短標籤與四個核心數字呈現 AI 商業轉化狀態。 - 已完成: `/observability/host_health` 首屏以「主機級聯 / 自癒閉環 / 成本節流」短標籤與四個核心數字呈現 AI runtime 健康狀態。 - 已完成: `/observability/rag_queries` 首屏以「知識命中 / 省模閉環 / 回饋學習」短標籤與四個核心數字呈現 AI 知識召回狀態。 + - 已完成: `/observability/promotion_review` 首屏以「AI 例外 / 去重守門 / 防污染」短標籤與四個核心數字呈現 AI 晉升例外狀態。 ## 參考來源 diff --git a/docs/guides/pchome_ai_automation_priority_backlog.md b/docs/guides/pchome_ai_automation_priority_backlog.md index 8e2800a..9bd5272 100644 --- a/docs/guides/pchome_ai_automation_priority_backlog.md +++ b/docs/guides/pchome_ai_automation_priority_backlog.md @@ -101,7 +101,7 @@ ## P1 - Product Visibility And Professional Website Experience -狀態: 進行中，本輪已完成 `/ai_intelligence`、`/observability/overview`、`/ai_automation_smoke`、`/observability/agent_orchestration`、`/observability/ai_calls`、`/observability/quality_trend`、`/observability/budget`、`/observability/business_intel`、`/observability/host_health` 與 `/observability/rag_queries` 密集 AI 工作台文字密度守門。 +狀態: 進行中，本輪已完成 `/ai_intelligence`、`/observability/overview`、`/ai_automation_smoke`、`/observability/agent_orchestration`、`/observability/ai_calls`、`/observability/quality_trend`、`/observability/budget`、`/observability/business_intel`、`/observability/host_health`、`/observability/rag_queries` 與 `/observability/promotion_review` 密集 AI 工作台文字密度守門。 目的: 讓 AI 自動化在產品裡可見，成為專業營運工作流，而不是只藏在後端。 @@ -160,6 +160,10 @@ - 首屏改成 `data-density-guardrail="compact-knowledge-workbench"`，以「知識命中 / 省模閉環 / 回饋學習」短標籤承接 RAG 召回狀態。 - hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留查詢數、命中率、省模型、回饋分、查詢串流、使用情境品質與命中內容查閱。 - `tests/test_rag_queries_text_density_guardrails.py` 已鎖住 compact marker、第一層知識訊號與 explanatory copy hidden contract。 +- `/observability/promotion_review` 密集 AI 晉升例外工作台文字密度 guard 已完成: + - 首屏改成 `data-density-guardrail="compact-promotion-workbench"`，以「AI 例外 / 去重守門 / 防污染」短標籤承接知識晉升例外狀態。 + - hero 說明、KPI 小註與頁尾重複標題從可見 UI 退場，保留待決策、知識庫、30 日採用、污染攔截、例外佇列、策略權重與最近知識。 + - `tests/test_promotion_review_text_density_guardrails.py` 已鎖住 compact marker、第一層晉升例外訊號與 non-manual wording。 已完成 / 下一步，必須照順序: @@ -285,6 +289,7 @@ | P1.7 | Agent orchestration compact workbench text-density guardrails | 已完成 | `/observability/agent_orchestration` first viewport hides explanatory copy; focused density guard test | Apply density guard to remaining high-visibility AI surfaces | | P1.8 | AI calls compact workbench text-density guardrails | 已完成 | `/observability/ai_calls` first viewport hides explanatory copy; focused density guard test | Apply density guard to remaining high-visibility AI surfaces | | P1.9 | Quality trend compact workbench text-density guardrails | 已完成 | `/observability/quality_trend` first viewport hides explanatory copy; focused density guard test | Apply density guard to remaining high-visibility AI surfaces | +| P1.10 | Promotion review compact AI exception workbench guardrails | 已完成 | `/observability/promotion_review` first viewport hides explanatory copy and avoids manual-primary wording; focused density guard test | Apply density guard to PPT audit surface | | P2.1 | External benchmark encoded into requirements | 已完成 | benchmark guide + focused guard test + first-viewport status | P3.1 safe lane expansion | | P3.1 | Extend receipt / replay / drift pattern to more lanes | 已完成 | direct mapping candidate decision lane closeout route + focused tests | P3.2 scheduled automation health summaries | | P3.2 | Scheduled automation health summaries | 已完成 | `/api/ai-automation/scheduled-health-summary` + smoke service focused tests | P3.3 rollback evidence packages | diff --git a/templates/admin/promotion_review.html b/templates/admin/promotion_review.html index 7403a0e..6adc055 100644 --- a/templates/admin/promotion_review.html +++ b/templates/admin/promotion_review.html @@ -9,6 +9,9 @@ .gate-kicker { color:var(--obs-accent); font-size:.76rem; letter-spacing:.13em; text-transform:uppercase; font-weight:850; } .gate-title { margin:.45rem 0 .25rem; font-family: var(--momo-font-display, "Inter", "Noto Sans TC", system-ui, sans-serif); font-size:var(--obs-title-size); letter-spacing: 0; line-height:.98; } .gate-subtitle { color:var(--obs-muted); max-width:880px; line-height:1.7; } + .gate-mode-row { display:flex; flex-wrap:wrap; gap:.5rem; margin-top:.75rem; } + .gate-mode { display:inline-flex; align-items:center; min-height:28px; padding:.32rem .65rem; border:1px solid var(--obs-line); border-radius:10px; background:rgba(255,255,255,.62); color:var(--obs-muted); font-size:.74rem; font-weight:850; white-space:nowrap; } + .gate-subtitle, .gate-signal small, .gate-review-copy, .gate-footer-copy { display:none; } .gate-command { display:grid; grid-template-columns:repeat(4,minmax(0,1fr)); gap:.75rem; margin-top:1rem; } .gate-signal { padding:.95rem; border:1px solid var(--obs-line); border-radius:20px; background:rgba(255,255,255,.62); } .gate-label { color:var(--obs-muted); font-size:.72rem; letter-spacing:.1em; text-transform:uppercase; } @@ -40,15 +43,16 @@ {% set approval_rate = (approved_30d / total_dist * 100) if total_dist > 0 else 0 %}
-
-
知識晉升審核 · 人工審核 / 去重 / 防污染
-

知識晉升審核

+
+
知識晉升審核 · AI 例外決策 / 去重 / 防污染
+

AI 晉升例外台

+
AI 例外去重守門防污染

先審核高權重學習片段，避免錯誤知識污染業績建議。

-
待審核
{{ episodes|length }}高權重待審片段
+
待決策
{{ episodes|length }}高權重待審片段
知識庫
{{ kb_size or 0 }}ai_insights 已晉升
-
30 日通過率
{{ "%.0f"|format(approval_rate) }}%{{ approved_30d }}/{{ total_dist }} 個片段
-
30 日拒絕
{{ rejected_30d.value }}品質 / 幻覺 / 重複 / 人工拒
+
30 日採用
{{ "%.0f"|format(approval_rate) }}%{{ approved_30d }}/{{ total_dist }} 個片段
+
污染攔截
{{ rejected_30d.value }}品質 / 幻覺 / 重複 / 例外否決
@@ -57,9 +61,9 @@
-
審核佇列

待審核片段

{{ episodes|length }} 筆
+
例外佇列

待決策片段

{{ episodes|length }} 筆
-

權重 ≥ 0.8 必經審核；24 小時無回應自動降權。

+

權重 ≥ 0.8 必經 AI 例外檢查；24 小時無回應自動降權。

@@ -74,7 +78,7 @@
{{ ep.distilled_text }}
{% if ep.similar_insights %}
Top 3 相似已晉升知識（用來判斷是否重複）
    {% for sim in ep.similar_insights %}
  • #{{ sim.id }}{{ obs_label.insight(sim.insight_type) }}相似度 {{ "%.2f"|format(sim.similarity) }}{{ sim.content }}{% if sim.content|length >= 180 %}…{% endif %}
    • {% endfor %}
{% else %}
知識庫無相似度 ≥ 0.7 的相似內容，可能是新領域知識。
{% endif %}
-
+
{% endfor %} {% else %} @@ -96,7 +100,7 @@
知識庫

最近 10 筆 ai_insights

{% for i in latest_insights %}{% endfor %}
#類型期間SKU建立時間預覽
#{{ i.id }}{{ i.insight_type }}{{ i.period or '—' }}{{ i.product_sku or '—' }}{{ i.created_at }}{{ i.preview }}{% if i.preview|length >= 160 %}…{% endif %}
{% endif %} -

知識晉升審核

+

知識晉升審核

diff --git a/tests/test_promotion_review_text_density_guardrails.py b/tests/test_promotion_review_text_density_guardrails.py new file mode 100644 index 0000000..cd24bc6 --- /dev/null +++ b/tests/test_promotion_review_text_density_guardrails.py @@ -0,0 +1,52 @@ +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] + + +def test_promotion_review_uses_compact_promotion_workbench_contract(): + template = (ROOT / "templates/admin/promotion_review.html").read_text(encoding="utf-8") + + assert 'data-density-guardrail="compact-promotion-workbench"' in template + assert 'aria-label="AI 晉升狀態模式"' in template + assert "AI 例外" in template + assert "去重守門" in template + assert "防污染" in template + + +def test_promotion_review_keeps_exception_signals_and_hides_explanatory_copy(): + template = (ROOT / "templates/admin/promotion_review.html").read_text(encoding="utf-8") + + for marker in ["待決策", "知識庫", "30 日採用", "污染攔截"]: + assert marker in template + + assert ".gate-subtitle, .gate-signal small, .gate-review-copy, .gate-footer-copy { display:none; }" in template + assert 'class="gate-subtitle"' in template + assert "gate-review-copy" in template + assert "gate-footer-copy" in template + + +def test_promotion_review_preserves_ai_exception_workflow_and_non_manual_wording(): + template = (ROOT / "templates/admin/promotion_review.html").read_text(encoding="utf-8") + + for marker in [ + "AI 晉升例外台", + "例外佇列", + "待決策片段", + "採用晉升", + "否決污染", + "30 日狀態分布", + "策略權重 Top", + "最近 10 筆 ai_insights", + ]: + assert marker in template + + for forbidden in [ + "人工審核", + "人工拒", + "manual_required", + "raw payload", + "raw endpoint", + "資料表:", + ]: + assert forbidden not in template