# school_jobs 表文档

## 表概述
**表名**: school_jobs  
**功能**: 队列任务管理表，负责管理教务系统中的异步任务队列，支持任务调度、重试机制和任务状态跟踪

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
queue	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
payload	longtext	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
attempts	tinyint unsigned	NULL	NO		0		select,insert,update,references	
reserve_time	int unsigned	NULL	YES		0		select,insert,update,references	
available_time	int unsigned	NULL	YES		0		select,insert,update,references	
create_time	int unsigned	NULL	YES		0		select,insert,update,references	
```

## 功能用途

### 主要功能
1. **队列任务管理**: 管理系统中的异步任务队列
2. **任务负载存储**: 通过payload字段存储任务的具体数据和参数
3. **重试机制**: 通过attempts字段跟踪任务的执行次数
4. **任务调度**: 通过reserve_time和available_time控制任务的执行时机
5. **队列分类**: 通过queue字段对不同类型的任务进行分类管理
6. **任务状态跟踪**: 跟踪任务的执行状态和进度
7. **延迟执行**: 支持任务的延迟执行和定时调度
8. **失败重试**: 自动重试失败的任务，提高系统可靠性
9. **任务监控**: 监控任务队列的执行情况和性能

### 业务场景
1. **邮件发送**: 异步处理邮件发送任务，避免阻塞主流程
2. **数据导出**: 处理大量数据的导出任务，如成绩单、报表等
3. **文件处理**: 处理文件上传、转换、压缩等耗时操作
4. **通知推送**: 批量发送系统通知、短信、微信消息等
5. **数据同步**: 与第三方系统进行数据同步和交换
6. **定时任务**: 执行定时的数据清理、备份、统计等任务
7. **图片处理**: 处理图片的缩放、裁剪、水印等操作
8. **报表生成**: 生成复杂的统计报表和分析数据
9. **系统维护**: 执行系统清理、优化、更新等维护任务

## 关联关系

### 主要关联表
1. **school_sys_user**: 系统用户表（任务创建者关联）
2. **school_campus**: 校区表（任务校区关联）
3. **school_sys_config**: 系统配置表（队列配置关联）
4. **school_addon**: 插件表（插件任务关联）
5. **sys_log**: 系统日志表（任务执行日志关联）
6. **school_sys_attachment**: 附件表（文件处理任务关联）
7. **school_order_table**: 订单表（支付任务关联）
8. **school_member**: 会员表（通知任务关联）

### 关联说明
1. **队列分类**: queue字段标识任务类型和处理队列
2. **任务数据**: payload字段存储任务的具体执行参数
3. **执行控制**: reserve_time和available_time控制任务执行时机
4. **重试机制**: attempts字段记录任务重试次数
5. **时间管理**: create_time记录任务创建时间
6. **状态跟踪**: 通过时间字段判断任务执行状态
7. **业务关联**: 任务可能关联到各种业务表的数据处理
8. **系统集成**: 与系统配置和日志系统集成

## 索引建议
1. **主键索引**: id（已存在）
2. **业务索引**:
   - queue（队列类型查询）
   - attempts（重试次数查询）
3. **时间索引**:
   - reserve_time（预约时间查询）
   - available_time（可用时间查询）
   - create_time（创建时间查询）
4. **复合索引**:
   - (queue, available_time)（队列可用任务查询）
   - (queue, attempts)（队列重试任务查询）
   - (available_time, attempts)（可执行任务查询）
5. **状态索引**:
   - (reserve_time, available_time)（任务状态查询）

## 注意事项
1. **队列名称**: queue字段应使用标准的队列命名规范
2. **负载格式**: payload字段应存储有效的JSON或序列化数据
3. **重试限制**: attempts字段应设置合理的重试上限，避免无限重试
4. **时间精度**: 时间字段使用Unix时间戳，注意时区处理
5. **任务超时**: 长时间未处理的任务需要超时机制
6. **并发控制**: 同一任务避免重复执行，需要锁机制
7. **内存管理**: payload字段可能存储大量数据，注意内存使用
8. **错误处理**: 任务执行失败需要记录详细的错误信息
9. **队列监控**: 需要监控队列长度和处理速度
10. **数据清理**: 已完成的任务需要定期清理，避免表过大
11. **优先级管理**: 重要任务需要优先级机制
12. **死锁检测**: 避免任务间的死锁情况
13. **资源限制**: 控制并发任务数量，避免系统资源耗尽
14. **备份恢复**: 重要任务数据需要备份和恢复机制
15. **性能优化**: 大量任务处理时需要考虑性能优化
16. **安全控制**: 任务执行需要适当的权限和安全控制