補齊 PChome retry 例外解法收斂包

tests/test_pchome_mapping_backlog_report.py

@@ -76,6 +76,7 @@ from services.pchome_mapping_backlog_service import (
     build_pchome_direct_mapping_candidate_exception_resolution_closeout_package,
     build_pchome_direct_mapping_retry_candidate_decision_package,
     build_pchome_direct_mapping_retry_candidate_exception_auto_resolution_package,
+    build_pchome_direct_mapping_retry_candidate_exception_resolution_closeout_package,
     build_pchome_growth_ai_automation_readiness,
     build_pchome_mapping_operator_preview,
     parse_pchome_product_page_evidence_html,
@@ -663,6 +664,74 @@ def test_direct_mapping_retry_candidate_exception_auto_resolution_package_builds
     assert call_count["search"] == 2
 
 
+def test_direct_mapping_retry_candidate_exception_resolution_closeout_package_builds_receipts():
+    call_count = {"search": 0}
+
+    def fake_search(targets, limit_per_product, max_products, max_terms_per_product, min_score):
+        call_count["search"] += 1
+        if targets[0].get("source_artifact_id"):
+            return True, "retry_found", [
+                {
+                    "product_id": "MOMO-RETRY-REVIEW",
+                    "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.74,
+                    "auto_compare_type": "manual_review",
+                    "target_hard_veto": False,
+                },
+                {
+                    "product_id": "MOMO-RETRY-VETO",
+                    "name": "Direct mapping product 40ml 單入",
+                    "price": 520,
+                    "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,
+                },
+            ]
+        return True, "found", [
+            {
+                "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_retry_candidate_exception_resolution_closeout_package(
+        _payload(),
+        batch_size=1,
+        execute_search=True,
+        execute_retry_search=True,
+        max_terms_per_product=6,
+        search_func=fake_search,
+    )
+
+    receipts = package["retry_exception_resolution_closeout_package"]["closeout_receipts"]
+    assert package["policy"] == "read_only_pchome_growth_direct_mapping_retry_candidate_exception_resolution_closeout"
+    assert package["result"] == "DIRECT_MAPPING_RETRY_CANDIDATE_EXCEPTION_RESOLUTION_CLOSEOUT_READY"
+    assert package["summary"]["retry_exception_auto_resolution_artifact_count"] == 2
+    assert package["summary"]["retry_exception_resolution_closeout_receipt_count"] == 2
+    assert package["summary"]["exception_resolution_closeout_receipt_count"] == 2
+    assert package["summary"]["evidence_delta_closeout_count"] == 1
+    assert package["summary"]["retry_search_ready_count"] == 1
+    assert package["summary"]["retry_search_executed_count"] == 1
+    assert package["summary"]["retry_candidate_count"] == 2
+    assert receipts[0]["resolution_status"] == "AUTO_RESOLUTION_CLOSEOUT_READY"
+    assert receipts[0]["guardrails"]["writes_database"] is False
+    assert package["retry_exception_resolution_closeout_package"]["resolution_mode"] == "ai_controlled_read_only"
+    assert package["safety"]["executes_retry_search"] is True
+    assert package["safety"]["writes_database"] is False
+    assert call_count["search"] == 3
+
+
 def test_ai_automation_readiness_makes_automation_visible_without_manual_primary_flow():
     readiness = build_pchome_growth_ai_automation_readiness(_payload(), batch_size=1)
 
@@ -15023,6 +15092,37 @@ def test_direct_mapping_retry_candidate_exception_auto_resolution_route_uses_cac
     assert payload["safety"]["writes_database"] is False
 
 
+def test_direct_mapping_retry_candidate_exception_resolution_closeout_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 retry candidate exception resolution closeout 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-retry-candidate-exception-resolution-closeout-package?batch_size=1"
+    ):
+        response = routes.api_pchome_growth_direct_mapping_retry_candidate_exception_resolution_closeout_package.__wrapped__()
+
+    payload = response.get_json()
+    assert payload["success"] is True
+    assert payload["policy"] == "read_only_pchome_growth_direct_mapping_retry_candidate_exception_resolution_closeout"
+    assert payload["source_endpoint"] == (
+        "/api/ai/pchome-growth/mapping-backlog/direct-mapping-retry-candidate-exception-auto-resolution-package"
+    )
+    assert payload["result"] == "WAITING_FOR_RETRY_CANDIDATE_EXCEPTIONS"
+    assert payload["summary"]["retry_exception_resolution_closeout_receipt_count"] == 0
+    assert payload["retry_exception_resolution_closeout_package"]["resolution_mode"] == "ai_controlled_read_only"
+    assert payload["safety"]["executes_search"] is False
+    assert payload["safety"]["executes_retry_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