LINE 收件與審核流程

定位

Phase 4 將 LINE 官方帳號作為親友提供資料的入口。它負責接收、追問、回傳整理稿與記錄確認,但不直接修改人物、關係、事件等正式母資料。

本流程已於 2026-08-20 定為 Phase 4 v1.0 正式版。Phase 4A~4F 均已完成真實案件驗證;後續少數親友使用屬正式維運觀察,不再是上線阻塞項。

整套流程的中心是「投稿案件(case)」。案件不是一位人物,也不是一項事實;它是一次具有提供者、時間、對話脈絡與原始附件的長期資料處理歷程。一個案件可以同時涉及多人、多種關係、多個事件、地點、房屋、土地、照片、文件與口述內容。

長期流程

flowchart TD
    A[親友開始投稿] --> B[建立投稿案件]
    B --> C[接收文字、照片、語音、影片、檔案與網址]
    C --> D[投稿者表示本輪完成]
    D --> E[AI 轉錄並建立結構化草案]
    E --> F[透過 LINE 回傳原提供者確認]
    F --> G{提供者回覆}
    G -->|確認無誤| H[形成提供者確認版]
    G -->|需要修改| I[記錄修正意見]
    G -->|繼續補充| C
    I --> E
    H --> J[資料管理者最終審核]
    J -->|退回查證| F
    J -->|核准| K[寫入正式資料層]
    K --> L[程式驗證、編譯與發布]
    L --> R[回報原提供者:已上線、請過目]
    R --> M[保留來源鏈與全部版本]
    M --> Z[案件結案]
    Z -->|更正或日後新資料| N[以新投稿建立新案件或關聯子案件]
    N --> C

第一階段採人工放行

本系統是低流量的家族資料收集工具,不是公開投稿平台。第一階段不建立邀請碼、會員分級或複雜自動審查;親友傳訊後,由 LINE 官方帳號 App 依原生功能即時通知資料管理者,再由資料管理者於私人審核頁決定:

flowchart TD
    A[親友傳送文字或附件] --> B[LINE 官方帳號 App 通知資料管理者]
    A --> C[Cloudflare 暫存為待確認投稿]
    B --> D[資料管理者開啟私人審核頁]
    C --> D
    D --> E{人工判斷}
    E -->|接受| F[產生案件編號並保留原始資料]
    E -->|忽略| G[刪除暫存文字與附件]
    C -->|七日未處理| G
    F --> H[後續 AI 整理與提供者確認]
    H --> I[資料管理者最終核准]
    I --> J[寫入正式母資料]

同一位傳送者在管理者處理前連續傳送的資料,合併為同一筆待確認投稿。按下「接受」只會建立原始案件,不會自動修改人物、關係、事件或網站;按下「忽略」則保留最小的處理狀態,但移除訊息文字及 R2 附件。

回傳確認稿的操作順序與補救

正常順序是:先在私人案件頁儲存確認稿,按「標記已傳 LINE 請確認」,確認案件進入「等待提供者確認」,再到 LINE 官方帳號貼上確認稿。此後同一 LINE 使用者的回覆會自動進入原案件,並標記為「提供者確認回覆」。

若對方在管理者按下標記之前先回覆,鎖定中的案件不會擅自吸收訊息,而會另建一筆待處理投稿。原案件頁會列出同一 LINE 使用者的待處理投稿;管理者必須先查看內容、勾選確認,再選擇「合併為確認回覆」或「合併為案件補充」。系統不會自動猜測,也不允許合併不同 LINE 使用者的投稿。

LINE Webhook 簽章驗證、webhookEventId 去重及私人審核金鑰仍是必要的基本安全措施。這些措施不增加親友操作負擔,也不改變人工判斷的核心流程。

為何以案件為主體

