變更紀錄

2026-09-12:回報後即結案、狀態值對照與中止狀態缺口

  • 回報後處置修正:改為「回報送出後即可結案」。原寫法「確認無誤或未再回覆才結案」隱含一個等待狀態,但 Worker 只在 collecting/awaiting_contributor 把新訊息歸入原案件;published/completed 的回覆一律另建新投稿。保留案件等待更正沒有對應機制,只會製造長期卡住的案件。更正與補充走新一輪,以 related_case_ids 回指。
  • 流程圖同步移除「回報 → 回到修正意見」這條實際不存在的邊,改為結案後由新投稿建立新案件。
  • 狀態值對照:文件狀態表新增說明,明確區分 Worker 實際可設定的七個階段(collecting、ai_ready、awaiting_contributor、contributor_confirmed、integrated、published、completed)與尚未實作的概念狀態;表中 awaiting_ai 在實作中即 ai_ready,disputed、archived 等不可當可設定值使用。
  • 已知缺口:Worker 階段轉換嚴格線性,已接受但不打算整合的案件沒有終止途徑。本次嘗試結束測試案件 2、3 時收到 HTTP 409,狀態未變動;硬走假轉換會寫入假時間戳並汙染稽核紀錄,故不執行。處置為留在原階段並於 HANDOFF 註明性質;未來新增可由任一階段進入的 archived 終端狀態,須附 migration 與測試。
  • 案件 10 於回報後標記 completed 結案,回報紀錄存於私人案件目錄並標註送出時間,密碼不留存。

2026-09-12:生命週期補入「發布後回報提供者」

  • 缺口:原標準生命週期止於「驗證與發布 → 結案」,從未規定回報原提供者。提供者投入資料卻看不到結果,核心參與循環(資料 → 發現 → 驚喜 → 分享 → 更多資料)斷在發布這一步。案件 10 回報時發現此缺口。
  • 流程:《LINE 收件與審核流程》長期流程圖新增「回報原提供者」節點,位於發布之後、結案之前;提供者指出錯誤則回到修正意見,不直接改母資料。新增「發布後回報提供者」專節,訂明回報時機、必備四項與回報後處置。
  • 防噪音:只在內容實際上線可見時回報(新人物、新事實、新關係、新媒體),一案一則;純內部狀態變更與 R2 清理不回報;多輪補充於最後一次上線後回報一次。
  • 禮貌門陷阱:首頁無禮貌門,但人物頁與小世界頁都有。回報必附家族共用密碼,否則對方直接卡在密碼畫面。此項已寫入流程、決策紀錄與 HANDOFF。
  • 專屬連結:回報使用 ?person=Pxxx&setme=1,讓對方開啟即以自己為中心展開。
  • 不新增案件狀態:completed 語意明確定義為「已回報原提供者並結案」,並補入狀態表(該表原先缺 completed,與 Worker 允許值不一致)。回報紀錄以私人案件目錄的回報草稿檔為憑,不增加 migration、Worker 驗證與測試負擔;若日後實際發生漏報再評估新增 contributor_notified。
  • 同步文件:《LINE 收件與審核流程》《決策紀錄》《HANDOFF》《變更紀錄》。

2026-09-12:案件 10 核准整合與郭氏父母生日補入

  • 正式資料:依提供者確認回覆,為 P202 郭應樑補入國曆生日1952年3月16日、P203 陳宥靜補入國曆生日1959年2月24日;新增來源 S014。本案不新增人物、不新增 ID。
  • 提供者:LINE 顯示名稱「Ophelia」於確認回覆自述並同意具名為郭秝妤(P199),與先前案件的謝昇憲為不同帳號。此為第一位非謝昇憲的投稿者。
  • 曆別:提供者明確表示所提供生日均為國曆,未做任何曆法換算。
  • 交叉驗證:提供者陳述郭鳴峰為其兄、郭珆華為其弟,與案件 8 由謝昇憲提供的1978年、1981年10月15日、1982年12月5日出生記載完全相符;兩個獨立來源零矛盾。
  • 長幼:因提供者未明示子女總數,rank 維持空值,僅將相對長幼寫入 P204、P206 的備註;三人生日均已知,直式世系依生日即可正確排序。
  • 佐證:郭應樑與郭秝妤的父女關係經當事人本人確認,成為 S013 之外的第二個獨立來源;關係節點本身不變動。
  • 本次未取得:回覆稿未詢問父母在世狀態、父母生日的公開同意,以及 P199 既有生日已上線一事。兩人 living_status 維持 possibly_living 推定值,公開層仍會呈現在世與現年。
  • 基線:人物 210、獨立關係 50、編譯後關係邊 334、事件 22、來源 13 → 14;verify:fast 通過。

2026-08-21:案件 8 核准整合與人物外部連結正式呈現

  • 正式資料:依提供者確認稿新增 P199~P210 共 12 位人物、REL247~REL250 四筆婚配及來源 S013;補入謝昇憲、郭秝妤的兩名女兒,以及郭秝妤父母、手足、婚配與下一代。
  • 同名辨識:郭珆華之妻新建為 P208 陳慧玲,明確與既有 P181 陳惠玲分開;不得合併,也不連到甘明哲一支。案件早期文字「郭泓志」已由提供者更正為郭珆華,不另建人物。
  • 資料精度:郭鳴峰、郭少帆及郭岑曦只記提供者給出的出生年,不反推月日;郭又綸只保存截至2026年8月就讀大學三年級的補述,不由學級推算出生或性別。
  • 外部連結:謝織蔓人物檔新增經提供者確認與同意的 YouTube 頻道「有話蔓蔓說」。建置器正式驗證 external_links 的永久 ID、網址、狀態與可見範圍,親友版 JSON 及人物圖卡新增「相關網站」區塊;私人連結與未校閱連結不輸出。
  • 來源保存:LINE 顯示名稱「信」沿用已核對的提供者謝昇憲;原始四則文字與確認回覆保存於 Cloudflare 私人案件及 Google Drive 私人備份,資料管理者於2026年8月21日核准寫入。
  • 基線:人物 210、獨立婚配關係 50、編譯後關係邊 334、事件 22、來源 13;verify:fast 通過。
  • 上線:Git 提交 38aeaea 的 GitHub Pages 工作流程 32394679760 成功;線上 JSON 實測含 210 人、334 關係、謝織蔓的 YouTube 連結,以及彼此獨立的 P208 陳慧玲與 P181 陳惠玲。
  • 結案:CASE-LINE-20260820-000008 已依序標記為已整合、已發布、已結案;Google Drive 私人備份保留,Cloudflare R2 暫存已依護欄清理。

2026-08-20:資料基線改為建置時動態產生

  • 建置:build-family-data.mjs 每次成功驗證 Markdown 母資料後,自動產生《資料統計》,統一列出人物、獨立關係、編譯後關係邊、事件、戶、地點、來源、待查問題與日治戶籍人物欄數量。
  • 文件:README、HANDOFF、開發計畫與小世界方案不再手寫目前人數,改連到單一統計頁;《變更紀錄》仍保留各里程碑當時的精確數字。
  • 網站:人物一覽與小世界原本就從 family-data.json 動態計數;本次把說明文件也納入同一次編譯來源,避免新增人物後出現 198/其他數字並存。

