This commit is contained in:
freedakgmail
2025-11-24 14:02:34 +08:00
parent b7a8c9ee6e
commit 3d075c6076
941 changed files with 25613 additions and 27641 deletions
+172
View File
@@ -0,0 +1,172 @@
# 数据库示例数据说明
## 已填充数据概览
数据库已成功填充示例数据,包含两个完整的家族树和测试用户。
## 测试账号
### 1. 王先生账号
- **邮箱**: `wang@example.com`
- **密码**: `123456`
- **家族树**: 王氏家族
- **世代**: 5代
- **成员数**: 32人
- **祖籍**: 山东省济南市
- **迁徙路径**: 济南 → 北京、上海、深圳、杭州、成都、苏州、西安
#### 王氏家族特点
- **始祖**: 王德厚(1880-1955),清末秀才
- **职业分布**: 教师、医生、工程师、程序员、金融分析师、创业者
- **地域分布**: 从山东济南扩展到全国主要城市
- **世代名**: 德→建→明→浩→子
### 2. 虞女士账号
- **邮箱**: `yu@example.com`
- **密码**: `123456`
- **家族树**: 虞氏家族
- **世代**: 5代
- **成员数**: 33人
- **祖籍**: 浙江省杭州市
- **迁徙路径**: 杭州 → 上海、北京、深圳、成都、南京、宁波
#### 虞氏家族特点
- **始祖**: 虞文昌(1885-1960),清末举人
- **职业分布**: 教授、医生、建筑师、律师、企业家
- **地域分布**: 从浙江杭州扩展到长三角及全国
- **世代名**: 文→国→晓→雨
## 数据结构
### 用户数据
- 2个测试用户
- 密码已加密(bcrypt
- 每个用户拥有一个家族树
### 家族成员数据
- **总计**: 65人(王氏32人 + 虞氏33人)
- **性别分布**: 男女比例均衡
- **年龄跨度**: 1880年代 - 2014年
- **在世成员**: 第3-5代大部分在世
- **已故成员**: 第1-2代已故
### 关系数据
- 父子关系
- 母子关系
- 配偶关系
- 兄弟姐妹关系(通过父母关联)
### 地理分布
包含以下城市的成员:
- **华东**: 济南、杭州、上海、南京、苏州、宁波
- **华北**: 北京、石家庄
- **华南**: 深圳
- **西南**: 成都
- **西北**: 西安
## 数据特点
### 1. 真实性
- 使用真实的中国姓名
- 符合中国家谱传统
- 包含世代名(字辈)
- 职业分布合理
### 2. 完整性
- 完整的5代家族树
- 详细的个人信息(姓名、生卒年月、籍贯、职业等)
- 完整的家族关系网络
- 包含迁徙信息
### 3. 多样性
- 不同年代的成员
- 多种职业类型
- 多个地理位置
- 在世和已故成员
### 4. 可测试性
- 足够的数据量用于测试各种功能
- 包含边界情况(如单亲、多子女等)
- 支持迁徙图可视化
- 支持时间轴展示
## 使用方法
### 登录系统
1. 启动开发服务器:`pnpm dev`
2. 访问:http://localhost:3000
3. 使用测试账号登录
### 重新填充数据
如果需要重新填充数据:
```bash
npx prisma db seed
```
**注意**: 此命令会清空现有数据并重新填充!
### 查看数据库
使用 Prisma Studio 可视化查看数据:
```bash
npx prisma studio
```
访问:http://localhost:5555
## 测试场景
### 1. 族谱展示
- 查看完整的5代家族树
- 测试树形图的渲染和交互
- 验证关系连线的正确性
### 2. 成员管理
- 浏览成员列表
- 查看成员详情
- 测试筛选和搜索功能
### 3. 时间轴
- 查看家族历史事件
- 按时间顺序展示成员生卒
- 测试时间线可视化
### 4. 迁徙图
- 查看家族迁徙路径
- 测试地图可视化
- 验证迁徙数据的准确性
### 5. 统计分析
- 姓氏分布
- 世代分布
- 地域分布
- 职业分布
## 数据维护
### 添加新成员
可以通过界面添加新成员,测试:
- 表单验证
- 关系建立
- 数据保存
### 编辑成员
测试成员信息的编辑功能:
- 基本信息修改
- 关系调整
- 照片上传
### 删除成员
测试删除功能和权限控制
## 注意事项
1. **密码安全**: 测试账号密码为 `123456`,仅用于开发测试
2. **数据清理**: seed 命令会清空所有现有数据
3. **关系完整性**: 删除成员时注意维护关系的完整性
4. **备份**: 在重新 seed 前可以先导出数据备份
## 下一步
- 可以基于这些示例数据测试所有功能
- 可以添加更多成员扩展家族树
- 可以创建新的家族树进行测试
- 可以测试协作功能(邀请其他用户)