Item Master 文件索引

日期：2026-03-20

依角色閱讀

一般人 / 第一次接觸

1. C16-architecture.md
   • 先看多視角架構圖：一般人版、老闆版、工程版、治理與環境。
2. C15-onepage.md
   • 看這件事的價值與核心故事。
3. C01-eli5.md
   • 用白話補足概念理解。
4. R02-terms.md
   • 先把 BI / SI、學名 / 俗名 / alias 對齊。

管理層 / 產品 / RD

1. C16-architecture.md
   • 看不同受眾版本的架構圖與例子。
2. C15-onepage.md
   • 看商業價值與管理觀念。
3. C02-spec.md
   • 看核心設計決策。
4. C04-migration.md
   • 看導入與切換路徑。

工程 / 數據 / 架構

1. C16-architecture.md
   • 先看總體架構、決策流、治理與環境邊界。
2. C02-spec.md
   • 看正式規格。
3. C03-schema.sql
   • 看資料表骨架。
4. C05-review.md
   • 看 review、打分、分級與狀態機。
5. C09-import.md
   • 看來源匯入與證據層。
6. C12-dbx.md
   • 看 Databricks、job DAG、發布規則。
7. C06-id.md
   • 看 BI / SI 編碼規則。

審核 / 營運

1. C16-architecture.md
   • 先看白話與治理權限版本。
2. R02-terms.md
   • 對齊詞彙。
3. C05-review.md
   • 看審核流程與決策。
4. C10-cases.md
   • 看常見判例。
5. Q01-channel-qc.md
   • 看通路資料品質風險。
6. Q02-barcode-inventory.md
   • 看條碼覆蓋與盤點結果。

完整閱讀順序

1. C16-architecture.md
   • 先看多視角架構圖：一般人版、老闆版、工程版、治理與環境。
2. C15-onepage.md
   • 高層一頁版，先看整體價值與核心故事。
3. C01-eli5.md
   • 先用白話建立整體概念。
4. R02-terms.md
   • 先把名詞對齊。
5. C02-spec.md
   • 看正式規格與核心設計決策。
6. C03-schema.sql
   • 看資料表骨架。
7. C06-id.md
   • 看 BI / SI 編碼規則。
8. C07-cat.md
   • 看既有 c0~c2 與品牌系統怎麼接到 item master。
9. C05-review.md
   • 看審核流程、候選打分、金銀銅分級與 API。
10. C09-import.md

• 看各來源怎麼匯入證據層。

11. C10-cases.md
    • 看常見判例與審核者操作手冊。
12. C12-dbx.md
    • 看 Databricks 的架構、表、品質規則與 job 切法。
13. C04-migration.md
    • 看導入與切換計畫。
14. Q01-channel-qc.md
    • 看 channel_master 品質複檢。
15. Q02-barcode-inventory.md
    • 看條碼數量與分布盤點。
16. R01-barcode.md
    • 看條碼格式與驗證規則。

文件角色

主線文件

• C01：白話說明
• C02：正式規格
• C03：資料表骨架
• C04：遷移計畫
• C05：審核、打分與分級規格
• C06：識別碼規則
• C07：分類與品牌整合
• C09：來源匯入規格
• C10：判例手冊
• C12：Databricks 導入與運作規格
• C15：高層一頁版
• C16：架構圖

參考文件

• R01：條碼驗證參考
• R02：名詞表
• R03：Barcode-PN 對內說帖

檢核文件

• Q01：channel_master 品質複檢
• Q02：channel_master 條碼數量盤點

歷史文件

• H01：較早期的整合設計報告，保留脈絡，不當作主規格使用
• C08：已被 C05 吸收
• C11：已被 C05 吸收
• C13：已被 C12 吸收
• C14：已被 C12 吸收

閱讀提醒

• BI / SI 管身份。
• 學名 / 俗名 / alias 管叫法，不是身份。
• category 與 brand 管分類、搜尋與提示，不是身份主鍵。
• channel_master 是候選池與證據池，不是最終主檔。
• 主要審核單位是 invoice_name_cluster -> SI。

維護原則

• 同一主題只維護一份主線文件。
• 有新文件或角色變更時，先更新本索引。
• 舊文件若已被主線吸收，改放歷史區，不再平行維護。