2026-08-20:Phase 4 v1.0 正式定版與文件一致性稽核

  • 定版:將已完成真實文字與圖片案件閉環驗證的 LINE 收件、人工接受、Drive 私人備份、AI 整理、提供者確認、資料管理者核准、Markdown 整合、逐檔媒體發布、Pages 上線、結案及 R2 清理流程定為 Phase 4 v1.0 正式基準。
  • 版本規則:Schema 1.0.0 由試行版升為正式版;後續相容新增與破壞性變更依語意化版本管理,結構或狀態改動必須附 migration、測試、決策及變更紀錄。
  • 里程碑:Phase 4F 已由案件 7 的人物、關係、來源、媒體與來源鏈正式整合完成驗證;Phase 4G 改列正式版後的低流量維運觀察,不再阻擋 v1.0。
  • 現況同步:README、HANDOFF、開發計畫、LINE Schema、流程、帳號設定及 Worker README 已統一為 198 人、46 筆獨立關係、314 條編譯後關係邊、22 個事件、12 筆來源、0005 migration、29 項 Worker 測試與正式 Worker 版本 ef71988d-dbf9-4fbb-a578-86329aa99947。
  • 歷史保留:本頁舊條目維持當時快照,不回頭改寫;現行規則以《決策紀錄》《LINE 收件與審核流程》及本頁最新條目為準。

2026-08-20:案件 7 核准整合、前配偶語義與逐檔媒體發布護欄

  • 正式資料:依提供者確認稿新增 P178~P198 共 21 位人物、REL241~REL246 六筆婚配及來源 S012;補入李富珍、李亮珍、李瑞珍、李貴俊、李慧珍一支與兩代子女。
  • 前配偶:甘明哲與陳惠玲成對記為「前夫/前妻」。此角色只表示曾有婚姻且關係已結束,不推定離婚、喪偶、再婚或任何一方死亡;編譯器新增前夫角色必須有前妻對應的驗證。
  • 媒體:謝盛堂人物檔新增兩筆 Google Drive 照片連結。網站只投影已記錄提供者同意、資料管理者核准且單檔權限完成的媒體;未公開檔、案件資料夾與案件 JSON 不會進入人物圖卡。
  • Worker:新增 0005_media_publication.sql、逐檔同意紀錄、私人案件資料夾與檔案歸屬/大小核對、單檔 anyone reader 權限,以及 line:media-consent、line:publish-media、line:clear-r2 三個管理命令。R2 仍只能在 Drive 核對、Pages 發布與案件結案後清理。
  • 基線:人物 198、獨立婚配關係 46、編譯後關係邊 314、來源 12。
  • 上線:Cloudflare D1 套用 0005 前已匯出 24,628 bytes 私人 SQL 備份;Worker 版本 ef71988d-dbf9-4fbb-a578-86329aa99947 已部署。Git 提交 161ef5c 的 GitHub Pages 工作流程 32349890779 成功,線上 JSON 實測含 198 人、314 關係、REL246 前夫/前妻角色及兩筆謝盛堂媒體。
  • 結案:CASE-LINE-20260816-000007 已依序標記為已整合、已發布、已結案;兩張 Drive 正本以未登入請求核對為 image/jpeg 且位元組數完全一致。R2 暫存已永久清理,D1 稽核為 10 則訊息、0 筆 R2 路徑、2 筆 Drive 索引與 2 筆已發布媒體。

2026-08-20:Google OAuth 正式環境與 Drive 直接媒體方案定案

  • OAuth:資料管理者已將 Google Auth Platform 的 Audience 切換為 In production。重新授權頁曾回傳 Google 500,但未撤銷、覆寫或洩漏既有 secret;隨後以線上案件 7 實際觸發備份,舊 refresh token 仍成功完成 Drive 核對,Worker 健康檢查也正常。現行先沿用已驗證 token;只有日後出現 invalid_grant 才重新授權。秘密不進入 Git。
  • 儲存:依資料持有人決定,第一版媒體採 Google Drive 直接引用;不另建網站專用 R2 或 CDN,也不強制轉檔。
  • 權限:Drive 案件資料夾、案件 JSON 與未選用原件保持私人;只有已確認並實際要在網站展示的單一檔案,才開放「知道連結的任何人/檢視者」。
  • 生命週期:R2 定位為 LINE 收件暫存;只在 Drive 已核對、網站已發布且案件已結案後,才由管理者輸入「清理 R2」刪除原檔。
  • 文件:新增《Google Drive 媒體發布標準程序》,記錄欄位、單檔分享、Markdown 引用、無痕檢查、網站發布與 R2 清理步驟。

閱讀方式

本頁採「最新在上、歷史只增不改」。舊段落中的「待辦」「未部署」「尚未推送」、舊測試數及舊 Worker 版本,都是當次工作的狀態快照,不代表現在仍未完成。現況應先看最上方最新條目,再以《開發計畫》《LINE 官方帳號與 Webhook 設定》及實際程式/雲端設定為準。

2026-08-20:Google Drive 真實圖片案件備份與回復完成

  • 授權:修正 Windows 授權工具啟動 Wrangler 時的引號相容性問題;Google OAuth client ID、client secret 與 refresh token 已寫入 Cloudflare encrypted secrets,憑證 JSON 由 Git 忽略規則排除。
  • 私人資料夾:建立「小世界族譜_LINE案件原始資料(私人)」作為 Worker 唯一目的根資料夾;只有 shiehmen@gmail.com 擁有者權限,無 anyone 分享。原先可由連結讀取的測試資料夾不再接收親族原件。
  • 上線:遠端 D1 已先匯出私人備份,再成功套用 0004_google_drive_backup.sql;Worker 版本 0f646b77-df7e-400a-9bf8-c7db21d42f83 已部署,啟動時間 4 ms,26 項 Worker 測試全數通過。
  • 真實回復:CASE-LINE-20260816-000007 已建立私人案件資料夾,包含 CASE-LINE-20260816-000007.json(4,273 bytes)、message-0014-image.jpg(1,167,014 bytes)與 message-0016-image.jpg(371,553 bytes)。第一張圖片已由 Drive 重新讀回並實際開啟;D1 的逐檔 ID、位元組數、完成與核對時間均一致,錯誤欄為空。
  • 防重:第二次執行相同備份後仍只有相同 3 個檔案與相同 file ID;圖片未重建,只有案件 JSON 依最新索引原地更新,證實可重複操作及中斷續作設計有效。
  • 工具:新增 npm.cmd run line:webhook:google-verify -- <案件流水號>,可在不輸出管理金鑰的情況下重做管理端備份核對。
  • 尚待人工設定:本次 OAuth 專案仍為 Testing,測試 refresh token 只有七天效期;資料管理者須將 Audience 切為 In production 後重新授權一次。此項不影響本次真實案件驗證結果,但關係到七天後能否持續備份。

