開發計畫
定位
本站不是一本只能從始祖往下看的電子族譜,而是一張以人為節點的小世界人物關係網。傳統世系圖、人物頁、時間軸、地圖與 GEDCOM 都由同一份母資料導出。
三層架構
照片/PDF/戶籍/口述
↓ AI整理+人工校閱
人物 Markdown+關係/事件/戶/地點/來源
↓ 驗證與編譯
人物頁/小世界關聯圖/直式世系圖/GEDCOM/PDFGit 儲存庫策略
目前採用「一個私有 monorepo、三個清楚層級」,暫不拆成三個 GitHub repository:
- 輸入/收件層:原始照片、PDF、戶籍、口述,以及未來 Phase 4 的親友表單或簡易前端。
- 結構知識層:人物 Markdown、關係、事件、戶、地點與來源,是唯一母資料。
- 呈現層:Quartz 網站、小世界、人物卡、世系圖及各種匯出產物。
三層分目錄、分 Schema、分驗證流程,但同一筆提交可以同時保存「收件內容如何轉成母資料,以及網站如何呈現」的完整版本,避免三個 repo 的 Schema、人物 ID 與部署版本互相錯位。只有在未來出現獨立維護團隊、不同存取權限、不同發布週期,或收件前端要成為獨立產品時,才拆成 family-data、family-site、family-contribute 三個 repository;拆分時以版本化 Schema 套件與固定資料匯出介面連接。
階段
- Phase 0:Quartz 骨架與私有 repo。
- Phase 1:GitHub Pages、中國風視覺與自動部署。
- Phase 2A:匯入 142 位真實人物,建立關係、事件、戶、地點與來源節點。
- Phase 2B:建立 Markdown → JSON 的驗證管線,並保留完整親友版與公開遮罩版兩種建置模式。
- Phase 2C:逐人補回戶籍原文、地址、名字音義與完整生平。
- Phase 3A:人物頁資料卡與時間軸元件;公開遮罩版保留最小化輸出,現行 GitHub Pages 則依資料持有人決定使用親友密碼完整版。
- Phase 3B:以人物為中心的互動小世界關聯圖、最短關係路徑與共同祖先。
- Phase 3C:直式、由右至左的傳統世系圖與列印/PDF。
- Phase 3D:Cytoscape 中心人物心智圖、關係分類收合、重新置中與返回歷史。
- Phase 3E:修正全站三欄盒模型與小世界手機初始視窗,完成 1600/1366/1024/768/390px RWD 驗證。
- Phase 3F:建立資料驅動的歷代譜牒典藏頁;保留 PDF/原始影像,另產生逐頁 JPEG 閱覽本與校閱附件索引。
- Phase 3G:加入親友共用的 JavaScript 簡易密碼門;同一瀏覽器工作階段解鎖一次,並明示它不是資料加密或真正的伺服器存取控制。
- Phase 4 v1.0(2026-08-20 正式定版):LINE 收件、四格圖文選單、分批自動回覆、D1/R2 暫存、人工接受、Drive 私人備份、AI 整理、提供者確認、管理者核准、來源鏈、正式母資料整合、逐檔媒體發布、GitHub Pages 發布、結案及 R2 清理均已由真實案件完成驗證。少數親友使用改列正式維運觀察,不阻擋定版。
- Phase 5:GEDCOM、封存與跨平台備份。
目前資料基線
人物、獨立關係、編譯後關係邊、事件、戶、地點、來源、待查問題與日治戶籍人物欄的目前數量,統一由建置程式產生於 資料統計。本頁不再重複手寫,以免新增案件或人物後形成多個互相矛盾的基線。
family-data.json 每次建置重生。目前 GitHub Pages 依資料持有人的決定採親友密碼完整版;JavaScript 共用密碼只是簡易入口門檻,不是加密。公開遮罩版仍保留為可切換的備用建置模式。
Phase 3 已交付
- 人物頁自動計算享壽與當年冥壽,組合父母、手足、妻妾與子女。
- 小世界使用 Cytoscape 中心心智圖:父母在上、手足在左、婚配在右、子女向下,點人即重定中心。
- 父母、手足、婚配、子女可以個別收合;可返回上一中心、置中全圖或進入人物內頁。
- 單擊人物重新置中;雙擊人物在同頁開啟完整人物圖卡,返回時保留原中心與畫布位置。
- 兩人關係使用 BFS 計算最短路徑,並另算最近共同祖先。
- 直式世系名字直排、同輩由右至左,長男排最右;妻妾是獨立小欄。
- 一般資料頁、人物列表、人物圖卡、小世界與譜牒典藏均通過 1600/1366/1024/768/390px Chrome Remote RWD 測試,無欄位重疊或頁面水平溢出。
- 歷代譜牒由
data/archive-catalog.yaml補充穩定 ID 與顯示名稱;建置時掃描00-原始資料/族譜掃描/,產生原件連結、逐頁閱讀器、影像冊與轉錄/校閱附件清單。 - GitHub Pages 目前讀取親友密碼完整版 JSON,完整資料受共用密碼入口遮擋但可被直接取得;真正需要降低公開內容時,必須切回公開遮罩版建置。
Phase 4 正式版與後續里程碑
Phase 4A~4F 已正式完成:採「投稿案件 → 資料項目 → 原子主張」三層模型,一個案件可關聯多人、多事件、多地點與多種媒體,並經提供者確認及資料管理者核准兩道審核。LINE/Cloudflare、文字與附件收件、人工接受/忽略、案件狀態、Google Drive 私人原件備份、逐檔發布同意、正式資料整合、Pages 發布與 R2 結案清理均已由真實案件驗證。後續維持低流量人工放行,少數親友試用只作正式版後觀察;若未來實際需求需要改變 Schema 或流程,另開新版與 migration,不在 v1.0 文件上直接改寫語義。下一個尚未完成的產品里程碑為 Phase 5(GEDCOM、封存與跨平台備份)。完整流程見 LINE收件與審核流程,欄位與版本規則見 LINE收件資料格式,帳號操作見 LINE官方帳號與Webhook設定。