Gia Phả OS (Gia Phả Open Source)
Đây là mã nguồn mở cho ứng dụng quản lý gia phả dòng họ, cung cấp giao diện trực quan để xem sơ đồ phả hệ, quản lý thành viên và tìm kiếm danh xưng.
Dự án ra đời từ nhu cầu thực tế: cần một hệ thống Cloud để con cháu ở nhiều nơi có thể cùng cập nhật thông tin (kết hôn, sinh con…), thay vì phụ thuộc vào một máy cục bộ. Việc tự triển khai mã nguồn mở giúp gia đình bạn nắm trọn quyền kiểm soát dữ liệu nhạy cảm, thay vì phó mặc cho các dịch vụ bên thứ ba. Ban đầu mình chỉ làm cho gia đình sử dụng, nhưng vì được nhiều người quan tâm nên mình quyết định chia sẻ công khai.
Phù hợp với người Việt Nam.
Mục lục
Các tính năng chính
- Sơ đồ trực quan: Xem gia phả dạng Cây (Tree) và Sơ đồ tư duy (Mindmap).
- Tìm danh xưng: Tự động xác định cách gọi tên (Bác, Chú, Cô, Dì…) chính xác.
- Quản lý thành viên: Lưu trữ thông tin, avatar và sắp xếp thứ tự nhánh dòng họ.
- Quản lý quan hệ: Quản lý các mối quan hệ trong gia phả (hỗ trợ các trường hợp đặc biệt như đa thê, đa phu,…).
- Thống kê & Sự kiện: Theo dõi ngày giỗ và các chỉ số nhân khẩu học của dòng họ.
- Sao lưu dữ liệu: Xuất/nhập file JSON, CSV, GEDCOM để lưu trữ hoặc di chuyển dễ dàng.
- Bảo mật: Phân quyền (Admin, Editor, Member) và bảo vệ dữ liệu bằng Supabase.
- Đa thiết bị: Giao diện hiện đại, tối ưu cho cả máy tính và điện thoại.
Demo
Hình ảnh Giao diện
More screenshots: docs/screenshots/
Cài đặt và Chạy dự án
Chỉ cần khoảng 10 -> 15 phút là bạn có thể tự dựng hệ thống gia phả cho gia đình mình.
1. Tạo Database (Miễn phí với Supabase)
- Tạo tài khoản miễn phí tại https://github.com nếu chưa có.
- Tạo tài khoản miễn phí tại https://supabase.com nếu chưa có (khuyên dùng đăng ký bằng tài khoản GitHub cho nhanh).
- Tạo New Project. Đợi khoảng 1 -> 2 phút để hệ thống khởi tạo xong.
- Vào Project Settings → API, giữ lại 2 giá trị này để dùng ở bước tiếp theo:
Project URLProject API Keys
Cách 1: Deploy nhanh lên Vercel
- Tạo tài khoản miễn phí tại https://vercel.com nếu chưa có (khuyên dùng đăng ký bằng tài khoản GitHub cho nhanh).
- Nhấn nút Deploy bên trên.
- Điền các biến môi trường đã lưu ở bước 1:
NEXT_PUBLIC_SUPABASE_URL = Project URLNEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY = Project API Keys
- Nhấn Deploy và chờ 2 -> 3 phút.
Bạn sẽ có một đường link website để sử dụng ngay.
Cách 2: Chạy trên máy cá nhân
Yêu cầu: máy đã cài Node.js và Bun
- Clone hoặc tải project về máy.
- Đổi tên file
.env.example thành .env.local.
- Mở file
.env.local và điền các giá trị đã lưu ở bước 1.
NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY="your-anon-key"
- Cài thư viện
bun install
- Chạy dự án
bun run dev
Mở trình duyệt và truy cập: http://localhost:3000
Tài khoản đầu tiên
- Đăng ký tài khoản mới khi vào web lần đầu.
- Người đăng ký đầu tiên sẽ tự động có quyền admin.
- Các tài khoản đăng ký sau sẽ mặc định là member.
Xử lý lỗi khi đăng ký
Sau khi cài đặt xong, nếu bạn gặp lỗi Failed to fetch khi đăng ký:
Nguyên nhân: Supabase chặn các request từ domain chưa được thêm vào danh sách cho phép.
Cách khắc phục:
- Vào Supabase Dashboard → chọn Project của bạn.
- Vào Authentication → URL Configuration.
- Ở mục Site URL, điền URL chính của ứng dụng, ví dụ:
- Vercel:
https://giapha-os.vercel.app
- Máy cá nhân:
http://localhost:3000
- Ở mục Redirect URLs, nhấn Add URL và thêm:
https://giapha-os.vercel.app/**http://localhost:3000/** (nếu chạy local)
- Nhấn Save và thử lại.
Lưu ý: Thay giapha-os.vercel.app bằng domain thực tế của bạn. Nếu dùng domain tùy chỉnh, hãy thêm cả domain đó vào danh sách.
Phân quyền người dùng (User Roles)
Hệ thống có 3 cấp độ phân quyền để dễ dàng quản lý ai được phép cập nhật gia phả:
- Admin (Quản trị viên): Có toàn quyền đối với hệ thống.
- Editor (Biên soạn): Cho phép thêm, sửa, xóa thông tin hồ sơ và các mối quan hệ.
- Member (Thành viên): Chỉ có thể xem sơ đồ gia phả và các thống kê trực quan.
Đóng góp (Contributing)
Dự án này là mã nguồn mở, hoan nghênh mọi đóng góp, báo cáo lỗi (issues) và yêu cầu sửa đổi (pull requests) để phát triển ứng dụng ngày càng tốt hơn.
Tuyên bố từ chối trách nhiệm & Quyền riêng tư
Dự án này chỉ cung cấp mã nguồn (source code). Không có bất kỳ dữ liệu cá nhân nào được thu thập hay lưu trữ bởi tác giả.
-
Tự lưu trữ hoàn toàn (Self-hosted): Khi bạn triển khai ứng dụng, toàn bộ dữ liệu gia phả (tên, ngày sinh, quan hệ, thông tin liên hệ…) được lưu trữ trong tài khoản Supabase của chính bạn. Tác giả dự án không có quyền truy cập vào database đó.
-
Không thu thập dữ liệu: Không có analytics, không có tracking, không có telemetry, không có bất kỳ hình thức thu thập thông tin người dùng nào được tích hợp trong mã nguồn.
-
Bạn kiểm soát dữ liệu của bạn: Mọi dữ liệu gia đình, thông tin thành viên đều nằm hoàn toàn trong cơ sở dữ liệu Supabase mà bạn tạo và quản lý. Bạn có thể xóa, xuất hoặc di chuyển dữ liệu bất cứ lúc nào.
-
Demo công khai: Trang demo tại giapha-os.homielab.com sử dụng dữ liệu mẫu hư cấu, không chứa thông tin của người thật. Không nên nhập thông tin cá nhân thật vào trang demo.
Giấy phép (License)
Dự án được phân phối dưới giấy phép MIT.
评论