案件只管理「這批資料是怎麼來的、如何被理解與確認」,不限制內容只能談一個人。它能完整保留下列問題的答案:

  • 誰傳來這批資料;實際提供者與原始口述者是否為同一人。
  • 哪些文字、照片、語音或文件屬於同一段說明。
  • AI 曾經如何轉錄及判讀,總共修訂了幾版。
  • 提供者確認的是哪一版、哪些部分,還有哪些保留意見。
  • 資料管理者最後核准了哪些內容,哪些仍待考。
  • 正式資料中的每一項事實可以回查到哪一則原始訊息或附件。

因此,案件是來源與工作流程的容器,不是家族知識本身的最小單位。

三層資料模型

flowchart LR
    CASE[投稿案件 Case] --> ITEM1[資料項目:一張多人合照]
    CASE --> ITEM2[資料項目:一段家族口述]
    CASE --> ITEM3[資料項目:一份土地文件]

    ITEM1 --> C1[主張:照片中有 P014]
    ITEM1 --> C2[主張:拍攝地為林邊]
    ITEM2 --> C3[主張:P020 是 P014 的母親]
    ITEM2 --> C4[主張:某人曾赴日本]
    ITEM3 --> C5[主張:某土地由祖先購置]

    C1 --> P1[人物]
    C2 --> L1[地點]
    C3 --> R1[關係]
    C4 --> E1[事件]
    C5 --> O1[物件/土地]

第一層:投稿案件 Case

保存一次投稿與審核的完整生命週期,例如 CASE-20260812-0001。案件可有一位主要投稿者及多位共同提供者,也可記錄「轉傳者」與「原始口述者」不同。

第二層:資料項目 Item

案件中的可管理單元,例如一張照片、一段語音、一份戶籍、一組相互關聯的敘事。資料項目可同時連結多位人物、多個事件與多個地點。

第三層:原子主張 Claim

從資料項目擷取出可單獨確認的陳述,例如:

  • P021 是 P014 的母親。
  • 照片拍攝於林邊。
  • 某人約於民國四十年間前往日本。
  • 某土地由某位祖先購置。

原子主張是送審、標示可信度、比對衝突及寫入正式資料的最小單位。Phase 4 的 Claim 屬於收件與審核層;它不等同於人物檔內已採用的出生日期候選寫法,也不要求每個正式事實永久維護成獨立檔案。

一案多人、多事、多物的處理

例如親友一次傳來一張合照、一段語音和一張土地謄本,內容涉及祖父母、三名子女、一次搬遷及一筆土地。這些資料可以留在同一案件,並拆成多個資料項目與原子主張:

層級例子
案件CASE-20260812-0001:某親友的一次家族資料投稿
資料項目合照、語音、土地謄本
關聯實體5 位人物、1 個家庭、2 個地點、1 筆土地、1 次搬遷
原子主張照片人物辨識、親子關係、拍攝時間、土地取得、搬遷日期
審核結果其中 6 項確認、2 項待考、1 項與戶籍資料衝突

案件與正式實體是多對多關係:一個案件可提到多人;同一人物也可在多年之間被許多不同案件補充。

何時需要拆案

預設尊重投稿者的連續敘事,不因為出現多人就拆案。只有下列情況才建立關聯子案件:

  1. 同一次聊天實際包含兩批完全無關的家族或主題。
  2. 其中一部分需要不同提供者、不同隱私或不同發布授權。
  3. 某一爭議需要長期獨立查證,不宜阻塞其他已確認資料。
  4. 案件過大,無法讓提供者清楚確認自己正在審哪一部分。

子案件必須保留 parent_case_id 或 related_case_ids,不能切斷與原始對話的來源鏈。

案件與版本狀態

狀態意義
collecting投稿者仍在傳送資料
awaiting_ai本輪完成,等待 AI 整理
ai_processing正在轉錄、辨識及建立草案
contributor_review已回傳提供者確認
needs_revision提供者指出錯誤或不足
supplementing提供者正在增加資料
contributor_confirmed提供者確認 AI 沒有誤解其說法
owner_review等待資料管理者判斷能否成為正式資料
approved已核准寫入正式資料層
integrated已寫入人物、關係、事件或來源母檔
published已完成驗證、編譯與發布
completed已回報原提供者並結案
disputed出現互相衝突且尚未解決的說法
archived暫不處理但永久保存

