# school_sys_schedule 表文档

## 表概述
**表名**: school_sys_schedule  
**功能**: 系统计划任务管理表，用于管理和调度系统中的各种定时任务和周期性任务

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
addon	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	所属插件
key	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	计划任务模板key
status	int	NULL	NO		1		select,insert,update,references	任务状态 是否启用
time	varchar(500)	utf8mb4_general_ci	NO				select,insert,update,references	任务周期  json结构
count	int	NULL	NO		0		select,insert,update,references	执行次数
last_time	int	NULL	NO		0		select,insert,update,references	最后执行时间
next_time	int	NULL	NO		0		select,insert,update,references	下次执行时间
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
delete_time	int	NULL	NO		0		select,insert,update,references	删除时间
update_time	int	NULL	NO		0		select,insert,update,references	更新时间
sort	int	NULL	NO		0		select,insert,update,references	排序
```

## 功能用途

### 主要功能
- **任务调度管理**: 管理系统中各种定时任务的调度和执行
- **插件任务支持**: 支持不同插件模块的专属定时任务
- **任务状态控制**: 控制任务的启用、禁用状态
- **执行周期配置**: 通过JSON结构灵活配置任务执行周期
- **执行统计**: 记录任务的执行次数和执行历史
- **时间管理**: 跟踪任务的最后执行时间和下次执行时间
- **任务排序**: 支持任务的优先级排序和执行顺序
- **任务模板**: 基于key值管理任务模板和配置
- **执行监控**: 监控任务的执行状态和性能

### 业务场景
- **数据同步任务**: 定期同步各系统间的数据
- **报表生成**: 定时生成各类统计报表和分析数据
- **数据备份**: 定期备份重要的业务数据
- **消息推送**: 定时发送通知消息和提醒
- **数据清理**: 定期清理过期数据和临时文件
- **统计计算**: 定时计算业务指标和统计数据
- **系统维护**: 定期执行系统维护和优化任务
- **缓存更新**: 定时更新和刷新系统缓存
- **日志归档**: 定期归档和压缩系统日志
- **健康检查**: 定期检查系统和服务的健康状态
- **数据导入导出**: 定时执行数据的导入导出任务
- **邮件发送**: 定时发送邮件通知和报告

## 关联关系

### 主要关联表
- `school_sys_schedule_log`: 任务执行日志表（任务执行记录）
- `school_sys_addon`: 插件表（任务所属插件）
- `school_sys_cron_task`: 定时任务表（具体的cron任务）
- `school_sys_user`: 系统用户表（任务创建者）
- `school_campus`: 校区表（任务执行范围）
- `school_sys_config`: 系统配置表（任务相关配置）
- `school_sys_log`: 系统日志表（任务执行日志）

### 关联说明
- **插件关联**: addon字段关联到具体的插件模块
- **任务模板**: key字段标识任务模板和配置类型
- **执行日志**: 与执行日志表形成一对多关系
- **时间关联**: 记录任务的创建、更新和执行时间
- **状态关联**: 任务状态影响实际的执行调度
- **配置关联**: time字段存储JSON格式的执行周期配置
- **监控关联**: 与系统监控和告警系统关联

## 索引建议
- **主键索引**: id（已存在）
- **插件索引**: addon（按插件查询任务）
- **任务键索引**: key（按任务模板查询）
- **状态索引**: status（按状态查询活跃任务）
- **时间索引**: 
  - next_time（下次执行时间查询）
  - last_time（最后执行时间查询）
  - create_time（创建时间查询）
  - update_time（更新时间查询）
- **复合索引**: 
  - (status, next_time)（查询待执行任务）
  - (addon, status)（按插件查询活跃任务）
  - (addon, key)（插件任务模板查询）
  - (status, sort)（按状态和排序查询）
- **排序索引**: sort（任务排序）
- **删除状态索引**: delete_time（逻辑删除查询）

## 注意事项
- **时间精度**: 确保执行时间的精确性和时区处理
- **并发控制**: 防止同一任务的重复执行和并发冲突
- **异常处理**: 建立完善的任务执行异常处理机制
- **性能监控**: 监控任务执行的性能和资源消耗
- **日志记录**: 详细记录任务执行的过程和结果
- **配置验证**: 验证JSON格式的时间配置的正确性
- **资源管理**: 合理管理任务执行时的系统资源
- **故障恢复**: 建立任务执行失败的重试和恢复机制
- **权限控制**: 严格控制任务的创建、修改和删除权限
- **数据一致性**: 确保任务状态与实际执行状态的一致性
- **插件依赖**: 处理任务与插件模块的依赖关系
- **时间同步**: 确保服务器时间的准确性和同步
- **任务隔离**: 不同插件的任务应该相互隔离
- **执行超时**: 设置合理的任务执行超时时间
- **负载均衡**: 在多服务器环境下合理分配任务执行
- **备份恢复**: 重要任务配置需要定期备份