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

# 盘古用户平台 - 测试数据说明文档

---

| 文档信息 | 内容 |
|---------|------|
| **文档版本** | 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: 70（PC客户端）

---

## 九、真实场景模拟

### 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 筛选条件验证

**学校类型筛选**：
- ✅ 小学（01）：44所
- ✅ 初中（02）：34所
- ✅ 高中（03）：30所

**会员身份筛选**：
- ✅ 家长（2）：76人
- ✅ 教师（1）：27人

**会员来源筛选**：
- ✅ 小程序（1）：65人
- ✅ H5（2）：25人
- ✅ 后台录入（3）：13人

### 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_code（108个唯一值）
- 会员手机号：uk_member_phone（103个唯一值）
- 学号：uk_student_no（110个唯一值）
- 应用编码：uk_app_code（106个唯一值）

### 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

---

*本文档详细说明了盘古用户平台的测试数据生成规则、数据分布、数据关系和验证结果，为系统测试提供完整的数据支撑。*