文件概念狀態與 Worker 實作值的對照。 Worker 目前實際可設定的階段只有七個:collecting、ai_ready、awaiting_contributor、contributor_confirmed、integrated、published、completed。上表的 awaiting_ai 在實作中即 ai_ready;ai_processing、contributor_review、needs_revision、supplementing、owner_review、approved、disputed、archived 目前只是概念狀態,尚未實作,不可當成可設定值使用。需要其中任何一個時,依語意化版本升版並提供 migration 與測試。

每次 AI 整理都新增版本,不覆蓋舊版;提供者的確認必須綁定確切的 case_id、revision_id 與待確認主張。舊版本、修正意見、補充內容與確認事件全部永久保留。

已知缺口:沒有中止狀態

Worker 的階段轉換是嚴格線性的,只允許沿成功路徑前進:

collecting → ai_ready → awaiting_contributor → contributor_confirmed → integrated → published → completed

(ai_ready 可退回 collecting;completed 為終點,不可再轉。)

因此已接受但不打算整合的案件(測試資料、誤接受、提供者撤回)沒有任何終止途徑。硬要結案就得連走多次假轉換,把 confirmation_sent_at、contributor_confirmed_at、integrated_at、published_at 寫成假時間戳,讓測試資料在稽核紀錄上看起來像走完真實流程。這是汙染來源鏈,不得為了清理佇列而這樣做。

目前處置:這類案件留在原階段,並在 HANDOFF.md 註明其性質,不偽造轉換。

未來修法:新增可由任一階段進入的終端狀態(建議 archived,並記錄 archived_reason),依語意化版本升版,附 migration 與 Worker 測試。低流量下不急,但每多一筆誤接受的案件,佇列的可讀性就再降一點。

兩道審核的意義

  1. 提供者確認:確認「AI 是否正確轉錄與理解我提供的內容」。這不是史實認證。
  2. 資料管理者核准:判斷「這項說法應如何進入正式資料、可信度為何、是否需要與其他史料並列或標為待考」。

提供者按下「確認無誤」後,案件只能進入 owner_review,不得自動修改人物母檔或發布網站。

建議目錄

00-原始資料/LINE收件/
├─ contributors/                 # 提供者身分與 LINE 對照;限制存取
└─ cases/
   └─ 2026/
      └─ CASE-20260812-0001/
         ├─ manifest.json        # 案件、參與者、狀態與關聯案件
         ├─ webhook/             # LINE 原始事件;不可改寫
         ├─ messages/            # 正規化訊息中介資料
         ├─ media/               # 原始照片、語音、影片與檔案
         ├─ items/               # 案件中的資料項目
         ├─ revisions/           # AI 白話整理稿與結構草案各版本
         ├─ confirmations/       # 提供者確認、修正與補充紀錄
         └─ owner-review/        # 管理者核准、退回與整合結果

LINE userId、姓名對照及聯絡資訊不得放入網站編譯輸出;網站若需要標示提供者,只引用穩定的 contributor_id 與經同意顯示的署名。

正式資料的來源鏈

正式人物、關係或事件採用案件內容時,必須保留回查資訊:

provenance:
  case_id: CASE-20260812-0001
  item_id: ITEM-003
  claim_id: CLAIM-011
  contributor_id: C000001
  revision_id: REV-003
  contributor_confirmation_id: CONF-002
  owner_review_id: REVIEW-001
  review_status: reviewed

日後若出現新說法,不覆蓋舊案件。建立新案件或新一輪補充,將新舊主張並列,再由資料管理者決定偏好值與考據說明。

