# school_personnel_summary 表文档

## 表概述
**表名**: school_personnel_summary  
**功能**: 人员工作汇总统计表，用于按日期统计销售人员和教练人员的工作绩效数据，包括任务完成情况、资源分配、到访数量、续费情况等关键指标，为人员绩效考核、工作量分析和业务管理提供数据支持

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
task_date	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	任务日期
campus_person_role_id	int	NULL	NO		NULL		select,insert,update,references	销售及教练 人员角色 id
role_type	int	NULL	NO		1		select,insert,update,references	1销售 2教练
task_num	int	NULL	NO		0		select,insert,update,references	任务数量
complete_num	int	NULL	NO		0		select,insert,update,references	完成数量
expire_num	int	NULL	NO		0		select,insert,update,references	到期数量
renew_num	int	NULL	NO		0		select,insert,update,references	续费数量
resource_num	int	NULL	NO		0		select,insert,update,references	分配的资源数量
visit_num	int	NULL	NO		0		select,insert,update,references	到访数量
person_id	int	NULL	NO		NULL		select,insert,update,references	人员id
```

## 功能用途

### 主要功能
- **日期统计管理**: 按任务日期统计人员的工作绩效数据
- **角色分类统计**: 分别统计销售人员和教练人员的工作数据
- **任务完成跟踪**: 记录和统计人员的任务数量和完成情况
- **资源分配统计**: 统计分配给人员的客户资源数量
- **到访数据统计**: 记录客户到访数量和转化情况
- **续费业绩统计**: 统计人员的续费业绩和客户维护情况
- **到期提醒统计**: 统计即将到期的客户数量
- **绩效数据汇总**: 为绩效考核提供量化的数据支持
- **工作量分析**: 分析人员的工作负荷和效率
- **趋势分析支持**: 支持按时间维度的趋势分析

### 业务场景
- **日报统计**: 每日统计销售和教练的工作完成情况
- **绩效考核**: 为月度、季度绩效考核提供数据依据
- **工作量分析**: 分析人员工作负荷，合理分配任务
- **业绩排名**: 根据完成数量等指标进行人员排名
- **资源效率**: 分析资源分配的转化效率和质量
- **续费管理**: 跟踪和管理客户续费的完成情况
- **到期预警**: 监控即将到期的客户，及时跟进
- **团队管理**: 团队负责人查看下属的工作统计
- **数据报表**: 生成各类工作统计和分析报表
- **目标管理**: 对比实际完成情况与设定目标
- **奖惩依据**: 为奖金发放和绩效奖惩提供数据
- **培训需求**: 根据完成情况识别培训需求

## 关联关系

### 主要关联表
- `school_campus_person_role`: 校区人员角色表 (campus_person_role_id外键关联)
- `school_personnel`: 人员信息表 (person_id外键关联)
- `school_campus`: 校区信息表 (通过角色关联)
- `school_customer_resource`: 客户资源表 (资源分配统计)
- `school_six_speed`: 六速跟进表 (到访和转化统计)
- `school_contract`: 合同信息表 (续费统计关联)
- `school_performance_config`: 绩效配置表 (绩效计算规则)
- `school_coach_performance`: 教练绩效表 (教练绩效关联)
- `school_sales_performance`: 销售绩效表 (销售绩效关联)

### 关联说明
- **角色关联**: campus_person_role_id关联校区人员角色表，确定统计的具体角色
- **人员关联**: person_id关联人员信息表，确定统计的具体人员
- **校区关联**: 通过角色表间接关联校区信息
- **资源关联**: 资源数量统计来源于客户资源分配记录
- **跟进关联**: 到访数量等数据来源于六速跟进记录
- **合同关联**: 续费数量统计来源于合同续费记录
- **绩效关联**: 统计数据用于绩效计算和考核
- **配置关联**: 统计规则和计算方式参考绩效配置

## 索引建议
- **主键索引**: id (已存在)
- **外键索引**: 
  - campus_person_role_id (角色统计查询)
  - person_id (人员统计查询)
- **业务索引**: 
  - task_date (日期统计查询)
  - role_type (角色类型查询)
- **复合索引**: 
  - (person_id, task_date) (人员日期统计)
  - (campus_person_role_id, task_date) (角色日期统计)
  - (role_type, task_date) (类型日期统计)
  - (person_id, role_type, task_date) (完整统计查询)
- **统计索引**: 
  - (task_date, complete_num) (完成情况统计)
  - (task_date, resource_num) (资源分配统计)
  - (task_date, visit_num) (到访情况统计)

## 注意事项
- **数据完整性**: campus_person_role_id和person_id必须在对应表中存在
- **日期格式**: task_date字段应使用统一的日期格式
- **角色类型**: role_type必须与实际角色类型保持一致
- **数据一致性**: 统计数据应与源业务数据保持一致
- **重复统计**: 避免同一人员同一日期的重复统计记录
- **数据时效**: 统计数据应及时更新，保证数据的时效性
- **计算准确性**: 各项数量统计的计算逻辑应准确无误
- **权限控制**: 人员只能查看自己的统计数据
- **数据备份**: 重要的统计数据需要定期备份
- **异常处理**: 统计过程中的异常情况需要妥善处理
- **性能优化**: 大量统计数据的查询需要优化性能
- **数据清理**: 定期清理过期的统计数据
- **审计追踪**: 统计数据的修改需要记录审计日志
- **报表生成**: 基于统计数据生成的报表需要保证准确性
- **目标对比**: 实际完成数据与目标数据的对比分析
- **趋势分析**: 支持按时间维度的数据趋势分析