2026-08-16:Google Drive 一鍵案件備份進入上線驗證

  • 原因:第一件含正式圖片的 CASE-LINE-20260816-000007 已出現,共 9 則訊息、2 張 JPEG,R2 附件合計 1,538,567 bytes;原審核頁的 Drive 欄位只會記錄網址,不會實際上傳,因此使用者看到「無法存入」。
  • Drive 實測:已以資料管理者 Google 帳號在指定資料夾建立、讀回非敏感測試檔,證實 Google Drive 容量、帳號擁有權與 API 連接器基本寫入正常。稽核同時發現指定資料夾為「知道連結的任何人可編輯」,真實家族原件不得在此狀態下上傳。
  • Worker:新增 OAuth refresh token 換取、私人可寫資料夾檢查、Drive 案件資料夾建立、R2 原件串流可續傳上傳、逐檔大小核對、Drive file ID/網址回寫、案件 JSON 最後寫入,以及中斷後重按續作與已完成檔案防重。
  • 安全:Google OAuth client、client secret、refresh token 只存 Cloudflare encrypted secrets;目標資料夾存在任何 anyone 權限時拒絕備份。R2 清理既有護欄不變,Drive 原件不會因網站發布而刪除。
  • 操作:新增本機 Desktop OAuth+PKCE 授權工具 npm.cmd run line:webhook:google-authorize;新增 D1 migration 0004_google_drive_backup.sql 與審核頁「一鍵備份並核對 Google Drive」按鈕。
  • 資料界線:Drive 是私人原件庫與 AI 工作來源;正式 Markdown 保存案件 ID、Drive file ID 與網站資產路徑。Drive 分享網址不作為正式 HTML/Markdown 圖片來源,網站展示圖仍另產生穩定衍生檔。
  • 驗證:26 項 Worker 測試全數通過,包含 OAuth token 交換、公開資料夾拒絕與 resumable upload。線上 migration、OAuth secrets、部署及真實案件 Drive 下載回復仍待資料夾改為「受限制」後執行。
  • Git 狀態:本節與程式、migration、測試及操作文件尚未提交、尚未推送。

2026-08-15:降低搜尋收錄與建置文件重整

  • 所有 HTML 加入 noindex, nofollow,並關閉 sitemap 與 RSS;目的為降低搜尋引擎收錄,不宣稱是加密或真正權限控管。
  • 完整親友版繼續輸出人物、戶籍原文、考據、事件及 PDF/JPG/TXT/CSV/MD 典藏,不對史料逐項遮罩或搬移。
  • 人物摘要新增已知/摘要不公開/未詳狀態;possibly_living 有出生年且未滿 95 歲時可顯示「出生年—在世」與現年,達 95 歲以上則改列卒年未註記。小世界節點移除底部重複的「仍在世」。
  • 建置命名改為 build:family(完整親友版)、build:public(公開遮罩版)、build:site(部署入口),build:redacted 僅保留相容別名。
  • 新增網站輸出驗證,逐一檢查 HTML noindex、sitemap/RSS、禮貌門範圍及完整典藏輸出。
  • 新增《決策紀錄》,並將 HANDOFF.md 縮減為現況、指令與待辦;自動備份與空白模板延後另案。
  • 新增本人邀請網址 ?person=Pxxx&setme=1:對方第一次開啟且瀏覽器尚無「我」設定時自動保存該人物;已有設定不覆蓋,一般人物連結仍只置中。

2026-08-14:緣起人物連結至小世界

  • 《緣起》全文中的謝恭(P014)、謝盛金(P058)、謝明文(P111)、謝盛堂(P065)與李林招妹(P173)姓名改為人物探索連結;點擊後直接開啟小世界中心心智圖,並以該人物重新置中。
  • 依提供者校正,原文「林昭妹」為誤植,正名為人物母檔既有的「李林招妹」(P173)。
  • 人物連結使用 data-person-center 保存永久 ID,再由緣起頁執行程式產生含 ?person= 的部署網址,避免 Quartz 編譯時將查詢參數誤當內部頁名。

2026-08-14:說明文件現況稽核

  • 稽核 content/00-說明 全部 10 份 Markdown,將現況文件與歷史紀錄分開判讀;《緣起》中的圖 01/02 待補位置屬內容待辦,並非過時設計,予以保留。
  • 更新《AI 維護守則》與《資料格式》的驗證指令為 verify:fast/verify:release,補明 family 親友密碼完整版與 public 公開遮罩版的差異。
  • 更新《小世界互動圖方案》為現行 Cytoscape preset 分區布局、關係分類切換、單擊重新置中、雙擊圖卡、BFS 路徑及 3~5 層直式世系;ELK 保留為未來複雜布局,不再誤寫成現行主布局器。
  • 更新 LINE 文件:現行 Worker 為 pending-review,四格圖文選單與分批自動回覆已完成 23 項測試及真人操作;現行版本為 751c3c88-6ef4-44cc-96ed-d97bcdac9326。verify-only 改列為初建/重建環境的歷史階段。
  • Phase 4 仍標為進行中:4A~4E 與首件結案已完成;4F、4G 及真實大檔的 Google Drive 備份/回復仍是待辦。
  • GitHub Pages 容量說明已依 GitHub 官方文件核對:來源 repo 建議不超過 1 GB、發布站點上限 1 GB;現行典藏輸出約 97.19 MB,原分級策略仍可沿用。
  • 驗證:verify:fast 與 verify:release 均通過;完整網站建置為 177 人、277 關係、22 事件,以及 2 組、3 冊/影像集、58 頁典藏。Cloudflare deployment 狀態另以 Wrangler 唯讀核對,版本 751c3c88-6ef4-44cc-96ed-d97bcdac9326 承接 100% 流量。

2026-08-14:LINE 圖文選單與分批自動回覆

  • 新增四格圖文選單上傳圖與 SVG 母檔:開始提供資料、本次資料傳完、開啟小世界網站、查看使用說明。
  • Worker 新增一批兩次的自動回覆:第一筆開始收件、中間安靜收件、完成時依 D1 回覆文字、照片、語音、影片、文件等實際數量。
  • 選單指令不寫入投稿內容;同一批重複按開始或完成皆不會重複回覆。完成後再次開始或直接補充,會開新一批且只統計新內容。
  • LINE Reply API 失敗時撤銷回覆旗標,讓下一次按鈕操作可重試;錯誤日誌不記錄 LINE userId、訊息文字或 reply token。
  • 新增 D1 migration 0003_intake_auto_reply.sql;套用前完整備份遠端 D1 至 Git 忽略的 private/backups/,本機與遠端 migration 均成功。
  • 初版曾以 22 項 Worker 測試、verify:fast 與 Wrangler dry-run 通過;線上 /healthz 回傳 ok: true、pending-review、storage_ready: true。
  • 初版曾部署 Worker 版本 b5b06aa1-c1c3-4cf8-a2d1-48ab6261003d;真人 LINE 圖文選單的重複點擊測試當時尚待執行。
  • 第一次真人測試發現開始指令已到達 D1,但 Reply 訊息未送達;修正為 Reply API 失敗時自動以 Push API 補送。重複按開始或完成也會提供簡短狀態回饋,但不重複建案或統計。
  • 修正後共 23 項 Worker 測試、verify:fast 與 Wrangler dry-run 通過;已部署現行 Worker 版本 751c3c88-6ef4-44cc-96ed-d97bcdac9326。
  • 第二次真人 LINE 圖文選單測試通過:重複開始與重複完成都有狀態回饋,但遠端 D1 僅維持 1 筆待審投稿、1 則測試文字;按鈕指令未寫入內容,也未重複建立案件。最後再次開始已正確開啟下一批收件。

2026-08-14:首頁 LINE QR Code 版面簡化

  • 移除 QR Code 左側沒有互動功能的官方帳號頭像,避免重複識別圖占用空間。
  • 首頁投稿區只保留可點擊的 LINE 加好友 QR Code 與操作說明;公開身分核對頁仍保留帳號頭像,供使用者比對 LINE 帳號真偽。

