補齊 PChome 候選例外自動解法

tests/test_pchome_mapping_backlog_report.py

@@ -72,6 +72,7 @@ from services.pchome_mapping_backlog_service import (
     build_pchome_evidence_source_preview,
     build_pchome_direct_mapping_auto_search_package,
     build_pchome_direct_mapping_candidate_decision_package,
+    build_pchome_direct_mapping_candidate_exception_auto_resolution_package,
     build_pchome_growth_ai_automation_readiness,
     build_pchome_mapping_operator_preview,
     parse_pchome_product_page_evidence_html,
@@ -409,6 +410,58 @@ def test_direct_mapping_candidate_decision_package_routes_candidates_to_machine_
     assert package["safety"]["persists_candidate"] is False
 
 
+def test_direct_mapping_candidate_exception_auto_resolution_builds_machine_artifacts():
+    def fake_search(targets, limit_per_product, max_products, max_terms_per_product, min_score):
+        return True, "found", [
+            {
+                "product_id": "MOMO-VARIANT",
+                "name": "Direct mapping product 40ml 多款任選",
+                "price": 899,
+                "target_pchome_product_id": "PCH-2",
+                "target_pchome_name": "Direct mapping product 40ml x2",
+                "target_match_score": 0.51,
+                "auto_compare_type": "manual_review",
+                "target_hard_veto": False,
+            },
+            {
+                "product_id": "MOMO-UNIT",
+                "name": "Direct mapping product 40ml",
+                "price": 499,
+                "target_pchome_product_id": "PCH-2",
+                "target_pchome_name": "Direct mapping product 40ml x2",
+                "target_match_score": 0.91,
+                "auto_compare_type": "unit_price",
+                "target_hard_veto": True,
+            },
+        ]
+
+    package = build_pchome_direct_mapping_candidate_exception_auto_resolution_package(
+        _payload(),
+        batch_size=1,
+        execute_search=True,
+        search_func=fake_search,
+    )
+
+    artifacts = package["auto_resolution_package"]["auto_resolution_artifacts"]
+    assert package["policy"] == "read_only_pchome_growth_direct_mapping_candidate_exception_auto_resolution"
+    assert package["result"] == "DIRECT_MAPPING_CANDIDATE_EXCEPTION_AUTO_RESOLUTION_READY"
+    assert package["summary"]["machine_review_exception_receipt_count"] == 2
+    assert package["summary"]["exception_auto_resolution_artifact_count"] == 2
+    assert package["summary"]["variant_bundle_discriminator_count"] == 1
+    assert package["summary"]["named_candidate_evidence_delta_count"] == 1
+    assert package["summary"]["unit_basis_search_expansion_count"] == 1
+    assert package["summary"]["retry_search_action_count"] == 1
+    assert artifacts[0]["artifact_id"].startswith("pchome-direct-mapping-exception-resolution-")
+    assert artifacts[0]["resolvers"]["variant_bundle_discriminator"]["writes_database"] is False
+    assert artifacts[0]["resolvers"]["named_candidate_evidence_delta"]["resolution"] == "ready_for_retry_search"
+    assert "unit_basis_search_expansion" in artifacts[1]["resolvers"]
+    assert any("40ml" in term.lower() for term in artifacts[1]["resolvers"]["unit_basis_search_expansion"]["expanded_search_terms"])
+    assert artifacts[1]["guardrails"]["can_auto_execute_read_only"] is True
+    assert package["summary"]["writes_database_count"] == 0
+    assert package["safety"]["writes_database"] is False
+    assert package["safety"]["persists_candidate"] is False
+
+
 def test_ai_automation_readiness_makes_automation_visible_without_manual_primary_flow():
     readiness = build_pchome_growth_ai_automation_readiness(_payload(), batch_size=1)
 
@@ -476,6 +529,43 @@ def test_ai_automation_readiness_reports_candidate_decisions_after_controlled_se
     assert call_count["search"] == 1
 
 
+def test_ai_automation_readiness_reports_exception_auto_resolution_ready():
+    def fake_search(targets, limit_per_product, max_products, max_terms_per_product, min_score):
+        return True, "found", [
+            {
+                "product_id": "MOMO-VARIANT",
+                "name": "Direct mapping product 40ml 多款任選",
+                "price": 899,
+                "target_pchome_product_id": "PCH-2",
+                "target_pchome_name": "Direct mapping product 40ml x2",
+                "target_match_score": 0.51,
+                "auto_compare_type": "manual_review",
+                "target_hard_veto": False,
+            }
+        ]
+
+    readiness = build_pchome_growth_ai_automation_readiness(
+        _payload(),
+        batch_size=1,
+        execute_search=True,
+        search_func=fake_search,
+    )
+
+    lanes = {lane["key"]: lane for lane in readiness["automation_lanes"]}
+    assert readiness["result"] == "AI_AUTOMATION_EXCEPTION_AUTO_RESOLUTION_READY"
+    assert readiness["summary"]["candidate_decision_count"] == 1
+    assert readiness["summary"]["machine_review_exception_receipt_count"] == 1
+    assert readiness["summary"]["exception_auto_resolution_artifact_count"] == 1
+    assert readiness["summary"]["variant_bundle_discriminator_count"] == 1
+    assert readiness["summary"]["named_candidate_evidence_delta_count"] == 1
+    assert readiness["ai_exception_auto_resolution"]["exception_auto_resolution_artifact_count"] == 1
+    assert lanes["candidate_exception_auto_resolution"]["status"] == "ready"
+    assert lanes["candidate_exception_auto_resolution"]["value"] == 1
+    assert readiness["summary"]["primary_human_gate_count"] == 0
+    assert readiness["summary"]["writes_database_count"] == 0
+    assert readiness["safety"]["writes_database"] is False
+
+
 def test_unit_package_basis_parser_extracts_quantity_count_and_risk_signals():
     single = parse_unit_package_basis("雅詩蘭黛 粉持久完美持妝粉底 30ml")
     assert single["package_basis"] == "single_unit_quantity_candidate"
@@ -14604,6 +14694,36 @@ def test_direct_mapping_candidate_decision_package_route_defaults_to_no_search_a
     assert payload["safety"]["writes_database"] is False
 
 
+def test_direct_mapping_candidate_exception_auto_resolution_route_uses_cached_payload(monkeypatch):
+    from flask import Flask
+    from routes import ai_routes as routes
+
+    monkeypatch.setattr(routes, "_get_cached_pchome_growth_payload", lambda: _payload())
+
+    def fail_engine(database_path):
+        raise AssertionError("cached exception auto-resolution package should not open a DB engine")
+
+    monkeypatch.setattr(routes, "_create_icaim_dashboard_engine", fail_engine)
+
+    app = Flask(__name__)
+    with app.test_request_context(
+        "/api/ai/pchome-growth/mapping-backlog/direct-mapping-candidate-exception-auto-resolution-package?batch_size=1"
+    ):
+        response = routes.api_pchome_growth_direct_mapping_candidate_exception_auto_resolution_package.__wrapped__()
+
+    payload = response.get_json()
+    assert payload["success"] is True
+    assert payload["policy"] == "read_only_pchome_growth_direct_mapping_candidate_exception_auto_resolution"
+    assert payload["source_endpoint"] == (
+        "/api/ai/pchome-growth/mapping-backlog/direct-mapping-candidate-decision-package"
+    )
+    assert payload["result"] == "WAITING_FOR_DIRECT_MAPPING_CANDIDATES"
+    assert payload["summary"]["exception_auto_resolution_artifact_count"] == 0
+    assert payload["auto_resolution_package"]["resolution_mode"] == "ai_controlled_read_only"
+    assert payload["safety"]["executes_search"] is False
+    assert payload["safety"]["writes_database"] is False
+
+
 def test_ai_automation_readiness_route_defaults_to_no_search_and_uses_cached_payload(monkeypatch):
     from flask import Flask
     from routes import ai_routes as routes