External Data Model / 對外最小資料模型

Core Principle / 核心原則

Minimum Entities / 最小實體

Entity 中文 Role / 角色
resolution_case 對應案件 一次需要判定的最小審核單位。 / The smallest review unit that needs a resolution decision.
pn_observation PN 觀測 來自客戶或歷史資料的 PN 原始輸入。 / Raw PN input from the customer or historical records.
barcode_observation barcode 觀測 來自掃碼、圖片、或既有資料的 barcode 輸入。 / Barcode input from scanning, images, or existing records.
candidate_item 候選商品 系統提出的候選可售版本。 / Candidate sellable item proposed by the system.
mapping_candidate 候選對應 某案件對某候選商品的評分與理由。 / Scored relationship between a case and a candidate item.
mapping_decision 對應決策 最終確認、駁回、待補證據或新建商品。 / Final confirm, reject, needs-more-evidence, or create-new-item decision.
review_task 審核任務 進人工或眾包時的工作單位。 / Review work item for human or crowd review.
Field 中文 說明
client_case_id 客戶案件 ID 客戶側唯一追蹤鍵。 / Customer-side tracking key.
client_pn 客戶 PN 客戶提交的原始或標準化 PN。 / Raw or normalized PN submitted by the customer.
confirmed_item_name 確認商品名 系統最終確認的商品名稱。 / Final confirmed item name.
confirmed_barcode 確認條碼 若有足夠證據才輸出。 / Output only when evidence is sufficient.
match_status 對應狀態 confirmed / under_review / rejected / needs_more_evidence
confidence_band 信心分級 high / medium / low
reviewed_at 審核時間 最後決策時間。 / Final decision timestamp.
provenance_class 證據類別 只輸出抽象分類,不暴露來源細節。 / Abstract evidence class only; no source detail.
risk_flags 風險旗標 例如 bundle_riskisbn_prefixstore_internal_code

Provenance Classes / 對外證據類別

Anti-Pattern / 不建議做法