2026-08-14:小世界品牌標誌與網址圖示

  • 移除網站標頭原有的紅色「人」字方印,避免引起「小人」的負面聯想。
  • 新標誌改以「中心、根系、相連節點」表達家族記憶與跨世代連結,不使用人形、姓氏或文字。
  • 網站標頭與瀏覽器分頁 favicon 統一使用同一標誌;原始圖檔保存於 content/assets/small-world-logo.png,網站用圖位於 quartz/static/icon.png。

2026-08-14:LINE 官方帳號公開身分核對頁

  • 新增 line-official 公開核對頁,列出帳號名稱、Basic ID、管理者、QR Code、非營利用途、資料處理流程及防詐安全聲明。
  • 密碼遮罩僅對此核對頁例外;首頁、人物與其他家族內容仍保留親友共用密碼門檻。
  • 當時先補記四格圖文選單與「每批兩次」Worker 自動收件回覆規劃;後續已完成實作、部署與真人測試,現況見本頁最上方條目。

2026-08-14

LINE 對外入口、官方帳號素材與可重複驗證

  • 網站:首頁底部新增「用 LINE 補充家族資料」專區,提供官方加入好友連結、官方 QR Code、三步驟說明及可傳送的文字、照片、語音、影片、文件與網址類型;明示資料會先經人工與 AI 整理,再回傳提供者確認。
  • 署名:全站頁尾加入「網站發起、設計與資料整理:謝昇憲」,連回《緣起》,並加入小世界 LINE 官方帳號入口。
  • 圖像:新增小世界官方帳號方形頭像與橫幅封面。兩者由 AI 輔助生成,採米紙、朱砂印色、墨色與人物網絡節點意象,不使用特定族人肖像;官方 QR Code 保留 LINE 原始品牌標誌與掃描容錯。
  • RWD:Chrome Remote 實測首頁於 1600/1366/1024/768/390px 均無頁面水平溢出、欄位重疊或執行期例外;另把投稿區與 QR 區捲入手機視窗,確認按鈕、說明、頭像及 QR 比例可讀。
  • LINE 後台:文件補上帳號狀態訊息、個人檔案介紹與加入好友歡迎訊息。正式使用時保留手動聊天與 Webhook、開啟歡迎訊息,關閉會顯示「無法個別回覆」的預設泛用自動回應。
  • 亂碼護欄:確認 CASE-LINE-20260813-000004 的回覆草稿欄實際保存 ASCII ?,不是瀏覽器字型或 UTF-8 顯示問題。Worker 新增「幾乎全是問號」的草稿拒絕規則,避免 shell/剪貼來源編碼異常再次覆蓋正常中文草稿;既有亂碼草稿已先備份為 small-world-line-intake-before-fix-garbled-draft-case000004-20260814.sql,再只清除該草稿,案件仍為已結案。
  • Cloudflare:18 項 Worker 測試、Wrangler dry-run 與線上健康檢查通過;Worker 版本 6f8ea391-2dbf-4198-b97e-fa9ed406bcb1 已部署,D1、R2 與 pending-review 綁定正常。
  • 驗證效率:新增 verify:fast 與 verify:release,把日常案件和首次基礎設施黑箱驗證分開。日常不再重查整套 LINE/Cloudflare,只在程式、migration 或綁定有變更時部署 Worker。
  • Google Drive:明確更正為尚未完成真實大檔的備份與回復測試;管理欄位已存在,但等第一件有實際大檔需求的案件再驗證。
  • 可攜性:Cloudflare Worker、D1 migrations、R2 綁定、測試與設定範例均受 Git 版控;secrets 和雲端資料不進 Git。現有私有儲存庫含真實資料與 Git 歷史,不可直接清空後公開;對外框架須另建全新、白名單匯出的空白範本儲存庫。
  • 分析工具:現階段不加入 GA。家族站頁名與網址可能含姓名,且尚無明確分析問題;待真正需要匿名流量趨勢時,優先評估較精簡的 Cloudflare Web Analytics,並先確認網域與同意揭露方式。

首件真實 LINE 案件完成結案

  • 案件:CASE-LINE-20260813-000004;結構案件 CASE-0S1SNX75Y299BMFXA4EMM0HPHJ。
  • 結案:資料管理者檢視網站結果後明確同意結案;Cloudflare D1 於 2026-08-14 00:06:25(台灣時間)由「網站已發布」更新為「已結案」,結構案件同步封存並保留完整來源、修訂、確認與審核鏈。
  • 備份:結案前完整 D1 備份 small-world-line-intake-before-close-case000004-20260814.sql 保存於 Git 專案外的私人備份區。
  • 原始檔:本次只結案,不清理 R2;r2_cleared_at 保持空值。日後若要清理,仍須另行確認 Drive 備份及使用管理頁的二次確認護欄。
  • 後續收件:同一 LINE 帳號在本案結案後再次傳送訊息,會建立新的待處理投稿,不會悄悄併入已結案案件。

2026-08-13

首件真實 LINE 案件完成核准及母資料整合

  • 案件:CASE-LINE-20260813-000004;結構案件 CASE-0S1SNX75Y299BMFXA4EMM0HPHJ;來源節點 S011。
  • 提供者:LINE 顯示名稱「信」,回覆自報姓名為謝昇憲(既有人物 P140);身分狀態記為自行陳述,不以 LINE 顯示名稱取代姓名。
  • 更正歷程:原投稿同時出現「黃致鈞/黃致君」,兩種原文均保留;提供者確認「黃致鈞才對」,錯誤主張標為 rejected,修正版另建主張,不覆蓋原始訊息。
  • 新增人物:P175 黃致鈞、P176 黃沛驛、P177 黃沛愷。未提供的性別、生辰、排行與其他生平資料不推測;黃致鈞的性別只依原文「妻謝昇運」所表達的夫方角色記錄。
  • 新增關係:REL240 黃致鈞—謝昇運為夫妻;黃沛驛與黃沛愷的人物檔分別引用父 P175、母 P139,親子關係不另存重複邊。
  • 審核:提供者確認只代表正確理解其說法;資料管理者另於 2026-08-13 明確「核准寫入」,才整合進正式人物、關係及來源母資料。
  • 驗證:收件層 27 份 JSON、2 案、11 項主張均通過 Schema 與引用驗證;家族資料由 174 人/272 關係更新為 177 人/277 關係,完整網站共 193 份 Markdown、593 個輸出檔建置成功。三位人物頁、夫妻邊及四條父母邊均存在於編譯圖譜。
  • 線上狀態:整合前 D1 備份為 small-world-line-intake-before-integrate-case000004-20260813.sql,發布前再備份為 small-world-line-intake-before-publish-case000004-20260813.sql,兩者均保存於 Git 專案外的私人備份區。正式資料以 8fd9835 推送至私人 GitHub 儲存庫,GitHub Pages 已實際回傳 P175、P176、P177、REL240 及四條父母邊;D1 案件已更新為「網站已發布」。其後結案結果記錄於 2026-08-14,R2 原始資料仍保留。

