Files
chinese-family-tree-2/DATABASE_SEED_INFO.md
T
freedakgmail 3d075c6076 0.0.8.5
2025-11-24 14:02:34 +08:00

4.1 KiB
Raw Blame History

数据库示例数据说明

已填充数据概览

数据库已成功填充示例数据,包含两个完整的家族树和测试用户。

测试账号

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. 使用测试账号登录

重新填充数据

如果需要重新填充数据:

npx prisma db seed

注意: 此命令会清空现有数据并重新填充!

查看数据库

使用 Prisma Studio 可视化查看数据:

npx prisma studio

访问:http://localhost:5555

测试场景

1. 族谱展示

  • 查看完整的5代家族树
  • 测试树形图的渲染和交互
  • 验证关系连线的正确性

2. 成员管理

  • 浏览成员列表
  • 查看成员详情
  • 测试筛选和搜索功能

3. 时间轴

  • 查看家族历史事件
  • 按时间顺序展示成员生卒
  • 测试时间线可视化

4. 迁徙图

  • 查看家族迁徙路径
  • 测试地图可视化
  • 验证迁徙数据的准确性

5. 统计分析

  • 姓氏分布
  • 世代分布
  • 地域分布
  • 职业分布

数据维护

添加新成员

可以通过界面添加新成员,测试:

  • 表单验证
  • 关系建立
  • 数据保存

编辑成员

测试成员信息的编辑功能:

  • 基本信息修改
  • 关系调整
  • 照片上传

删除成员

测试删除功能和权限控制

注意事项

  1. 密码安全: 测试账号密码为 123456,仅用于开发测试
  2. 数据清理: seed 命令会清空所有现有数据
  3. 关系完整性: 删除成员时注意维护关系的完整性
  4. 备份: 在重新 seed 前可以先导出数据备份

下一步

  • 可以基于这些示例数据测试所有功能
  • 可以添加更多成员扩展家族树
  • 可以创建新的家族树进行测试
  • 可以测试协作功能(邀请其他用户)