決策紀錄

本頁保存不應隨施工狀態改變的決策。會過期的進度與待辦只寫在 repo 根目錄的 HANDOFF.md。

資料與網站

  1. Markdown 是母資料,JSON 是建置產物。 每個人物是一個永久 ID、一個 Markdown 節點與一個網站頁面。JSON、人物卡、小世界、直式世系與未來匯出格式都由母資料重建。
  2. 使用圖的思維,不綁定圖資料庫產品。 現階段數百至數千人物可由瀏覽器處理鄰接圖、最短路徑與共同祖先;資料規模真正增加後再量測與分片。
  3. 事件是獨立節點。 婚姻入戶、遷徙、分戶等帶日期、多人、戶與地點的事實只保存在事件,不把同一日期重複寫進配偶關係。
  4. 關係只保存一份。 父母寫在子女端;配偶、收養等需要自身 metadata 的關係使用獨立節點;反向清單由建置程式產生。
  5. ID 永不改號、永不重用。 姓名、房別、世代、婚姻與檔名顯示變更都不能改變永久 ID。
  6. 出生與死亡異載使用人物檔內的 inline claims。 不建立獨立 claim 檔;每筆仍保有局部 claim_id、來源、偏好與校閱狀態。

親友版與搜尋曝光

  1. GitHub Pages 維持「完整資料+JavaScript 禮貌門」,不建帳號登入,也不切換成只剩少數人物的公開遮罩版。
  2. 禮貌門只能避免訪客不小心進入,不是加密、身分驗證或真正的隱私隔離;文件與介面不得誇大其能力。
  3. 主要目標是降低搜尋引擎收錄:所有 HTML 使用 noindex, nofollow,並關閉 sitemap 與 RSS。
  4. PDF、JPG、TXT、CSV、MD、日治戶籍原文、考據、事件、備註與衍生欄位維持完整,不因摘要顯示規則改寫或移除。
  5. 人物一覽、小世界與世系圖等摘要畫面可對明確在世者顯示「生辰資料不公開」;人物內頁仍可查閱完整史料。
  6. possibly_living 由摘要顯示規則再判斷:有出生年且未滿 95 歲時可顯示「出生年—在世」及現年;已達 95 歲以上或有歷史平輩證據者顯示卒年未註記,不推算不合理的現年或冥壽。小世界節點已有「出生年—在世」時,底部只列現年,不再重複列一行「仍在世」。
  7. 隱藏與未詳必須區分,避免族人誤以為資料遺失而重複投稿。

建置模式

  • build:family:完整親友版;build:site 是部署入口並呼叫此模式。
  • build:public:公開遮罩版,僅在人工明確要求時使用。
  • build:redacted:保留的相容別名,等同 build:public。
  • build:dev:本機開發完整版。

LINE 收件

親族只接觸 LINE、表單、照片與其他原始輸入;結構資料由管理者與 AI 整理,再回傳提供者確認。確認前不正式寫入網站,確認與核准後才進母資料、驗證、發布與結案。

Phase 4 v1.0 正式基準

  • 2026-08-20 將已通過文字案件與圖片案件真實閉環驗證的 Phase 4A~4F 定為正式版 v1.0。
  • 標準生命週期固定為:LINE 收件 → 人工接受 → Google Drive 私人備份 → AI 整理 → 提供者確認 → 資料管理者核准 → Markdown 母資料 → 驗證與 GitHub Pages 發布 → 回報原提供者 → 案件結案 → R2 清理。
  • D1 保存案件狀態與索引;R2 只作 LINE 媒體暫存;Google Drive 保存長期原件;Markdown 是正式知識母資料;GitHub Pages 是可重建呈現層。各層不得互相取代。
  • 管理者按「接受」只建立案件;提供者確認只表示整理內容忠實;只有資料管理者核准後,AI 才能寫入母資料。
  • Phase 4G 改列正式版後的低流量維運觀察,不是 v1.0 發布的阻塞項。
  • 正式版允許持續補資料與修正錯誤。若變更 Schema、案件狀態、儲存責任或發布護欄,須依語意化版本升版,提供 migration 與測試,並同步更新本頁、操作文件及《變更紀錄》。

發布後回報提供者

  • 2026-09-12 補入生命週期:內容實際上線後必須回報原提供者,確認無誤才結案。此前流程止於發布與結案,提供者看不到成果,核心參與循環斷裂。
  • 回報也是第三道品管:提供者確認只驗轉錄忠實度,管理者核准只驗內容判斷;唯一能打開實際頁面指出錯誤的是當事人。
  • 只在內容實際上線可見時回報(新人物、新事實、新關係、新媒體),一案一則;純內部狀態變更與 R2 清理不回報。
  • 回報送出後即可結案,不保留案件等待回覆。 Worker 只在 collecting/awaiting_contributor 歸案,published/completed 的回覆一律另建新投稿;保留開啟沒有對應機制,只會製造長期卡住的案件。更正與補充走新一輪,以 related_case_ids 回指原案件。
  • 回報必附家族共用密碼:首頁無禮貌門,但人物頁與小世界頁有;只給連結不給密碼會讓對方卡在密碼畫面。
  • 回報使用 ?person=Pxxx&setme=1 專屬連結,讓對方以自己為中心展開。
  • 不新增案件狀態欄位。 completed 的語意明確定義為「已回報提供者並結案」;回報紀錄以私人案件目錄的回報草稿檔為憑。低流量家族工具不值得為此增加 migration、Worker 驗證與測試負擔;若日後實際發生漏報,再評估是否新增 contributor_notified 狀態。

「從我開始」邀請連結

  • 一般 ?person=Pxxx 只把該人物置中,不推定訪客身分。
  • 管理者確認對方身分後,可傳送 ?person=Pxxx&setme=1;若該瀏覽器尚未設定「我」,網站會自動保存該人物。完成判斷後網址列會移除 setme,避免轉傳時誤設他人。
  • 已有「我」設定時,邀請連結不得覆蓋;使用者仍可在畫面上主動按「設為我」變更。
  • 設定只存在該瀏覽器的 localStorage,不寫入人物母檔,也不跨裝置同步。

Google Drive 原件備份

  • 2026-08-20 已完成 D1/R2 到 Google Drive 的一鍵私人備份、大小核對、中斷續作、防重及真實圖片讀回驗證。這是「接受案件後由管理者按一次」的人工觸發流程,不是無人監督的全自動發布。
  • 2026-08-20 依資料持有人決定,第一版網站媒體不另建 CDN 或網站專用 R2,改為 GitHub Pages 直接引用 Google Drive。案件資料夾、未選用原件與案件 JSON 保持私人;只有經確認要在網站顯示的單一媒體檔,才開放為「知道連結的任何人/檢視者」。
  • Drive 備份完成不等於資料已核准或網站已發布。網站已發布且案件結案後,才可在私人審核頁人工輸入「清理 R2」,刪除 Cloudflare 暫存原件。

延後事項

  • 空白架構模板:日後另案處理,必須從白名單建立全新、無私人 Git 歷史的 repo,不得直接清空現有 repo 後公開。