LINE 確認回覆的人工合併護欄

  • 類型:Phase 4E/Cloudflare Worker/真實案件流程修正。
  • 問題:真實案件顯示,若提供者在管理者按「標記已傳 LINE 請確認」之前先回覆,鎖定中的原案件不會吸收該訊息,因此會另建一筆待處理投稿。
  • 修正:已接受案件頁會列出同一 LINE 使用者尚未處理的投稿,管理者查看後可選擇「合併為確認回覆」或「合併為案件補充」。每次都必須人工勾選確認;不同 LINE 使用者、已處理投稿或空合併一律拒絕。
  • 資料處理:合併只移動訊息及其附件索引到原案件、標記收件情境,再移除已清空的待處理投稿;不會自動改變案件階段、不會改寫訊息內容,也不會刪除 R2 原檔。
  • 操作順序:正常情況仍應先按「標記已傳 LINE 請確認」,再從官方 LINE 傳送確認稿;人工合併是順序顛倒時的安全補救。
  • 驗證:新增同一使用者可人工合併、未勾選不得合併及不同使用者禁止合併的測試;Worker 共 18 項測試、Wrangler dry-run、完整網站建置及線上健康檢查均通過。Worker 版本 f493dbc1-11fc-441a-b1d1-74aa567aaa3c 已部署;本次不需 D1 migration,也未改寫既有案件。

Phase 4E-lite 案件生命週期與私人管理登入

  • 類型:Phase 4E/Cloudflare Worker/D1/Google Drive 備份紀錄/人工 LINE 確認。
  • 金鑰修正:管理頁改為登入表單與八小時 HttpOnly Cookie;Cookie 僅保存管理金鑰衍生碼,不保存原金鑰。舊 ?key= 網址可登入一次後自動移除參數;新增 npm run line:review,由本機 .dev.vars 複製金鑰並開啟登入頁,避免沿用錯誤書籤。
  • 案件進度:已接受案件新增「持續收件、鎖定待 AI、等待提供者確認、提供者已確認、已整合母資料、網站已發布、已結案」七階段與順序檢查;接受不再等於凍結或確認。
  • 補充歸案:同一 LINE 提供者在「持續收件」或「等待提供者確認」時的新訊息會進入原案件,並標為案件補充或確認回覆;鎖定後的無關新內容才建立新投稿,避免接受後修正被拆散。
  • 備份與回覆:私人案件頁可記錄 Google Drive 資料夾、原始檔逐筆核對時間及人工 LINE 回覆草稿;第一版由管理者手動上傳 Drive、手動傳 LINE,不在 Worker 內增加 Google OAuth 或自動代發。
  • 清理護欄:只有 Drive 已核對、網站已發布且案件已結案時才顯示 R2 清理,並須再次輸入「清理 R2」。清理只刪除 R2 物件與其路徑,D1 保留檔名、MIME、大小及處理時間索引。
  • 資料庫:新增 0002_case_workflow.sql;既有已接受測試案件遷移為「鎖定待 AI」,避免舊案件在升級後被誤當成重新開放收件;原始資料及附件不被改寫。今後新接受的案件則預設「持續收件」。
  • 驗證:16 項 Worker 自動測試通過;全新本機 D1 由 0001、0002 依序遷移成功。線上 D1 已先匯出 SQL 備份,再成功套用 0002;Worker 版本 27135d8a-704e-4beb-a017-f0e12a30e0a8 已部署,健康狀態、私人登入、HMAC 工作階段防竄改及本機/遠端金鑰一致性均通過。線上保留 2 個已接受測試案件、1 個已忽略紀錄及 4 個 R2 附件索引,未執行內容清理。

LINE Webhook 通過官方伺服器驗證

  • 類型:Phase 4B/LINE Messaging API/Cloudflare Worker/連線驗證。
  • LINE:重新發行的 Channel access token 已可辨識官方帳號「小世界族譜」@472ckzvx;更新 Channel secret 後,LINE 伺服器已成功驗證 https://small-world-line-webhook.line-webhook.workers.dev/webhook/line。
  • Worker:執行模式已由 verify-only 切換為 pending-review;新增受 ADMIN_REVIEW_KEY 保護的 LINE 連線設定頁,可檢查 Bot、Webhook URL 與 Use webhook 狀態,並重新登記及驗證端點。
  • 驗證:12 項 Worker 自動測試通過;LINE Verify 後遠端 D1 維持 0 投稿、0 訊息、0 事件,確認驗證封包未建立假案件,也未保存 userId。
  • 驗證當下狀態:LINE Official Account Manager 的 Webhook 尚未開啟;其後已完成啟用與第一筆文字收件,結果記錄於下一節。

Phase 4B 第一筆真實 LINE 收件成功

  • 類型:Phase 4B/端到端測試/D1 待審核投稿。
  • LINE:Use webhook 已開啟,LINE API 回報 active;資料持有人本人傳送的第一筆文字已由 LINE 平台送達 Worker。
  • 收件:遠端 D1 正確建立 1 筆 pending 投稿、1 則文字訊息與 1 筆去重事件;提供者顯示名稱可由 LINE profile API 取得,未發生重送或重複建案。
  • 隱私:檢查只統計狀態、筆數與訊息類型,未把姓名、文字內容、userId 或秘密值輸出到紀錄。
  • 結論:Phase 4B 完成;下一步進入 Phase 4C,實測私人審核頁的「接受」與「忽略」,再進入 Phase 4D 媒體收件測試。

Phase 4C 忽略流程與案件匯出管理頁

  • 類型:Phase 4C/人工審核/隱私清除/AI 交接。
  • 忽略測試:第一筆「連線測試」已在線上 Worker 執行忽略;D1 狀態改為 ignored、待審核歸零、文字內容清空且沒有建立案件編號。
  • 隱私補強:忽略及七日逾期清理會把 LINE userId 匿名化為內部忽略編號;仍保留提供者顯示名稱、時間及狀態,兼顧來源辨識與資料最小化。
  • 管理頁:新增待確認/已接受/已忽略分頁;已接受案件可下載 line-intake-case JSON,包含案件編號、提供者顯示名稱、時間、文字及受保護附件索引,但不輸出 LINE userId、Channel secret 或管理金鑰。
  • 待辦:由資料持有人再傳一筆無敏感測試文字,完成「接受」與 JSON 下載的線上測試,之後進入照片、語音、影片及檔案測試。

Phase 4C 接受流程完成線上測試

  • 類型:Phase 4C/真實端到端測試/案件匯出/AI 交接。
  • 接受測試:資料持有人本人傳送第二筆無敏感文字;Worker 正確辨識提供者、建立唯一待審核投稿,經正式管理端點接受後產生格式正確的 CASE-LINE-*,待審核數回到 0。
  • 匯出測試:案件 JSON 為 line-intake-case 1.0.0,含案件編號、提供者顯示名稱、收件/接受時間及訊息陣列;不含 LINE userId、Channel secret 或管理金鑰。
  • 邊界:此筆為 Cloudflare 收件層測試案件,不會進入人物、關係或事件母資料,也不會因「接受」自動發布到網站。
  • 結論:Phase 4C 完成;下一步進行 Phase 4D 的照片、語音、影片及一般檔案收件與私人 R2 下載測試。