Phase 4 實作順序

  • Phase 4A-1:確立以案件為來源與審核容器,允許一案關聯多人、多事、多物。
  • Phase 4A-2:確立「案件 → 資料項目 → 原子主張」三層模型及兩道審核。
  • Phase 4A-3:完成 Contributor、Case、Item、Claim、Revision、Confirmation、Review Schema、虛構範例與建置驗證。欄位說明見 LINE收件資料格式。
  • Phase 4B:LINE 與 Cloudflare 帳號、D1、R2、Worker 與加密秘密均已建立;有效 Channel access token 與 Channel secret 已更新,Worker 已切換為 pending-review;Webhook URL 已登記並通過 LINE 伺服器 Verify,Use webhook 已開啟,第一筆本人文字測試已成功進入待審核區。操作見 LINE官方帳號與Webhook設定。
  • Phase 4C:待確認投稿、文字收件、人工接受/忽略與七日清理均已部署;兩筆本人真實測試分別通過「忽略」與「接受」。忽略會清除內容、匿名化 userId 且不建立案件;接受會建立 CASE-LINE-*,並可下載不含 LINE userId 的 line-intake-case 1.0.0 JSON。管理頁已提供待確認/已接受/已忽略分頁,且接受不會自動修改正式族譜母資料。
  • Phase 4D:照片、語音、影片及檔案已完成真實端到端測試;同一提供者的四個附件與伴隨文字正確合併成一案,D1 索引、私人 R2 物件、審核頁預覽/下載及接受後 JSON 附件索引均一致。無管理金鑰讀取附件會回傳 403;網址仍視為純文字,不自動開啟或下載。
  • Phase 4E-lite:完成私人登入、案件進度、同案補充/確認回覆歸案、順序顛倒時的同一使用者人工合併、Drive 一鍵串流備份與逐檔索引、人工 LINE 回覆草稿與安全 R2 清理護欄;2026-08-20 已完成 OAuth 上線與第一件真實圖片案件的備份、讀回及防重測試。
  • Phase 4E 真實流程驗證:首件文字案件已完成 AI 整理、LINE 回傳、提供者確認、管理者核准、母資料整合、網站發布與資料管理者結案;後續圖片案件亦完成 Drive 備份、逐檔發布、網站整合、結案與 R2 清理。不同案件可依當次決策保留或在護欄通過後清理 R2。
  • 圖文選單與分批回覆:完成「開始提供資料/本次資料傳完/網站/說明」四格選單;Worker 只在每批開始與完成時回覆,中間安靜收件。重複開始、重複完成、空批完成、完成後新開一批及 Reply 失敗改用 Push 均已通過真人測試。
  • Phase 4F:管理者審核、正式資料整合提案、來源鏈、逐檔媒體同意與發布護欄均已由案件 7 完成驗證;人物、關係、來源及 Drive 媒體已進入正式母資料並通過發布檢查。
  • Phase 4G(正式維運觀察):以少數親友自然使用,持續記錄操作困難與例外案件。只有出現實際問題才提出新版設計;此項不是 Phase 4 v1.0 的未完成工作。

Google Drive 作為「已接受案件」的第二份備份、長期原件庫、AI 工作來源與人工瀏覽介面:每案保存 case.json、逐一可開啟的原始檔、AI 整理稿與確認紀錄,壓縮檔只能作附加封存,不能取代原始檔。2026-08-20 已以第一件含兩張圖片的正式案件完成線上驗證;管理頁的一鍵備份會建立案件資料夾、串流複製 R2 原件、核對位元組數、寫入 Drive file ID,最後重建含來源索引的案件 JSON。操作可重複執行,已核對檔案會跳過,中斷後可接續;目的資料夾若是公開分享狀態則拒絕執行。

