# school_physical_test 表文档

## 表概述
**表名**: school_physical_test  
**功能**: 学员体测管理表，负责管理教务系统中学员的体能测试数据，包括身高体重测量、体测报告生成、教练指导记录等体能评估相关功能

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	体测编号
resource_id	int	NULL	NO		NULL		select,insert,update,references	资源ID
student_id	int	NULL	YES		NULL		select,insert,update,references	学员ID
height	decimal(5,2)	NULL	NO		NULL		select,insert,update,references	身高
weight	decimal(5,2)	NULL	NO		NULL		select,insert,update,references	体重
coach_id	int	NULL	YES		NULL		select,insert,update,references	教练ID
created_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	创建时间
updated_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	更新时间
physical_test_report	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	体测报告附件（多文件）
```

## 功能用途

### 主要功能
- **体测数据记录**: 记录学员的身高、体重等基础体测数据
- **资源关联管理**: 关联客户资源，跟踪潜在学员的体测情况
- **学员体测跟踪**: 记录正式学员的定期体测数据
- **教练指导记录**: 记录负责体测的教练信息
- **体测报告管理**: 存储和管理体测报告附件
- **时间记录**: 记录体测的创建和更新时间
- **数据对比**: 支持学员体测数据的历史对比
- **健康评估**: 基于体测数据进行健康状况评估
- **训练建议**: 根据体测结果提供个性化训练建议

### 业务场景
- **入学体测**: 新学员入学时进行初始体能测试
- **定期体测**: 在读学员定期进行体能测试
- **课程匹配**: 根据体测结果推荐适合的课程
- **训练计划**: 教练根据体测数据制定个性化训练计划
- **进度跟踪**: 跟踪学员体能改善进度
- **健康监控**: 监控学员健康状况变化
- **报告生成**: 生成详细的体测分析报告
- **家长沟通**: 向家长展示学员体能发展情况
- **数据分析**: 分析整体学员体能水平趋势

## 关联关系

### 主要关联表
- `school_customer_resources`: 客户资源表 (resource_id关联)
- `school_student`: 学员信息表 (student_id关联)
- `school_personnel`: 人员表 (coach_id关联教练)
- `school_course`: 课程表 (体测结果影响课程推荐)
- `school_class`: 班级表 (体测结果影响班级分配)
- `school_sys_attachment`: 附件表 (体测报告文件)
- `school_member`: 会员表 (学员会员信息)
- `school_contract`: 合同表 (体测影响签约决策)

### 关联说明
- **资源关联**: resource_id关联客户资源表，跟踪潜在客户体测
- **学员关联**: student_id关联学员信息，记录正式学员体测
- **教练关联**: coach_id关联负责体测的教练人员
- **课程关联**: 体测结果用于课程推荐和适配
- **班级关联**: 体测数据影响班级分配和分组
- **附件关联**: physical_test_report存储体测报告文件路径
- **会员关联**: 通过学员信息关联到会员账户
- **合同关联**: 体测结果可能影响合同签署决策

## 索引建议
- **主键索引**: id (已存在)
- **业务索引**: 
  - resource_id (资源查询)
  - student_id (学员查询)
  - coach_id (教练查询)
- **复合索引**: 
  - (resource_id, created_at) (资源体测时间查询)
  - (student_id, created_at) (学员体测历史查询)
  - (coach_id, created_at) (教练体测记录查询)
- **时间索引**: 
  - created_at (创建时间查询)
  - updated_at (更新时间查询)
- **数值索引**: 
  - height (身高范围查询)
  - weight (体重范围查询)

## 注意事项
- **数据精度**: 身高体重使用decimal(5,2)，精确到小数点后两位
- **关联完整性**: resource_id和student_id至少有一个不能为空
- **教练权限**: 只有授权教练才能录入和修改体测数据
- **数据有效性**: 需要验证身高体重数据的合理性范围
- **隐私保护**: 体测数据涉及个人隐私，需要严格保护
- **报告格式**: physical_test_report建议使用JSON格式存储多文件信息
- **时间戳**: 使用timestamp类型自动记录时间
- **数据备份**: 体测数据是重要的学员档案，需要定期备份
- **历史记录**: 不建议删除历史体测记录，用于对比分析
- **文件管理**: 体测报告文件需要与数据库记录保持一致
- **数据分析**: 体测数据可用于学员健康趋势分析
- **权限控制**: 体测数据查看需要相应权限控制
- **数据导出**: 支持体测数据的导出和报表生成
- **异常处理**: 需要处理体测设备故障等异常情况
- **标准化**: 体测流程和数据记录需要标准化