Phase 4D 媒體收件與私人 R2 完成真實測試

  • 類型:Phase 4D/LINE 媒體/Cloudflare R2/私人下載/案件匯出。
  • 收件:資料持有人本人依序傳送圖片、語音、一般檔案、短影片及伴隨文字;Worker 將 5 則訊息合併為同一待審核投稿,其中 4 個附件合計約 0.97 MB。
  • 完整性:圖片 image/jpeg、語音 audio/x-m4a、影片 video/mp4 及文字檔 text/plain 均成功存入私人 R2;受保護端點回傳的 MIME 與實際位元組數逐筆吻合 D1 索引,未發生截斷。
  • 存取:不帶管理金鑰讀取附件回傳 403;審核頁可呈現圖片、音訊、影片預覽及一般檔案下載入口,R2 沒有公開網址。
  • 接受與匯出:媒體投稿接受後建立格式正確的 CASE-LINE-*;line-intake-case 1.0.0 JSON 含 5 則訊息及 4 個附件索引,不含 LINE userId、秘密值或帶金鑰的下載網址。
  • 結論:Phase 4D 完成;下一步為 Phase 4E 的 AI 整理稿、管理者確認及 LINE 回傳提供者流程。

啟用 R2 並首次部署 LINE Webhook Worker

  • 類型:Phase 4B/Cloudflare R2/Worker 部署/秘密管理。
  • Cloudflare:建立私人 Standard R2 small-world-line-media(APAC),首次部署 small-world-line-webhook,公開接收端點為 https://small-world-line-webhook.line-webhook.workers.dev/webhook/line;D1、R2、每日 Cron 與 verify-only 綁定均經部署包驗證。
  • 秘密:LINE_CHANNEL_SECRET、LINE_CHANNEL_ACCESS_TOKEN、ADMIN_REVIEW_KEY 已加密保存於 Cloudflare;Wrangler 設定新增 required secret 名稱,避免日後漏設。秘密值未寫入 Git。
  • 驗證:11 項 Worker 自動測試通過,Cloudflare DNS 及部署版本可查;現有 Channel access token 呼叫 LINE API 回傳 401,確認並非有效 token,故尚未替 LINE 登記 Webhook,也尚未開啟內容保存。
  • 待辦:在 LINE Messaging API 頁重新發行 Channel access token,更新 Worker secret;將 Webhook URL 填入 LINE 後按 Verify,再開啟 Use webhook 與 Webhook redelivery。

建立 LINE 人工放行的待確認收件流程

  • 類型:Phase 4B/4C/4D、Cloudflare Worker、D1、R2、人工審核。
  • 決策:家族用途採低流量人工放行,不建立邀請碼或複雜會員審查;LINE 官方帳號 App 以原生通知提醒資料管理者,再於私人審核頁按「接受」或「忽略」。
  • 收件:同一 LINE 使用者在處理前的多則訊息合併為一筆待確認投稿;支援文字、地點、貼圖索引、照片、語音、影片與檔案。網址只當文字保存,不自動連線。
  • 儲存:D1 保存投稿、訊息索引、去重事件與狀態;R2 私人保存媒體。忽略或七日未處理會刪除訊息內容與附件;接受後只產生案件編號,不修改人物母資料。
  • 安全:延續 LINE 原始 body 簽章驗證,以 webhookEventId 去重;私人審核頁使用 Cloudflare secret 中的 ADMIN_REVIEW_KEY,金鑰不進 Git。
  • Cloudflare:帳號已完成 Wrangler OAuth 授權;建立 D1 small-world-line-intake,本機及線上均成功套用 0001_pending_review.sql。R2 尚待新帳號在後台首次啟用。
  • 備份:Google Drive 定位為後續「已接受案件」的第二份備份與人工瀏覽介面,不取代 Cloudflare 即時暫存。
  • 測試:既有簽章與不洩漏內容測試維持,新增審核頁拒絕錯誤金鑰;目前 9 項 Worker 測試通過,並完成本機及線上 D1 migration 驗證。

本頁記錄會影響網站行為、資料模型、多位人物或長期維護方式的重大變更。個別人物的小型史料校訂仍以該人物檔的 notes 為第一記錄位置。

記錄格式

  • 日期與類型
  • 原因與依據
  • 實際變更及影響範圍
  • 驗證方式與結果
  • Git 狀態(未提交/本機提交/已推送)

2026-08-12

建立 Phase 4B 最小 LINE Webhook 測試環境

  • 類型:LINE Messaging API/Webhook/安全邊界。
  • 架構:GitHub Pages 維持靜態網站;另以最小 Cloudflare Worker 接收 LINE 的 HTTPS POST。現階段為 verify-only,只驗證連線,不保存訊息、媒體、LINE userId,也不自動回覆或建立案件。
  • 安全:以原始 request body、Channel secret 與 HMAC-SHA256 驗證 x-line-signature,驗證成功後才解析 JSON;秘密值只允許放在 .dev.vars 或 Cloudflare encrypted secret,相關路徑已加入 .gitignore。
  • 行為:新增 /healthz 與 /webhook/line;支援 Developers Console 的空事件 Verify,事件處理使用非同步介面,日誌只包含事件 ID、事件/訊息類型、時間與重送狀態。
  • 測試:使用 LINE 官方文件的簽章測試向量,另測修改 body、無 secret、錯誤簽章、空事件、非同步事件及不洩露內容;共 8 項全數通過。
  • 文件:新增《LINE 官方帳號與 Webhook 設定》,說明官方帳號、Provider、Messaging API、Cloudflare 部署、secret、Verify、Webhook redelivery 與完成標準。
  • 待辦:Phase 4B 尚待資料持有人實際建立官方帳號、啟用 Messaging API、授權 Cloudflare 並完成線上 Verify;完成前不得邀請親友投稿。
  • Git 狀態:本節隨 Worker、測試與文件一併提交;發布狀態以 Git 遠端紀錄為準。

完成 Phase 4A-3 收件 Schema、範例與建置驗證

  • 類型:Phase 4 資料模型/版本管理/建置防錯。
  • 實作:建立 Contributor、Case、Item、Claim、Revision、Confirmation、Review 七類 JSON Schema 2020-12,現行試行版為 1.0.0;機器 ID 採類型前綴加 ULID,人員可讀案件編號另行保存。
  • 範例:新增一個完全虛構的跨人物、照片、語音、土地文件案件,包含 3 個 Item、6 個 Claim、2 次 Revision、提供者確認與管理者審核。範例刻意呈現 AI 人物辨識錯誤後的更正:舊 Claim 不覆寫,保留為 rejected;正確說法另建 Claim ID。
  • 驗證:新增 npm run intake:validate,檢查 Schema、ID/檔名、重複 ID、壞引用、跨案件引用、Item–Claim 雙向一致、Revision 順序、確認/審核範圍與明文 LINE userId。該驗證已納入 build:site,錯誤會阻止網站建置。
  • 試行原則:LINE 上線後的臨時需求先放 extensions;穩定且相容的新增升級 1.x,刪除、改名或語意改變才升級主版本並提供 migration。
  • 文件:新增《LINE 收件資料格式》及 data/intake/README.md、Schema 版本紀錄;完整流程仍見《LINE 收件與審核流程》。
  • 驗證結果:15 份虛構 JSON、7 類實體與所有跨檔關聯均通過,0 error。
  • Git 狀態:本節隨程式、Schema、範例及文件一併提交;發布狀態以 Git 遠端紀錄為準。

