【程序设计】定时任务调度平台需求说明书

1. 定时任务调度平台需求说明书
1.1. 概述
本文档详细的描述了定时任务的需求，明确了定时任务的开发内容。供需求人员、设计人员、开发人员、测试人员参考。
定时任务包含任务管理、任务执行、任务预警、日志查询、回调接口、预警服务六部分内容。
1.2. 任务管理
1.2.1. 任务分类
任务分为两种类型：
任务一：周期性的执行业务处理任务
我们采用定时时间、前置任务想结合的方式解决任务的串并行需求。任务执行流程：

1. 按照设定的时间启动定时任务；
2. 当前任务执行前需要检查该任务是否存在前置任务；
3. 若存在前置任务则检查前置任务是否执行成功，若执行成功则继续执行本次任务，若执行失败则停止执行本次任务，并标记为执行我失败，执行日志中描述失败原因为前置任务执行失败；
4. 若不存在前置任务则直接执行本次任务；
5. 业务系统执行完成任务后，回调定时任务接口，通知任务执行结果。

任务二：启动某个任务，定期监控该任务的运行状态
启动某个任务，定期监控该任务的运行状态，若监控到任务停止，记录任务日志，报警并重新启动任务；若任务正常运行则，只记录任务日志。
1.2.2. 新增任务
新增定时任务，包含任务编号、任务名称、任务描述、定时表达式、获取操作记录数URL、任务执行URL、任务执行效率、预警秒数。

1. 任务编号为系统自动生成；
2. 通过表达式编辑器简单灵活的设置定时表达式；
3. 任务执行效率=（获取到的记录数/实际的执行时间【秒】），多次累加求平均值；
4. 预估执行时间=根据本次获取到的记录数/任务执行效率，如果预估执行时间大于预警秒数，则发出短信、邮件报警；
5. 新增任务默认为停用状态。

1.2.3. 修改任务
在任务停用的状态下可以修改任务。
1.2.4. 查看任务
查看任务详情。
1.2.5. 删除任务
在任务停用的状态下可以删除任务，非物理删除，使用删除标记。
1.2.6. 查询任务
根据任务编号、任务名称、启停状态查询任务。
1.2.7. 设置前置任务
在任务停用的状态下，设置当前任务的前置任务，为一对多关系。
1.2.8. 启用、批量启用任务
将任务状态设置为启用状态。
1.2.9. 停用、批量停用任务
将任务状态设置为停用状态。
1.3. 任务执行
1.3.1. 手动执行
在界面中提供手工执行的按钮，操作人员手工点击按钮执行该任务，在任务日志中标示此次任务的执行方式为手工执行。
1.3.2. 自动执行
根据定时规则自动执行该任务。
1.4. 任务预警
1.4.1. 预警人员配置
添加预警人员，包含姓名、手机号、邮箱。
1.4.2. 预估时间预警
预估执行时间=根据本次获取到的记录数/任务执行效率，如果预估执行时间大于预警秒数，则发出短信、邮件报警。
1.4.3. 实际执行时间报警
实际执行时间大于预警秒数，则发出短信、邮件报警。
1.4.4. 任务执行失败报警
当某个任务执行失败，则发出短信、邮件报警。
1.5. 日志查询
1.5.1. 任务日志查询
查询每次任务的执行方式、监听时间、监听状态、要操作的记录数、当前已经操作的记录数、处理进度（%）、执行时间、执行状态等。
1.5.2. 任务执行进度日志查询
查询【执行进度回调接口】的日志。包括日志编号、创建时间、当前已处理的记录数。
1.6. 回调接口
1.6.1. 处理结果回调接口
将当前任务的执行结果通知给定时服务。处理结果为：1-处理成功，2-处理失败
1.6.2. 执行进度回调接口
将当前任务的执行进度通知给定时服务。定时服务用来展示任务处理进度，回调粒度由要适中，建议5%，10%，15%，20%……100%。
1.7. 预警服务
1.7.1. 短信服务
提供短信服务接口，将预警信息发送给响应的用户。
1.7.2. 短信查询
查询发送的短信信息。
1.7.3. 邮件服务
提供邮件服务接口，将预警信息发送给响应的用户。
1.7.4. 邮件查询
查询发送的邮件信息。