備份成功不等於發布。案件資料夾、案件 JSON 與未選用原件保持私人;經提供者與資料管理者確認要上網的單一媒體檔,才另行開放「知道連結的任何人/檢視者」。正式 Markdown 以媒體 ID、案件 ID、Drive file ID、view_url 與 preview_url 建立直接連結,不公開整個案件資料夾。細節見 Google Drive媒體發布標準程序。

發布後回報提供者

發布不是案件的終點。提供者投入了資料,卻看不到結果,整個「資料 → 發現 → 驚喜 → 分享 → 更多資料」的循環會斷在這裡。因此內容實際上線後必須回報原提供者,確認無誤才結案。

回報同時是第三道品管:提供者確認只驗「AI 有沒有忠實轉錄我的說法」,資料管理者核准只驗內容判斷,而唯一能打開實際頁面說「這裡寫錯了」的人,是當事人自己。

什麼時候回報

  • 要回報:內容實際上線且可見時(新人物、新事實、新關係、新媒體)。一案一則。
  • 不回報:純內部狀態變更(integrated/published/completed 標記、R2 清理、建置或文件調整)。
  • 同一案件在補充多輪時,於最後一次上線後回報一次,不逐項發訊息。

回報內容必備四項

  1. 這次因為他而新增了什麼 — 逐項列出,讓他能逐項核對。
  2. 專屬連結 — 使用 ?person=Pxxx&setme=1(見《決策紀錄》的「從我開始」邀請連結),讓他打開就以自己為中心展開,而不是面對陌生的全家清單。
  3. ⚠️ 家族共用密碼 — 首頁沒有禮貌門,但人物頁與小世界頁都有。只給連結不給密碼,對方會直接卡在密碼畫面,回報就從驚喜變成挫折。
  4. 明確邀請更正 — 請他看過並直接指出錯誤;若有未取得的資訊(例如子女總數、長幼排行),一併補問。

回報後

  • 回報送出後即可標記 completed 結案,不需保留案件等待回覆。
  • 原因是系統機制:Worker 只在案件處於 collecting 或 awaiting_contributor 時才把新訊息歸入原案件。案件到了 published 或 completed,對方的回覆一律另建新的待確認投稿。因此「保留案件等待更正」沒有對應機制,只會讓案件長期卡在中間狀態。
  • 對方日後的更正或補充,以新投稿進入,依新一輪流程處理;原案件不改寫、不覆蓋,於新案件保留 related_case_ids 回指。
  • 回報草稿與實際送出內容存於私人案件目錄(private/line-cases/*-notify.txt),作為已回報的紀錄;本階段不新增案件狀態欄位。

降低重複驗證與 AI token 的作法

平常案件不再重跑首次上線時的完整黑箱驗證。只要 Worker、D1 migration、R2 或 LINE 設定沒有改動,就採下列短流程:

  1. 以案件 JSON 和本輪新增附件為唯一輸入,不重新閱讀全部歷史對話。
  2. AI 一次產出「事實草案、待確認問題、LINE 回覆稿、預計修改檔案」四項結果。
  3. 提供者確認後,資料管理者只需說「核准寫入」;AI 依既定範圍修改母資料。
  4. 執行 npm.cmd run verify:fast,一次檢查收件 Schema、LINE Worker 測試、人物與關係建置。
  5. 發布前執行 npm.cmd run verify:release,一次跑完整測試與正式網站建置。
  6. 發布成功後回報原提供者(規則見「發布後回報提供者」一節),確認無誤再結案。
  7. 只有 Worker/migration/雲端綁定有變更時,才加做 Wrangler dry-run、Cloudflare 部署與線上健康檢查。
  8. 已接受且有附件的案件,在交給 AI 前按「一鍵備份並核對 Google Drive」;首次上線另做一次 Drive 下載回復測試,日後平常案件只需確認頁面顯示備份成功。

這把「首次基礎設施驗證」和「日常資料案件」拆開。日常案件的證據仍完整保留,但不需要每次重查帳號、Webhook、D1、R2 及 GitHub Pages 基礎設施。