pangu-user-platform/docs/06-测试文档/测试数据说明_v1.0.md

690 lines
18 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 盘古用户平台 - 测试数据说明文档
---
| 文档信息 | 内容 |
|---------|------|
| **文档版本** | V1.0 |
| **项目名称** | 盘古用户平台Pangu User Platform |
| **编写人** | 软件测试专家 |
| **创建日期** | 2026-02-01 |
| **数据类型** | 真实模拟测试数据 |
---
## 一、测试数据概述
### 1.1 数据生成目标
为盘古用户平台所有列表页生成101条真实模拟的测试数据确保
- ✅ 100%模仿真实业务场景
- ✅ 覆盖所有状态(正常、停用)
- ✅ 覆盖所有条件(类型、身份、来源等)
- ✅ 数据关系合理(学校-学生-会员关联)
- ✅ 使用真实中文姓名和地址
### 1.2 数据生成原则
1. **真实性原则**
- 使用真实的中国百家姓
- 使用真实的武汉市学校命名规则
- 使用真实的地址格式
- 使用真实的手机号格式139开头
2. **完整性原则**
- 覆盖所有业务状态
- 覆盖所有数据类型
- 覆盖所有关联关系
3. **一致性原则**
- 区域数据一致
- 学校-年级-班级关联一致
- 学生-会员关联一致
---
## 二、数据总览
### 2.1 数据量统计
| 数据表 | 初始数据 | 新增数据 | 总数据量 | 状态 |
|--------|:--------:|:--------:|:--------:|:----:|
| **pg_school** | 7条 | 101条 | **108条** | ✅ |
| **pg_member** | 2条 | 101条 | **103条** | ✅ |
| **pg_student** | 9条 | 101条 | **110条** | ✅ |
| **pg_application** | 5条 | 101条 | **106条** | ✅ |
**总计****427条真实测试数据**
### 2.2 数据分布
#### 学校数据分布108条
| 分类维度 | 分类 | 数量 | 占比 |
|---------|------|:----:|:----:|
| **按学校类型** | 小学 | 44所 | 40.7% |
| | 初中 | 34所 | 31.5% |
| | 高中 | 30所 | 27.8% |
| **按区域分布** | 武昌区 | 30所 | 27.8% |
| | 江岸区 | 20所 | 18.5% |
| | 江汉区 | 20所 | 18.5% |
| | 硚口区 | 15所 | 13.9% |
| | 黄冈市 | 16所 | 14.8% |
| | 其他 | 7所 | 6.5% |
| **按状态** | 正常 | 96所 | 88.9% |
| | 停用 | 12所 | 11.1% |
#### 会员数据分布103条
| 分类维度 | 分类 | 数量 | 占比 |
|---------|------|:----:|:----:|
| **按身份类型** | 家长 | 76人 | 73.8% |
| | 教师 | 27人 | 26.2% |
| **按注册来源** | 小程序 | 65人 | 63.1% |
| | H5 | 25人 | 24.3% |
| | 后台录入 | 13人 | 12.6% |
| **按状态** | 正常 | 100人 | 97.1% |
| | 停用 | 3人 | 2.9% |
#### 学生数据分布110条
| 分类维度 | 分类 | 数量 | 占比 |
|---------|------|:----:|:----:|
| **按性别** | 男生 | 57人 | 51.8% |
| | 女生 | 53人 | 48.2% |
| **按年级** | 一年级 | 20人 | 18.2% |
| | 二年级 | 20人 | 18.2% |
| | 三年级 | 10人 | 9.1% |
| | 四年级 | 12人 | 10.9% |
| | 五年级 | 10人 | 9.1% |
| | 六年级 | 8人 | 7.3% |
| | 七年级 | 12人 | 10.9% |
| | 八年级 | 10人 | 9.1% |
| | 九年级 | 4人 | 3.6% |
| | 高中 | 4人 | 3.6% |
| **按会员绑定** | 已绑定 | 75人 | 68.2% |
| | 未绑定 | 35人 | 31.8% |
| **按状态** | 正常 | 109人 | 99.1% |
| | 停用 | 1人 | 0.9% |
#### 应用数据分布106条
| 分类维度 | 分类 | 数量 | 占比 |
|---------|------|:----:|:----:|
| **按应用类型** | 教学管理类 | 25个 | 23.6% |
| | 学生服务类 | 20个 | 18.9% |
| | 家校互动类 | 15个 | 14.2% |
| | 校园安全类 | 18个 | 17.0% |
| | 后勤管理类 | 15个 | 14.2% |
| | 移动端应用 | 10个 | 9.4% |
| | 智能化系统 | 3个 | 2.8% |
| **按状态** | 正常 | 101个 | 95.3% |
| | 停用 | 5个 | 4.7% |
---
## 三、学校测试数据详情
### 3.1 学校命名规则
**小学命名**
- 格式:区域 + 街道/特色 + 小学
- 示例:武昌实验小学、江岸区鄱阳街小学
**中学命名**
- 初中武汉市第XX初级中学、区域+中学名
- 高中武汉市第XX中学、知名高中名称
- 示例:武汉市第十四中学、华中师范大学第一附属中学
### 3.2 学校地址
**地址组成**:区域 + 街道 + 门牌号
- 示例武昌区解放路259号、江岸区球场路64号
### 3.3 学校联系人
**命名规则**:真实姓氏 + "校长" 或 真实姓氏 + 职务
- 示例:张校长、李明华主任
### 3.4 学校手机号
**格式**138 + 区域码 + 序号
- 武昌区13807138001-13807138030
- 江岸区13807238001-13807238020
- 江汉区13807338001-13807338020
- 硚口区13807438001-13807438015
- 黄冈市13807538001-13807538016
---
## 四、会员测试数据详情
### 4.1 家长会员76人
**姓名特点**
- 使用中国常见姓氏(张王李刘陈等)
- 使用常见名字(伟、芳、娜、强、静等)
- 年龄段30-45岁
**手机号**139 + 00001001-00001075
**注册来源分布**
- 小程序注册50人65.8%
- H5注册18人23.7%
- 后台录入8人10.5%
**状态分布**
- 正常74人97.4%
- 停用2人2.6%- 模拟违规账号
### 4.2 教师会员27人
**命名规则**:姓氏 + "老师"
- 示例:张老师、王老师、李老师
**手机号**139 + 00002001-00002026
**注册来源分布**
- 小程序注册14人51.9%
- H5注册7人25.9%
- 后台录入6人22.2%- 学校统一录入
**状态分布**
- 正常26人96.3%
- 停用1人3.7%- 模拟离职教师
---
## 五、学生测试数据详情
### 5.1 学生命名规则
**姓名特点**
- 使用复姓和常见姓氏
- 使用流行的名字(子涵、思琪、浩宇、梓萱等)
- 符合当代学生命名趋势
**学号规则**STU + 年度 + 区域码 + 序号
- 示例STU202601001武昌区第1号、STU202602001江岸区第1号
### 5.2 出生日期分布
**按年级匹配真实年龄**
- 一年级2015年出生6-7岁
- 二年级2014年出生7-8岁
- 三年级2013年出生8-9岁
- 四年级2012年出生9-10岁
- 五年级2011年出生10-11岁
- 六年级2010年出生11-12岁
- 七年级2009年出生12-13岁
- 八年级2008年出生13-14岁
- 九年级2007年出生14-15岁
- 高中2006年出生15-16岁
### 5.3 学生分布
**按学校分布**
- 武昌区学校40人36.4%
- 江岸区学校30人27.3%
- 江汉区学校16人14.5%
- 硚口区学校8人7.3%
- 黄冈市学校7人6.4%
- 其他9人8.2%
**按年级分布**:均衡分布在各年级
**会员绑定情况**
- 已绑定会员75人68.2%- 前75个学生绑定到会员
- 未绑定会员35人31.8%- 模拟未注册会员的学生
---
## 六、应用测试数据详情
### 6.1 应用分类
#### 教学管理类25个
- 智慧校园平台、教务管理系统、学生成长档案
- 在线课堂系统、作业辅导平台、考试测评系统
- 智能排课系统、学籍管理平台、学生选课系统
- 班级管理助手、教师发展中心、课程资源库
- 微课制作平台、教研活动管理、教学质量监控
- 等共25个系统
#### 学生服务类20个
- 家校互动平台、校园通知发布、问卷调查系统
- 图书馆管理系统、体育健康管理、艺术教育平台
- 科学实验系统、心理健康咨询、社团活动管理
- 竞赛管理平台、志愿服务记录、校友管理系统
- 招生宣传平台、家长会议通知等
#### 校园安全类18个
- 校园安全监控、消防安全系统、应急广播平台
- 疫情防控系统、健康码验证、体温检测平台
- 口罩识别系统、人脸识别门禁、车牌识别系统
- 视频监控平台、周界报警系统、巡更管理平台
- AI行为分析等
#### 后勤管理类15个
- 宿舍管理平台、食堂订餐系统、校车管理平台
- 门禁考勤系统、一卡通管理、会议室预约
- 车辆预约系统、访客登记管理、物资采购平台
- 合同管理系统、档案管理平台等
#### 其他系统28个
- 移动端应用、智能化系统、大数据平台等
### 6.2 应用编码规则
**格式**APP + 年度 + 序号5位
- 示例APP20260001、APP20260101
### 6.3 密钥生成规则
**格式**SECRET + 年度序号 + 随机字符8位大写字母
- 示例SECRET202601001ABCDEFGH
### 6.4 联系人命名
**格式**:姓氏 + "经理"
- 示例:张经理、李经理、王经理
### 6.5 联系电话
**格式**138 + 00001001-00001101
- 模拟企业客户专线
---
## 七、数据关系说明
### 7.1 区域-学校关系
```
湖北省1
├── 武汉市11
│ ├── 武昌区111→ 30所学校
│ ├── 江岸区112→ 20所学校
│ ├── 江汉区113→ 20所学校
│ └── 硚口区114→ 15所学校
└── 黄冈市12
└── 黄州区121→ 16所学校
```
### 7.2 学校-学生关系
每所学校分配不同数量的学生:
- 重点学校4-8人
- 普通学校2-4人
- 新建学校0-2人
### 7.3 学生-会员关系
**绑定规则**
- 前75个学生已绑定会员member_id = 10-84
- 后35个学生未绑定会员member_id = NULL
**模拟场景**
- 已注册家长的学生:已绑定
- 未注册家长的学生:未绑定
- 新入学学生:未绑定
---
## 八、数据状态覆盖
### 8.1 学校状态
| 状态 | 数量 | 占比 | 模拟场景 |
|------|:----:|:----:|---------|
| 正常0 | 96所 | 88.9% | 正常运营的学校 |
| 停用1 | 12所 | 11.1% | 合并、撤销、整改的学校 |
**停用学校分布**
- 武昌区3所ID: 109, 116, 127
- 江岸区2所ID: 208, 220
- 江汉区2所ID: 308, 315
- 硚口区1所ID: 408
- 黄冈市1所ID: 516
- 其他3所
### 8.2 会员状态
| 状态 | 数量 | 占比 | 模拟场景 |
|------|:----:|:----:|---------|
| 正常0 | 100人 | 97.1% | 活跃用户 |
| 停用1 | 3人 | 2.9% | 违规、注销账号 |
**停用会员**
- 家长2人ID: 20, 69
- 教师1人ID: 95
### 8.3 学生状态
| 状态 | 数量 | 占比 | 模拟场景 |
|------|:----:|:----:|---------|
| 正常0 | 109人 | 99.1% | 在校学生 |
| 停用1 | 1人 | 0.9% | 转学、休学学生 |
**停用学生**
- ID: 116屈思涵- 模拟转学学生
### 8.4 应用状态
| 状态 | 数量 | 占比 | 模拟场景 |
|------|:----:|:----:|---------|
| 正常0 | 101个 | 95.3% | 活跃应用 |
| 停用1 | 5个 | 4.7% | 下线、维护中的应用 |
**停用应用**
- ID: 10校园安全监控
- ID: 25教学质量监控
- ID: 40门禁考勤系统
- ID: 55数据备份系统
- ID: 70PC客户端
---
## 九、真实场景模拟
### 9.1 学校场景
#### 重点学校
- 华中师范大学第一附属中学SCH20260121
- 武汉市第二中学SCH20260122
- 黄冈中学SCH20260512
#### 普通学校
- 各区实验小学、街道小学
- 各区初级中学
- 各区普通高中
#### 停用学校
- 武昌区文华中学SCH20260116- 模拟合并
- 武汉中学SCH20260127- 模拟整改
- 江岸区实验学校SCH20260220- 模拟撤销
### 9.2 会员场景
#### 活跃家长
- 小程序注册,经常查看学生信息
- 绑定1-2个学生
- 状态正常
#### 不活跃家长
- H5注册偶尔使用
- 可能未绑定学生
- 状态正常
#### 违规家长
- 发布不当言论
- 状态停用ID: 20, 69
#### 教师用户
- 后台录入或自主注册
- 可以是班主任、任课教师
- 个别离职教师状态停用ID: 95
### 9.3 学生场景
#### 正常在校学生
- 已绑定家长会员
- 所属学校、年级、班级信息完整
- 状态正常
#### 新入学学生
- 暂未绑定家长会员member_id = NULL
- 等待家长注册并绑定
- 状态正常
#### 转学学生
- 状态停用ID: 116
- 模拟已转学到其他学校
### 9.4 应用场景
#### 核心应用
- 智慧校园平台APP20260001
- 教务管理系统APP20260002
- 学籍管理平台APP20260009
#### 辅助应用
- 各类教学辅助系统
- 家校互动工具
- 校园服务平台
#### 停用应用
- 已下线的旧系统
- 维护中的应用
- 计划淘汰的系统
---
## 十、数据验证结果
### 10.1 API验证
| API接口 | 总数据量 | 正常数据 | 停用数据 | 状态 |
|---------|:--------:|:--------:|:--------:|:----:|
| /api/school/list | 108条 | 96条 | 12条 | ✅ |
| /api/member/list | 103条 | 100条 | 3条 | ✅ |
| /api/student/list | 110条 | 109条 | 1条 | ✅ |
| /api/application/list | 106条 | 101条 | 5条 | ✅ |
### 10.2 筛选条件验证
**学校类型筛选**
- ✅ 小学0144所
- ✅ 初中0234所
- ✅ 高中0330所
**会员身份筛选**
- ✅ 家长276人
- ✅ 教师127人
**会员来源筛选**
- ✅ 小程序165人
- ✅ H5225人
- ✅ 后台录入313人
### 10.3 关联关系验证
**学生-会员关联**
- ✅ 已绑定75个学生 → 75个会员1:1
- ✅ 未绑定35个学生member_id = NULL
**学校-学生关联**
- ✅ 所有学生均关联到有效学校
- ✅ 所有学校ID存在于pg_school表
**学校-年级-班级关联**
- ✅ 所有学生的school_grade_id有效
- ✅ 所有学生的school_class_id有效
---
## 十一、数据质量保证
### 11.1 数据完整性
**所有必填字段完整**
- 学校school_code、school_name、school_type、region_id
- 会员member_code、phone、identity_type
- 学生student_name、region_id、school_id、school_grade_id、school_class_id
- 应用app_code、app_name、app_secret
**所有外键关联正确**
- 学生 → 学校school_id
- 学生 → 会员member_id可空
- 学生 → 学校年级school_grade_id
- 学生 → 学校班级school_class_id
### 11.2 数据唯一性
**唯一约束验证**
- 学校编码uk_school_code108个唯一值
- 会员手机号uk_member_phone103个唯一值
- 学号uk_student_no110个唯一值
- 应用编码uk_app_code106个唯一值
### 11.3 数据真实性
**真实姓名库**
- 使用中国真实姓氏排名前100
- 使用当代流行名字
- 符合年龄段命名特点
**真实地址库**
- 使用武汉市真实街道名
- 地址格式符合规范
- 区域划分正确
**真实学校名**
- 参考武汉市真实学校命名规则
- 使用常见的学校名称模式
- 符合教育系统规范
---
## 十二、使用说明
### 12.1 数据导入
**SQL脚本位置**
```
/Users/felix/pgWorkSpace/pangu-user-platform/sql/test_data_101.sql
```
**导入命令**
```bash
mysql -h 8.148.25.55 -u root -paly2024A < sql/test_data_101.sql
```
**执行时间**约3秒
### 12.2 数据清理
如需清理测试数据执行以下SQL
```sql
-- 清理ID>=10的测试数据保留初始数据
DELETE FROM pg_school WHERE school_id >= 10;
DELETE FROM pg_member WHERE member_id >= 10;
DELETE FROM pg_student WHERE student_id >= 10;
DELETE FROM pg_application WHERE app_id >= 10;
```
### 12.3 数据验证
**验证脚本**`/tmp/verify-101-data.sh`
**验证命令**
```bash
chmod +x /tmp/verify-101-data.sh
./tmp/verify-101-data.sh
```
---
## 十三、测试场景支持
### 13.1 分页测试
**支持场景**
- 第1页1-10条
- 中间页50-60条
- 最后一页100-108条
- 跨页查询
### 13.2 条件筛选测试
**支持场景**
- 状态筛选(正常/停用)
- 类型筛选(小学/初中/高中)
- 身份筛选(家长/教师)
- 关键词搜索(姓名、编码)
### 13.3 排序测试
**支持场景**
- 按创建时间排序
- 按编码排序
- 按名称排序
### 13.4 关联查询测试
**支持场景**
- 查询学生时显示会员信息
- 查询会员时显示学生列表
- 查询学校时显示年级班级
- 查询应用时显示授权接口
---
## 十四、数据特色
### 14.1 真实性
- ✅ 使用真实的中国人名
- ✅ 使用真实的学校名称
- ✅ 使用真实的地址格式
- ✅ 使用真实的手机号格式
- ✅ 使用真实的年龄分布
### 14.2 完整性
- ✅ 覆盖所有业务状态
- ✅ 覆盖所有数据类型
- ✅ 覆盖所有关联关系
- ✅ 覆盖所有筛选条件
### 14.3 多样性
- ✅ 不同区域分布
- ✅ 不同学校类型
- ✅ 不同会员身份
- ✅ 不同注册来源
- ✅ 不同应用类别
---
## 十五、附录
### 15.1 中国百家姓前50
张、王、李、刘、陈、杨、赵、黄、周、吴、
徐、孙、朱、马、胡、郭、林、何、高、罗、
郑、梁、宋、谢、韩、唐、冯、于、董、萧、
程、曹、袁、邓、许、傅、沈、彭、吕、苏、
卢、姜、崔、钟、谭、陆、汪、范、金、石
### 15.2 常见学生名字
**男生**
子涵、浩宇、宇轩、晨曦、子豪、浩然、宇航、子轩、晨阳
**女生**
思琪、梓涵、雨萱、诗涵、梓萱、雨桐、思涵、诗雅、雨欣
### 15.3 武汉市行政区划
| 中心城区 | 新城区 | 功能区 |
|---------|--------|--------|
| 江岸区 | 蔡甸区 | 东湖高新区 |
| 江汉区 | 江夏区 | 武汉经开区 |
| 硚口区 | 东西湖区 | 武汉化工区 |
| 汉阳区 | 黄陂区 | - |
| 武昌区 | 新洲区 | - |
| 洪山区 | 汉南区 | - |
| 青山区 | - | - |
---
**文档编写人**:软件测试专家
**审核人**:待审核
**版本**V1.0
**日期**2026-02-01
---
*本文档详细说明了盘古用户平台的测试数据生成规则、数据分布、数据关系和验证结果,为系统测试提供完整的数据支撑。*