確立 Phase 4 LINE 長期收件與審核模型

  • 類型:Phase 4 規劃/來源追蹤/長期審核流程。
  • 決定:以「投稿案件」保存一次具有提供者、時間、對話脈絡與附件的持續處理歷程;案件不是人物容器,一案可關聯多人、多事、多地點與多物件。
  • 模型:案件下拆成可送審的資料項目,再擷取原子主張;案件與人物、關係、事件、地點、家庭、物件及來源均為多對多關係。只有主題無關、權限不同、爭議需獨立查證或案件大到無法清楚確認時才建立關聯子案件。
  • 審核:AI 整理稿先透過 LINE 回傳原提供者確認;提供者確認只表示沒有誤解其說法,之後仍須由資料管理者核准才可寫入正式資料、編譯與發布。各版整理稿、修正、補充、確認及核准紀錄均保留。
  • 文件:新增《LINE 收件與審核流程》,保存流程圖、三層資料模型、案件狀態、來源鏈與 Phase 4 實作順序;並更新《開發計畫》。新增 Mermaid 頁面煙霧測試,確認流程圖實際渲染且手機版無水平溢出。
  • Git 狀態:本節隨文件變更一併提交;發布狀態以 Git 遠端紀錄為準。

GitHub Pages 改為親友密碼完整版

  • 類型:發布模式/隱私策略/完整資料展示。
  • 決定:資料持有人明確要求解除所有人物匿名與頁面遮罩,GitHub Pages 完整發布人物、關係、事件、戶籍欄及譜牒典藏,只使用 JavaScript 共用密碼 family 作簡易入口門檻。
  • 變更:build:site/build:public 改用 family 模式;全部人物頁包含草稿與 visibility: family 均輸出,family-data.json 使用完整 174 人資料,典藏不再受 publish_public 過濾。原有匿名遮罩流程保留為可明確呼叫的 public 模式,供未來需要降低公開內容時使用。
  • 風險認知:GitHub Pages 是公開靜態託管;JavaScript 密碼不是加密或伺服器端授權,HTML、JSON、PDF、JPG、TXT、CSV 與 MD 仍可能被繞過入口直接下載。此風險已向資料持有人說明並獲明確接受。
  • Git 狀態:本節隨程式變更一併提交;發布狀態以 Git 遠端紀錄為準。

修復「姓名」欄解析盲區並補正李瑞珍

  • 類型:戶籍解析器/完整性驗證/人物與父母資料補全。
  • 原因:戶籍全文多數人物使用「氏名」,第 33 頁李瑞珍、謝昇憲改用「姓名」;舊解析器只接受「氏名」,因此兩筆未進入原先 111 筆的稽核母集合,造成稽核錯誤地回報零缺漏。
  • 變更:解析器同時接受「氏名/姓名」,來源人物欄由 111 筆校正為 113 筆;李瑞珍補入父李耀恭、母李林招妹、三女、續柄、完整第 33 頁原文與父母引用,謝昇憲補入完整人物欄;新增 P173 李林招妹、P174 李耀恭兩位獨立人物節點,總人物數由 172 增為 174。
  • 防再發:新增來源姓名欄數量覆蓋檢查,並把戶籍完整性稽核納入每次公開及開發建置;只要有人物欄未被解析、未對應或尚未寫入母檔,建置即失敗,不再只產生報告後繼續發布。
  • Git 狀態:尚未提交、尚未推送。

手足稱謂改為依中心人物動態判斷

  • 類型:小世界關係語意/顯示規則。
  • 原因:人物的「長女、長子」是其在原生家庭中的排行,不等於從任何中心人物觀看時的手足稱謂;例如謝昇運與謝昇憲應依觀看方向分別顯示為姊、弟,不能固定顯示「長女」。
  • 變更:資料層仍只保存性別、出生日期與原始排行;小世界及人物卡在編譯後的前端顯示階段,以中心人物為基準自動計算「兄、弟、姊、妹」。日期不足時只在同性別且排行可比較時判斷,證據不足則退回「兄弟、姊妹、手足」。
  • Git 狀態:尚未提交、尚未推送。

曾氏粉、曾金水生辰與曾滿婚配補正

  • 類型:人物資料校訂/生存狀態/關係補全。
  • 依據:日治戶籍第6頁明載曾氏粉生於明治32年12月7日,父曾滿、母蕭氏市;第7頁明載曾金水生於大正4年11月20日,母曾氏粉。
  • 變更:曾氏粉補入 1899-12-07、曾金水補入 1915-11-20 的日治戶籍生辰,兩人均改為 deceased_or_historical;原件未載卒日,故不補造死亡日期。新增 REL239,把曾滿與蕭氏市建立為夫/妻;只依共同子女的父母欄確認婚配,不推定婚期或入戶事件。
  • 顯示:人物卡顯示戶籍生辰;卒、享壽與冥壽維持「未註記」,不得顯示「仍在世」或現年。小世界中曾滿與蕭氏市顯示婚配關係。
  • 驗證:資料編譯為 172 人、270 條關係邊;Chrome Remote 確認 P141、P142 人物卡日期與四項生命欄位正確,曾滿中心圖有一條連往蕭氏市並標為「妻」的婚配線,P141 節點為 1899—? 且不含現年/仍在世。
  • Git 狀態:尚未提交、尚未推送。

親友共用密碼門與儲存庫分層決策

  • 類型:前端存取門檻/架構決策/發布。
  • 原因:網站先以 GitHub Pages 分享給親友,希望增加一層刻意簡單、容易傳達的共用密碼門;同時釐清資料層、顯示層與未來收件前端是否需要拆成三個 repository。
  • 變更:新增全站 family-gate Quartz 元件。使用者輸入共用密碼後,以 SHA-256 雜湊在瀏覽器比對,成功狀態只存於 sessionStorage,同一瀏覽器工作階段內跨頁沿用;錯誤密碼保留遮罩並顯示訊息。介面明示這是親友間的簡易閱覽門檻,並非資料加密或伺服器端身分驗證。
  • 限制:GitHub Pages、靜態 HTML、JSON、圖片及附件仍是公開可取得資源;真正敏感資料仍依公開建置遮罩、publish_public 與原件不公開規則處理。
  • 架構:現階段維持一個私有 monorepo,內部分成輸入/收件、結構知識、呈現三層。待三層需要不同權限、團隊或發布週期時,才拆成三個 repository,以版本化 Schema 與資料匯出介面銜接。
  • Git 狀態:尚未提交、尚未推送。

新增網站緣起與首頁核心概念

  • 類型:網站內容/首頁導覽/長期理念。
  • 原因:保存網站發起人最真實的建置動機,讓未來參與維護的人理解本計畫不只是父系族譜電子化,而是以每個人為節點、能共同延續的家族之網。
  • 變更:在「00-說明」新增完整〈緣起〉頁;保留原文語氣,加入段落圖示、四項概念導覽及圖 01–圖 07 的圖片位置,頁名精簡為「緣起」並固定排在「00-說明」最前。圖 03 已換成提供者指定的族譜人物欄原圖;圖 04–圖 07 使用 AI 生成的情境插畫,依序表達跨世代承接、由樹走向網、家人共同補寫及載體改變但資料延續。這些插畫並非特定族人或真實史料場景,網站圖說依呈現需求僅保留圖號與標題,生成屬性保留於本變更紀錄。首頁節錄六項重要概念,並提供完整緣起入口。文中人物姓名依提供者校訂為謝恭、謝明文、林昭妹、謝盛堂及謝盛金;並補明謝盛金為謝恭之孫、作者伯公,依據日治時期戶口資料重編,謝盛堂為作者叔公。
  • 導覽:文章使用二級標題,沿用既有右側目錄的快速跳轉與目前頁面定位功能。
  • 導覽顯示:左側 Explorer 將穩定資料夾路徑 00-說明 顯示為「說明」,並固定為第一個根目錄;實際目錄、網址與排序鍵維持不變,避免既有連結失效。
  • 圖片互動:圖 03 改為窄幅縮圖;點擊後以燈箱放大,可用右上角 ×、Esc 或點擊背景關閉。燈箱為獨立 Quartz 元件,支援行動裝置、焦點返回與背景捲動鎖定。
  • 驗證:開發版建置成功;Chrome Remote 確認「緣起」為「00-說明」第一項,頁面標題不再使用長名稱,圖 03–圖 07 共 5 張實圖均載入且可開啟燈箱。1600/1366/1024/768/390px 五種寬度下,主內容均無水平溢出、左右欄位也未侵入中間內容。
  • Git 狀態:尚未提交、尚未推送。

