Gia Phả Điện Tử - Họ Đặng làng Kỷ Các, Thạch Lâm, Hà Tĩnh
Phần mềm quản lý gia phả điện tử giúp gìn giữ và truyền thừa thông tin dòng họ qua các thế hệ.
"Gìn giữ tinh hoa - Tiếp bước cha ông"
- Cây gia phả trực quan - Sơ đồ phả hệ tương tác, zoom, pan, collapse/expand, 10+ đời
- Quản lý thành viên - Hồ sơ cá nhân chi tiết (30+ trường thông tin)
- Phân quyền 4 cấp - Admin, Editor, Viewer, Guest (Supabase RLS)
- Tìm kiếm - Tra cứu nhanh theo tên, đời, chi nhánh
- Admin Panel - Quản lý người dùng, dữ liệu
- Responsive - Tương thích mobile/tablet/desktop
- Lịch âm dương - Chuyển đổi chính xác, hiển thị ngày giỗ
- Chi/nhánh - Quản lý theo cấu trúc dòng họ Việt Nam
- Đời (Generation) - Tính tự động theo phả hệ
- Can chi - Giáp Tý, Ất Sửu, ...
- Vinh danh thành tích - Bảng vinh danh thành viên xuất sắc (học tập, sự nghiệp, cống hiến)
- Quỹ khuyến học - Quản lý quỹ, học bổng, khen thưởng, theo dõi thu chi
- Hương ước gia tộc - Gia huấn, quy ước, lời dặn con cháu
- Thư mục thành viên - Danh bạ liên lạc với quyền riêng tư
- Lịch sự kiện - Theo dõi ngày giỗ, lễ, tết
- Cầu đương - Phân công trách nhiệm cầu đương theo lịch âm (thuật toán DFS)
- Quan hệ gia đình - Hiển thị bố/mẹ/anh-chị-em/vợ-chồng/con theo giao diện trực quan
- Thêm thành viên có quan hệ - Chọn bố/mẹ khi tạo mới, thêm con vào gia đình
- Cây lọc theo gốc - Hiển thị cây gia phả bắt đầu từ bất kỳ thành viên nào
- Chạy offline - Supabase CLI + Docker, không cần tài khoản cloud
- Dữ liệu demo - 18 thành viên 5 đời sẵn sàng sau
pnpm local:setup - Zero code change - Cùng code base, chỉ khác env vars
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 19, TypeScript 5 |
| Styling | Tailwind CSS 4, shadcn/ui, Radix UI |
| Database | Supabase (PostgreSQL, Auth, Storage, RLS) |
| State | React Query (TanStack Query) |
| Deployment | Vercel + Supabase Cloud |
| Cost | $0/tháng (100% free tier) |
Requires Docker Desktop + Supabase CLI
git clone https://github.com/Minh-Tam-Solution/AncestorTree.git
cd AncestorTree/frontend
pnpm install
pnpm local:setup # starts Docker, runs migrations, writes .env.local
pnpm devDemo login: admin@giapha.local / admin123
See docs/04-build/LOCAL-DEVELOPMENT.md for full guide.
git clone https://github.com/Minh-Tam-Solution/AncestorTree.git
cd AncestorTree/frontend
pnpm install
cp .env.local.example .env.local
# Fill in NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY
# Then run migrations in Supabase SQL Editor (supabase/migrations/ in order)
pnpm devAncestorTree/
├── docs/ # SDLC Documentation (LITE tier)
│ ├── 00-foundation/ # Vision, requirements, community
│ │ └── 06-Community/ # Community launch posts
│ ├── 01-planning/ # BRD, roadmap
│ ├── 02-design/ # Architecture, UI/UX
│ ├── 04-build/ # Sprint plans
│ └── 05-test/ # Test plans
├── frontend/ # Next.js application
│ ├── src/
│ │ ├── app/ # App router (route groups)
│ │ │ ├── (auth)/ # Login, register
│ │ │ └── (main)/ # Main app with sidebar
│ │ │ ├── achievements/ # Vinh danh thành tích
│ │ │ ├── charter/ # Hương ước
│ │ │ ├── contributions/ # Đóng góp
│ │ │ ├── directory/ # Thư mục thành viên
│ │ │ ├── events/ # Lịch sự kiện
│ │ │ ├── fund/ # Quỹ khuyến học
│ │ │ ├── people/ # Quản lý thành viên
│ │ │ ├── tree/ # Cây gia phả
│ │ │ └── admin/ # Admin panel
│ │ ├── components/ # React components
│ │ │ ├── ui/ # shadcn/ui
│ │ │ └── layout/ # Layout (sidebar, header)
│ │ ├── hooks/ # Custom React hooks
│ │ ├── lib/ # Supabase client, data layer
│ │ └── types/ # TypeScript types
│ └── supabase/ # Supabase CLI
│ ├── config.toml # Cấu hình local (ports, auth, storage)
│ ├── seed.sql # Dữ liệu demo (18 thành viên)
│ └── migrations/ # Migration files (theo thứ tự timestamp)
│ ├── 20260224000000_database_setup.sql
│ ├── 20260224000001_sprint6_migration.sql
│ ├── 20260224000002_cau_duong_migration.sql
│ ├── 20260224000003_sprint75_migration.sql
│ └── 20260224000004_storage_setup.sql
├── .sdlc-config.json # SDLC configuration
├── CLAUDE.md # AI assistant guidelines
└── README.md
13 tables across 4 layers:
| Layer | Tables | Description |
|---|---|---|
| Core Genealogy | people, families, children |
Phả hệ, quan hệ gia đình |
| Platform | profiles, contributions, media, events |
Tài khoản, đóng góp, sự kiện |
| Culture (v1.3) | achievements, fund_transactions, scholarships, clan_articles |
Vinh danh, quỹ, hương ước |
| Ceremony (v1.4) | cau_duong_pools, cau_duong_assignments |
Phân công cầu đương lễ, tết |
All tables have Row Level Security (RLS) policies with 4 roles.
Full SDLC documentation (9 docs, 141KB):
| Stage | Documents |
|---|---|
| 00-Foundation | Vision, Problem Statement, Market Research, Business Case |
| 01-Planning | BRD (77 FRs + 17 NFRs), Roadmap |
| 02-Design | Technical Design (13 tables), UI/UX Design |
| 04-Build | Sprint Plan (8 sprints, v1.6.0) |
See docs/README.md for full documentation index.
v0.1.0 Alpha [##########] Done - Infrastructure + Auth
v1.0.0 MVP [##########] Done - Tree + CRUD + Admin + Deploy
v1.1.0 Enhanced [##########] Done - Directory + Calendar + Contributions
v1.2.0 Release [##########] Done - GEDCOM + Book Generator + Photos
v1.3.0 Culture [##########] Done - Vinh danh + Quỹ khuyến học + Hương ước
v1.4.0 Ceremony [##########] Done - Cầu đương rotation + DFS algorithm
v1.5.0 Relations[##########] Done - Family relations UX + tree filter by root
v1.6.0 LocalDev [##########] Done - Supabase CLI + Docker local mode
v2.0.0 Community [----------] Future - Nhà thờ họ, Notifications, Cross-clan
AncestorTree is designed to be forked and customized. Any Vietnamese family can:
- Fork this repo
- Create a free Supabase project
- Run the database setup SQL
- Deploy to Vercel (free)
- Start entering family data
Total setup time: ~30 minutes. Total cost: $0/month.
This project was built using TinySDLC agent orchestrator following MTS-SDLC-Lite methodology.
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'feat: add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT License - see LICENSE for details.