Gia Pha OS - Ứng dụng gia phả mã nguồn mở

Gia Pha OS là ứng dụng web mã nguồn mở để lưu gia phả online. Người thân ở nhiều nơi có thể cùng cập nhật, còn dữ liệu nằm hoàn toàn trong tay gia đình vì các bạn tự host.

Giới thiệu

Ban đầu mình chỉ làm cho gia đình mình. Cuốn gia phả giấy toàn tên người, còn file trên một máy tính thì chỉ một người sửa được. Sau khi mình đăng ảnh lên Threads, nhiều người cũng muốn có một cái như vậy, nên mình chia sẻ mã nguồn theo giấy phép MIT.

• Xem cả dòng họ: Khám phá gia phả dạng cây, sơ đồ tư duy hoặc bong bóng.
• Cùng cập nhật: Nhiều người thân thêm con cái, kết hôn hay thông tin mới từ thiết bị của mình.
• Dữ liệu của mình: Deploy lên tài khoản Vercel và Supabase của chính các bạn, bắt đầu miễn phí.

Ảnh chụp

Điểm nổi bật

• Ba cách xem gia đình: Cây, sơ đồ tư duy và dạng bong bóng, trên máy tính lẫn điện thoại. Trên điện thoại hay máy tính bảng, chụm hai ngón để phóng to. Trên cây, + và - phóng to thu nhỏ, 0 đặt lại, phím mũi tên cuộn; ở dạng bong bóng dùng Tab để tới từng gia đình và Enter để mở, và trình đọc màn hình như VoiceOver đọc được các khung này.
• Xuất PDF: Một trang, hoặc nhiều trang A4 và A3 nằm ngang có mép chồng 10 mm để dán, mỗi trang có nhãn "hàng, cột".
• Sách gia phả và hồ sơ thành viên: In cả cây thành một cuốn sách theo từng đời, có bìa và mục lục, hoặc in hồ sơ một thành viên ra khổ A4.
• Âm lịch Việt Nam: Ngày giỗ tính theo âm lịch Việt Nam (UTC+7), có cả tháng nhuận. Trang Sự kiện tải được file .ics gồm sinh nhật, ngày giỗ và sự kiện riêng để nhập vào Google hoặc Apple Calendar.
• Tra cứu xưng hô: Tự tìm cách gọi đúng giữa hai thành viên bất kỳ, ví dụ bác, cô, dì hay anh em họ. Khi chưa biết ai lớn hơn, app hiện cả hai cách gọi và chỉ ra năm sinh nào sẽ phân định.
• Gia đình phức tạp: Hỗ trợ nhiều vợ chồng, tái hôn, con nuôi và tên khác của từng người.
• Tìm kiếm: Nhấn Ctrl hoặc ⌘ + K ở mọi trang quản lý để tìm thành viên theo tên không dấu ("nguyen van" ra "Nguyễn Văn").
• Nhập và xuất dữ liệu: File JSON, CSV và GEDCOM. GEDCOM giữ tên khác và ngày giỗ âm lịch, nên xuất rồi nhập lại không mất hai thứ này.
• Kiểm tra dữ liệu: Công cụ "Người có thể trùng" liệt kê những người có thể là một và gộp được hai hồ sơ trong một giao dịch cơ sở dữ liệu; công cụ "Kiểm tra dữ liệu" tìm các ngày vô lý như mất trước khi sinh. Cả hai dành cho admin.
• Sao lưu và phục hồi: Khi phục hồi, app đọc file trước, cho biết có bao nhiêu thành viên, quan hệ và sự kiện, rồi chạy trong một giao dịch, nên nếu lỗi thì dữ liệu hiện tại vẫn nguyên.
• Giao diện tiếng Việt và tiếng Anh: Đổi ngôn ngữ ngay trong app.
• Phân quyền: Ba vai trò Admin, Editor và Member, dữ liệu được bảo vệ bằng Supabase.
• Tự host theo cách bạn muốn: Vercel và Supabase (bắt đầu miễn phí), hoặc image Docker có kiểm tra sức khỏe để docker ps hiện healthy hay unhealthy.

Ai nên dùng

• Gia đình ở nhiều nơi muốn có một cuốn gia phả chung, luôn mới nhất.
• Người giữ sổ gia phả của dòng họ và muốn thứ gì đó dễ hơn cuốn sổ hay file bảng tính.
• Lập trình viên muốn một app gia phả tự host, đọc và sửa được mã nguồn.

Dùng thử

Mở bản demo và đăng nhập bằng giaphaos@homielab.com, mật khẩu giaphaos. Demo là công khai nên các bạn đừng nhập dữ liệu gia đình thật vào đó nhé.

Muốn chạy bản riêng, làm theo hướng dẫn trong repo GitHub, mất khoảng 10 đến 15 phút. Câu chuyện đằng sau dự án nằm trong bài Chia sẻ mã nguồn Gia phả online miễn phí.

Câu hỏi thường gặp

Có miễn phí không? Có. Mã nguồn theo giấy phép MIT, gói miễn phí của Vercel và Supabase đủ cho một gia đình thông thường.

Dữ liệu gia đình có riêng tư không? Dữ liệu nằm trong project Supabase của các bạn, tài khoản mới phải được admin duyệt. Mình không xem được dữ liệu đó.

Có bản tiếng Anh không? Có, app có giao diện tiếng Việt và tiếng Anh. App chủ yếu dành cho gia đình Việt nên phần tra cứu xưng hô vẫn dùng từ tiếng Việt như Bác hay Chú.

Dữ liệu nằm ở đâu? Trong project Supabase của chính các bạn, dưới tài khoản của các bạn; ảnh nằm trong phần lưu trữ của project đó. Không có gì gửi về cho mình, và các bạn có thể xuất toàn bộ ra JSON, CSV hoặc GEDCOM bất cứ lúc nào.

Nhập từ Excel hay phần mềm gia phả khác được không? Được. Lưu bảng tính thành CSV, hoặc xuất file GEDCOM từ phần mềm kia, rồi nhập trong trang quản lý. Sau đó dùng công cụ "Người có thể trùng" và "Kiểm tra dữ liệu" để dọn kết quả.

Chạy bằng Docker được không? Được. Repo có image Docker với kiểm tra sức khỏe và phần "Run with Docker" trong README.

Góp ý và hỗ trợ

Gặp lỗi hoặc có ý tưởng, các bạn mở issue trên GitHub nhé.