移除舊人物範例並納入可用內容結構

  • 類型:資料格式/內容清理。
  • 原因:範例-王大明.md 使用中文舊鍵、固定世代及手寫父母/配偶/子女,與現行 canonical 模型及關係唯一存放規則衝突。
  • 變更:刪除範例人物頁;將其中仍可沿用的生平、名字音義、外部影音連結及逐則補述,改寫進《資料格式》。新增 external_links、name_notes、supplements 參考格式;大事記、遷徙、出生地及墓地仍以 Event+Place 為唯一權威。
  • 驗證:開發版重新建置成功;人物檔與 family-data 均為 172 人。範例來源檔及 public/10-人物/範例-王大明.html 均不存在,資料編譯結果亦無此人物。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

歷代譜牒原件典藏與逐頁閱讀器

  • 類型:史料保存/前端功能/建置管線。
  • 原因:原始資料夾已有 PDF、JPG、TXT、CSV 與 MD,原頁面仍為待補;只嵌入 PDF 對手機不友善,全部改成 JPG 又會失去原件與下載憑據。
  • 變更:採「原件+閱覽本」雙軌。00-原始資料/族譜掃描/ 不改動;data/archive-catalog.yaml 保存典藏單位及譜冊穩定 ID;建置時複製原件、把 PDF 與原始 JPG 轉為最寬 1600px 的逐頁 JPEG,並產生 catalog.json。頁面提供逐頁/鍵盤閱讀、頁次切換、縮放、PDF 原件開啟與下載、JPG 原圖及轉錄校閱附件。
  • 隱私界線:本機 build:dev 可完整校閱;正式 GitHub Pages 只有在 collection 明確設為 publish_public: true 時才輸出該組原件。目前兩組均未授權公開。
  • 擴充規則:新增家族或版本時建立新的原始資料子目錄並在典藏目錄補一組 collection;未列入文件設定的 TXT、CSV、MD 與 JPG 仍會自動收錄,不需修改前端。
  • GitHub Pages:一般 Git 不存重複的衍生預覽檔;Actions 安裝 Poppler 後於部署時重建,避免 repo 因重複影像快速膨脹。
  • 驗證:本機完成 2 組、3 冊/影像集、58 頁,輸出 69 個檔案約 97.19 MB;抽查兩部 PDF 首頁與 JPG 預覽清晰。Chrome Remote 驗證 3 張典藏卡、4 個附件、48 頁 PDF 翻頁、4 張 JPG 原圖、原件連結及 390px 全螢幕閱讀器均正常。
  • 公開模式驗證:兩組皆為 publish_public: false 時,正式目錄只產生 1 個不含原件的 catalog.json,可見譜冊與預覽頁均為 0,兩組均標為 restricted。
  • RWD 回歸:一般資料頁、人物列表、人物圖卡、小世界與譜牒典藏共 5 頁型,在 1600/1366/1024/768/390px 共 25 組全部通過,無水平溢出或執行期錯誤;測試中另修正 Quartz 行動版 Explorer 抽屜以側欄為定位原點造成的 16px 溢出。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

資料節點由 142 人增加至 172 人

  • 類型:資料結構/戶籍補全。
  • 原因:日治戶籍人物欄保存父母姓名;依「每個人都是獨立節點」規則,不得只把父母留成附屬字串。
  • 變更:保留第一批 142 位人物,另建立 P143–P172 共 30 位戶籍父母節點。目前母檔為 172 人、38 個獨立關係節點、22 個事件;編譯後為 269 條關係邊。
  • 驗證:家族資料建置完成,人物檔數與開發版 family-data.json 均為 172。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

小世界同頁人物圖卡

  • 類型:前端互動。
  • 變更:單擊人物重新置中;雙擊人物在小世界同頁開啟完整人物圖卡;圖卡可返回原畫布或改以該人物為中心。返回時保留原中心、縮放及拖曳位置。
  • 驗證:瀏覽器測試確認雙擊不會誤觸單擊置中,返回按鈕、人物頁、最短關係與直式世系均正常。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

長輩易讀性調整

  • 類型:前端顯示/無障礙。
  • 變更:小世界圖例及操作說明由約 11.5px 放大為 16px,加深顏色、增加字重,改為上下兩列並支援窄畫面換行。
  • 驗證:桌面瀏覽器截圖確認文字無裁切,既有小世界互動測試通過。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

民國35年族譜早期世次的生卒缺載判定

  • 類型:多人資料校訂/顯示規則。
  • 依據:族譜提供者人工確認,謝香所屬世次不可能仍在世;原件未載卒年。
  • 變更:謝氏此、楊化、林氏紅柑、謝榮、林氏慶、謝香、趙氏罕改為 deceased_or_historical。不補造卒日,人物卡顯示「未註記」,圖譜顯示 ?,不得顯示「仍在世」或推算冥壽。
  • 驗證:人物卡自動測試確認生、卒、享壽、冥壽均為「未註記」,且未出現「仍在世」。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。

RWD 修正與 Chrome Remote 驗證

  • 類型:前端版面/品質修正。
  • 原始問題:桌面中央欄與右側欄重疊約 67.4px,資料頁目錄文字侵入正文約 35.4px;1024px 頁面水平溢出 56px;768px 溢出 21–37px;390px 溢出 21–45px。
  • 原因:Quartz 網格中央軌道未使用 minmax(0, 1fr),中央冊頁的 padding 與邊框又未納入軌道盒模型;小世界手機版另以視窗寬度設定外框,造成容器再次超寬。
  • 修正:三種斷點的中央軌道改用可收縮網格;#quartz-body、中央冊頁與小世界外框統一使用容器寬度及 border-box;手機圖譜首次載入自動置入全圖,480px 以下採三欄緊密排列以提高人物卡可讀尺寸。
  • Chrome Remote 驗證:一般資料頁、人物列表、人物圖卡、小世界四種頁型,於 1600、1366、1024、768、390px 共 20 組測試中,左右欄重疊、右欄侵入、頁面及元件水平溢出全部為 0。
  • 圖譜驗證:所有人物節點均位於畫布可視範圍;390px 測試的最小人物卡寬約 68.2px。完整互動回歸確認篩選、重新置中、返回、雙擊圖卡、最短關係與直式世系正常。
  • 測試工具:scripts/family/responsive-smoke.mjs、scripts/family/browser-smoke.mjs。
  • Git 狀態:已納入本機 Git 里程碑提交;尚未推送。