名詞表

日期：2026-03-20 目的：統一 item master 常用詞，降低討論時的語意混亂。相關文件：

1. 身份相關

名詞	定義	容易混淆的對象
`BI`	商品家族代碼，例如 `BI-7K4M2P`	barcode、分類、品牌
`SI`	可售版本代碼，例如 `SI-7K4M2P-U001`	通路 SKU、listing id
商品家族	一個核心商品，不含買法差異	可售版本
可售版本	消費者實際買到的版本	通路頁面
家族碼	`BI / SI` 中間那段穩定短碼	名稱縮寫、條碼

2. 版本層級相關

名詞	定義	容易混淆的對象
`unit`	單品	`bundle`、`carton`
`bundle`	組合包、超值組、加贈組	大容量單品
`carton`	箱購、整箱	`bundle`
`item_level`	`unit / bundle / carton` 三種可售層級	分類
`package_form`	包裝型式，例如罐、瓶、補充包	`item_level`
`net_content`	淨含量，例如 `330ml`、`110g`	入數
`pack_qty`	入數，例如 `6入`、`24入`	淨含量

3. 名稱相關

先分清楚兩層：

BI / SI 是身份層，回答「這個東西是誰」。
學名 / 俗名 / alias 是命名層，回答「大家怎麼叫這個東西」。
同一個 SI 可以同時有學名、俗名、通路名、發票名，但仍是同一個身份。
名稱很重要，因為它影響候選生成與人工判讀；但名稱本身不是身份代碼。

名詞	定義	容易混淆的對象
`raw_pn`	原始發票品名	學名
`invoice_name_cluster`	同商家或同上下文下聚成一群的發票名稱	`SI`
學名	item master 裡較正式、較穩定的名稱，通常落在 `canonical_name` 或 `sellable_name`	原始發票名、俗名、身份代碼
俗名	別名、通路名、常見縮寫、口語名，不要求是正式欄位值	學名、身份代碼
`alias`	學名以外的可接受名稱，通常收在 `item_aliases`	身份代碼

補充判讀原則：

「白蘭氏雞精 6 入組」可以是某個 SI 的學名。
「雞精禮盒」、「雞精 6 瓶」、「白蘭氏 6 入」可以是同一個 SI 的俗名或 alias。
若只是名稱不同，但包裝層級、容量、入數與核心商品沒有變，不應因名稱不同就新開 BI / SI。
是否要新開 BI / SI，應由身份差異決定；不是由叫法差異決定。

4. 分類與品牌相關

名詞	定義	容易混淆的對象
`brand`	品牌，例如 `Coca-Cola`、`品客`	`BI`
`series`	品牌線或系列，例如 `Coke`	品牌、本體
`category`	品類或目錄位置	身份
`c0 / c1 / c2`	既有分類樹層級	`item_level`
`主分類`	商品主要被放置的分類	身份
`次分類`	額外分類	身份

5. 來源與上下文相關

名詞	定義	容易混淆的對象
`merchant`	商家，例如 `PXMART`、`MOMO`	品牌
`channel`	通路或來源，例如某網站或某資料源	商家總部
`store`	具體店點	商家總部
`store_tax_id`	店點統編	商家代碼
`source_type`	證據來源類型，例如發票、通路、crowd	商品類型
`source_record_id`	原始來源記錄識別碼	`BI / SI`

6. 證據相關

名詞	定義	容易混淆的對象
證據	支持或反對某候選的觀測資料	真值
支持證據	支持某候選的證據	最終決策
衝突證據	與某候選相衝突的證據	最終決策
`risk_flag`	風險標記，例如風險 prefix 或組合包污染	直接否決
候選	某個 cluster 目前可能對到的商品	已確認結果
`mapping_decision`	最終審核後的 `cluster -> SI` 決定	候選
`mapping_tier`	`cluster -> SI` 這條對應的成熟度分級	`item_tier`

7. 分級相關

名詞	定義	容易混淆的對象
`item_tier`	商品本身的成熟度分級，例如銅級、銀級、金級	`mapping_tier`
`mapping_tier`	發票名稱群組對商品的對應成熟度分級	`item_tier`
銅級	剛建立、證據弱或仍待審的狀態	可直接發布
銀級	已有多種證據支持或至少一次人工確認	金級
金級	證據穩定、衝突低、可正式供下游使用	只是分數高但未審核

8. 時間相關

名詞	定義	容易混淆的對象
`invoice_date`	實際購買日期	`observed_at`
`observed_at`	證據被收集到的時間	`invoice_date`
`valid_from / valid_to`	證據或關聯有效的時間區間	建檔時間

9. 一句話收尾

先把 BI / SI 與 學名 / 俗名 / alias、品牌與分類、商家與通路、證據與決策分開，團隊大部分的誤解就會消失。

↑