freedakgmail
173 lines
4.1 KiB
Markdown
173 lines
4.1 KiB
Markdown
# 数据库示例数据说明
|
||
|
||
## 已填充数据概览
|
||
|
||
数据库已成功填充示例数据，包含两个完整的家族树和测试用户。
|
||
|
||
## 测试账号
|
||
|
||
### 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 前可以先导出数据备份
|
||
|
||
## 下一步
|
||
|
||
- 可以基于这些示例数据测试所有功能
|
||
- 可以添加更多成员扩展家族树
|
||
- 可以创建新的家族树进行测试
|
||
- 可以测试协作功能（邀请其他用户）
|