LINE 收件資料格式
定位
這份格式服務於 LINE收件與審核流程。LINE 已完成文字及圖片真實案件的收件、Drive 備份、AI 整理、提供者確認、資料管理者核准、母資料寫入、網站發布與結案清理驗證;現行採 Schema 1.0.0 正式版。
正式版代表它是後續案件沿用的穩定基準,不代表永久凍結。新增相容欄位可升 minor,破壞相容性的欄位或狀態變更須升 major;所有結構變更都必須附 migration、測試、決策與變更紀錄,不得只修改單一 JSON 或介面。
資料分為三層:
| 層級 | 保存內容 | 是否直接進網站 |
|---|---|---|
| 原始輸入層 | LINE 文字、語音、照片、影片、文件、網址與原始回覆 | 否 |
| 收件知識層 | 案件、項目、主張、修訂、確認、審核 | 否 |
| 正式母資料層 | 人物、關係、事件、戶、地點、來源等 Markdown | 通過建置後才會 |
為什麼仍以「案件」為主體
案件是一次有前後脈絡、可以回傳確認的投稿歷程,不是單一人物的資料夾。它可以同時包含:
- 多位資料提供者與被提及人物;
- 一張多人照片、一段口述、一份土地文件;
- 親屬關係、搬遷事件、地點、房屋土地與其他物件;
- 尚未確認、互相衝突或需要日後追查的說法。
因此,案件負責保存「這次怎麼收到、怎麼問、怎麼改」;其中的 Item 與 Claim 才負責把複雜內容拆開。日後同一主張可以分別整合到人物、關係、事件、地點或來源節點,不會被困在某一個人的頁面裡。
七類紀錄
| 實體 | 用途 |
|---|---|
| Contributor | 記錄是誰提供、身分是否確認、授權偏好;LINE 帳號只存保護參照或雜湊 |
| Case | 一次投稿與往返確認的容器,可關聯多人與多種資料 |
| Item | 案內的一張照片、一段語音、一份文件、一個網址等 |
| Claim | 一句可以單獨確認、否決或保留疑問的事實主張 |
| Revision | AI 整理後回傳給提供者的某一版本 |
| Confirmation | 提供者對該版本與各 Claim 的確認、更正或補充 |
| Review | 資料管理者決定採納、附條件採納、暫緩、爭議或拒絕 |
兩道審核不能混在一起
提供者確認的是:「AI 是否忠實理解我所說的內容?」
資料管理者審核的是:「這項內容是否有足夠證據、應如何標示可信度、是否可以整合進正式資料?」
提供者說「確認」不等於史實已被證明;若文件、其他族人口述或既有資料有衝突,仍應保留來源與異議。
修正不覆蓋歷史
若 AI 第一版把照片右側人物辨識錯誤,提供者回覆更正後:
- 第一版 Revision 保留並標為已取代;
- 錯誤 Claim 保留並標為 rejected;
- 正確說法建立新的 Claim ID;
- 第二版 Revision 引用新 Claim,再回傳確認。
如此才看得到錯誤是如何被發現及修正,也不會把歷史紀錄改得像從未犯錯。
試行與版本調整
現行 Schema 版本是 1.0.0。後續實際案件若需要新欄位,先記在 extensions;觀察數批案件後,再決定是否正式納入。
- 相容新增:升級
1.x。 - 欄位刪除、改名或語意改變:升級
2.0.0並提供轉換程式。 - 已存在的 ID 永不重用。
- 每次建置先跑 Schema 與跨檔關聯驗證;重大錯誤會阻止網站建置。
程式規格與虛構範例位於 data/intake/。範例不是真實家族資料,也不會出現在公開網站的人物內容中。