# school_performance_records 表文档

## 表概述
**表名**: school_performance_records  
**功能**: 绩效记录管理表，负责管理教务系统中员工的绩效评估、考核记录、绩效指标跟踪和绩效奖励计算等功能

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	绩效编号
staff_id	int	NULL	NO		NULL		select,insert,update,references	员工ID
resource_id	int	NULL	NO		NULL		select,insert,update,references	资源ID
order_id	int	NULL	YES		NULL		select,insert,update,references	订单ID
order_status	enum('pending','completed','cancelled')	utf8mb4_general_ci	YES		pending		select,insert,update,references	订单状态: pending-待处理, completed-已完成, cancelled-已取消
performance_type	enum('sales','marketing','other','coach','consultant')	utf8mb4_general_ci	NO		NULL		select,insert,update,references	绩效类型: sales-销售绩效, marketing-市场绩效, coach教练绩效，other-其他，consultant教务绩效
performance_value	decimal(10,2)	NULL	NO		NULL		select,insert,update,references	绩效金额
remarks	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	备注
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	修改时间
```

## 功能用途

### 主要功能
- **绩效记录管理**: 记录员工的各类绩效数据和业绩表现
- **绩效类型分类**: 区分销售、市场、教练、教务等不同类型绩效
- **绩效金额计算**: 计算和记录具体的绩效奖励金额
- **订单关联**: 关联具体订单跟踪绩效来源
- **资源关联**: 关联客户资源跟踪转化绩效
- **状态跟踪**: 跟踪订单状态对绩效的影响
- **绩效统计**: 提供各类绩效数据的统计分析
- **奖金计算**: 为薪资系统提供绩效奖金数据
- **业绩分析**: 分析员工业绩趋势和表现

### 业务场景
- **销售绩效**: 记录销售人员的签单业绩和提成
- **市场绩效**: 记录市场人员的获客和转化业绩
- **教练绩效**: 记录教练的授课和学员满意度绩效
- **教务绩效**: 记录教务人员的服务质量绩效
- **订单跟踪**: 跟踪订单完成情况对绩效的影响
- **客户转化**: 记录客户资源转化带来的绩效
- **月度结算**: 月度绩效统计和奖金结算
- **业绩排名**: 员工业绩排名和激励
- **绩效分析**: 分析绩效趋势和改进方向

## 关联关系

### 主要关联表
- `school_personnel`: 人员信息表 (staff_id)
- `school_customer_resources`: 客户资源表 (resource_id)
- `school_order_table`: 订单信息表 (order_id)
- `school_salary`: 薪资管理表 (绩效奖金关联)
- `school_contract`: 合同信息表 (签约绩效)
- `school_member`: 会员信息表 (客户关联)
- `school_campus`: 校区信息表 (校区绩效)
- `school_course`: 课程信息表 (教练绩效)

### 关联说明
- **员工关联**: staff_id关联具体员工，确定绩效归属
- **资源关联**: resource_id关联客户资源，跟踪转化绩效
- **订单关联**: order_id关联具体订单，跟踪销售绩效
- **薪资关联**: 绩效金额直接影响薪资中的绩效奖金计算
- **合同关联**: 通过订单关联合同，跟踪签约绩效
- **会员关联**: 通过资源和订单关联会员，跟踪服务绩效
- **校区关联**: 通过员工关联校区，支持分校区绩效统计
- **课程关联**: 教练绩效关联具体授课课程

## 索引建议
- **主键索引**: id (已存在)
- **外键索引**: 
  - staff_id (员工绩效查询)
  - resource_id (资源绩效查询)
  - order_id (订单绩效查询)
- **业务索引**: 
  - performance_type (绩效类型查询)
  - order_status (订单状态查询)
  - performance_value (绩效金额查询)
- **复合索引**: 
  - (staff_id, performance_type) (员工类型绩效查询)
  - (staff_id, created_at) (员工时间绩效查询)
  - (performance_type, created_at) (类型时间绩效统计)
  - (order_status, performance_type) (状态类型绩效查询)
- **时间索引**: 
  - created_at (创建时间查询)
  - updated_at (更新时间查询)

## 注意事项
- **绩效类型**: performance_type字段使用枚举类型，严格控制类型范围
- **订单状态**: order_status影响绩效计算，需要实时同步
- **金额精度**: performance_value使用decimal(10,2)确保金额精度
- **数据完整性**: staff_id、resource_id、performance_type等关键字段不能为空
- **重复记录**: 避免同一业务产生重复的绩效记录
- **实时更新**: 订单状态变化时需要及时更新绩效记录
- **权限控制**: 绩效数据访问需要严格的权限控制
- **薪资同步**: 绩效数据需要与薪资系统保持同步
- **业绩统计**: 支持按时间、类型、员工等维度统计绩效
- **异常监控**: 监控异常绩效数据和计算错误
- **审计追踪**: 保留完整的绩效记录变更轨迹
- **数据备份**: 绩效数据需要定期备份和归档
- **计算规则**: 不同绩效类型的计算规则需要明确定义
- **时效性**: 绩效记录需要及时生成，避免延迟
- **关联验证**: 确保resource_id和order_id的有效性
- **状态一致性**: 订单状态与绩效状态保持一致
- **分润规则**: 多人参与的业务需要明确分润规则