148 lines
5.1 KiB
Python
148 lines
5.1 KiB
Python
"""市場情報商品比對審核 preview。
|
|
|
|
只定義比對訊號、分數門檻與人工覆核流程；不查 DB、不寫 DB、不呼叫 MCP。
|
|
"""
|
|
|
|
|
|
MATCH_SCORING_SIGNALS = (
|
|
{
|
|
"key": "platform_product_id_or_i_code",
|
|
"label": "平台商品 ID / MOMO i_code 精準命中",
|
|
"weight": 0.35,
|
|
"source": "market_campaign_products + products",
|
|
},
|
|
{
|
|
"key": "brand_and_series",
|
|
"label": "品牌、系列與型號 token 一致",
|
|
"weight": 0.24,
|
|
"source": "normalized product name",
|
|
},
|
|
{
|
|
"key": "spec_token_overlap",
|
|
"label": "容量、入數、尺寸、顏色等規格 token overlap",
|
|
"weight": 0.22,
|
|
"source": "ProductNameParser / parser diagnostics",
|
|
},
|
|
{
|
|
"key": "price_band_reasonable",
|
|
"label": "跨平台價格落在合理區間，避免不同規格誤配",
|
|
"weight": 0.12,
|
|
"source": "price history / competitor price cache",
|
|
},
|
|
{
|
|
"key": "image_or_url_hint",
|
|
"label": "圖片網址、活動 URL 或來源頁提示",
|
|
"weight": 0.07,
|
|
"source": "campaign product metadata",
|
|
},
|
|
)
|
|
|
|
|
|
MATCH_THRESHOLDS = {
|
|
"auto_match_candidate_min": 0.88,
|
|
"needs_review_min": 0.62,
|
|
"reject_suggestion_below": 0.38,
|
|
"auto_confirm_enabled": False,
|
|
}
|
|
|
|
|
|
def build_match_review_plan_preview(
|
|
*,
|
|
runtime_status,
|
|
mcp_tool_contract,
|
|
legacy_source_bridge,
|
|
schema_smoke,
|
|
):
|
|
"""建立商品比對審核計畫；不產生 match rows、不自動確認。"""
|
|
schema_passed = bool(
|
|
schema_smoke.get("passed")
|
|
or (schema_smoke.get("schema_smoke") or {}).get("passed")
|
|
)
|
|
contract_tools = mcp_tool_contract.get("tools") or []
|
|
match_lookup_ready = any(
|
|
item.get("name") == "market_product_match_lookup"
|
|
and item.get("read_only")
|
|
and item.get("router_tools_whitelisted")
|
|
for item in contract_tools
|
|
)
|
|
legacy_bridge_safe = (
|
|
legacy_source_bridge.get("mode") == "legacy_source_bridge_planned"
|
|
and not legacy_source_bridge.get("read_only_query_executed")
|
|
and not legacy_source_bridge.get("database_write_executed")
|
|
)
|
|
gate_checks = {
|
|
"schema_smoke_passed": schema_passed,
|
|
"market_product_matches_table_planned": "market_product_matches"
|
|
in (schema_smoke.get("expected_tables") or []),
|
|
"mcp_match_lookup_contract_ready": match_lookup_ready,
|
|
"legacy_bridge_planned_safe": legacy_bridge_safe,
|
|
"database_write_still_blocked": not bool(
|
|
runtime_status.database_write_allowed
|
|
),
|
|
"scheduler_detached": not bool(runtime_status.scheduler_attached),
|
|
"auto_confirm_disabled": not MATCH_THRESHOLDS["auto_confirm_enabled"],
|
|
"manual_operator_approval": False,
|
|
}
|
|
blocked_reasons = [
|
|
key for key, passed in gate_checks.items()
|
|
if not passed
|
|
]
|
|
|
|
return {
|
|
"mode": "match_review_plan_preview",
|
|
"ready_for_review_queue": False,
|
|
"review_queue_created": False,
|
|
"auto_match_executed": False,
|
|
"auto_confirm_executed": False,
|
|
"database_session_created": False,
|
|
"database_write_executed": False,
|
|
"database_commit_executed": False,
|
|
"external_network_executed": False,
|
|
"scheduler_attached": False,
|
|
"writes_executed": False,
|
|
"would_write_database": False,
|
|
"thresholds": MATCH_THRESHOLDS,
|
|
"scoring_signals": list(MATCH_SCORING_SIGNALS),
|
|
"planned_status_flow": [
|
|
"needs_review",
|
|
"confirmed",
|
|
"rejected",
|
|
],
|
|
"gate_checks": gate_checks,
|
|
"blocked_reasons": blocked_reasons,
|
|
"review_actions": [
|
|
{
|
|
"key": "confirm_match",
|
|
"label": "人工確認競品商品與 MOMO 商品為同款或等效規格",
|
|
"writes_database": True,
|
|
"requires_operator": True,
|
|
},
|
|
{
|
|
"key": "reject_match",
|
|
"label": "人工拒絕誤配候選，保留 reason 供規則調整",
|
|
"writes_database": True,
|
|
"requires_operator": True,
|
|
},
|
|
{
|
|
"key": "merge_duplicate_candidate",
|
|
"label": "合併同一競品商品的重複候選",
|
|
"writes_database": True,
|
|
"requires_operator": True,
|
|
},
|
|
],
|
|
"operator_sequence": [
|
|
"先完成 market_* schema 與 seed 寫入",
|
|
"以 read-only bridge 盤點 PChome / MOMO 舊資料來源",
|
|
"用 market_product_match_lookup 只讀查詢候選，不直接建立 match rows",
|
|
"人工審核 needs_review queue 後才允許 confirmed / rejected 寫入",
|
|
"任何 auto_match 只能產生候選分數，不得自動 confirmed",
|
|
],
|
|
"safe_boundaries": [
|
|
"do_not_auto_confirm_matches",
|
|
"do_not_write_match_rows_from_preview",
|
|
"do_not_call_external_mcp_from_preview",
|
|
"do_not_attach_scheduler_for_match_review",
|
|
"do_not_use_price_only_as_match_reason",
|
|
],
|
|
}
|