十七、人事合同预警
人事合同预警用于合同到期、试用期到期、续签节点的自动化提醒，避免因遗忘导致用工风险。整体分两块：
- 预警规则：定义「提前多少天、提醒谁、怎么提醒」
- 预警记录：定时任务扫描生成的预警明细与处理台账
text
配置预警规则（类型 / 提前天数 / 通知方式）
↓ 定时任务 hrmContractWarningJob（建议每天凌晨 1 点执行）
扫描 [今天, 今天 + N天] 内到期的合同
↓ 同合同同规则当天去重
生成预警记录 ──→ 发送通知（系统消息 / 邮件 / 短信 / 钉钉 / 企业微信）
↓
HR 在预警记录中查看并【处理】闭环17.1 预警规则
菜单入口：HRM人力 → 人事合同预警 → 预警规则
页面操作：查询、新增、编辑、删除、导出
新增 / 编辑规则分基本信息、通知配置、执行配置三个页签：
① 基本信息
| 字段 | 说明 |
|---|---|
| 规则名称 / 规则编码 | 规则标识 |
| 规则类型 | 到期预警 / 试用期到期 / 续签提醒 |
| 提前天数（warningAdvanceDays） | 提前 N 天开始预警 |
| 预警级别 | 一般（1） / 重要（2） / 紧急（3） |
| 预警范围 | 全体员工 / 指定部门 / 指定员工（后两项需再选部门 / 员工） |
| 排序号 | 规则展示顺序 |
② 通知配置
| 字段 | 说明 |
|---|---|
| 通知方式 | 多选：系统消息（站内）、邮件、短信、钉钉、企业微信 |
| 通知对象 | 员工本人 / 直属上级 / HR 部门 / 自定义（自定义需再选人员） |
| 消息标题 / 消息模板 | 通知内容，模板支持插入变量（如剩余天数、预警级别、规则名称） |
③ 执行配置
| 字段 | 说明 |
|---|---|
| 是否启用 | 总开关，停用后任务不再按此规则扫描 |
| 执行频率 | 每天一次 / 每周一次 / 每月一次 |
| 执行时间 | 任务执行时点 |
| 备注 | 补充说明 |
业务规则（重要）：
- 预警由定时任务
hrmContractWarningJob驱动，建议配置为每天凌晨 1 点执行；任务按启用规则扫描 [今天, 今天 + 提前天数] 区间内到期的合同，命中即生成预警记录并发送通知 - 同一合同 + 同一规则当天只生成一条预警记录（自动去重），跨天会再次提醒直至处理或过期
- 通知渠道按规则中勾选的方式发送，站内消息必达，邮件 / 短信 / 钉钉 / 企业微信依赖对应通道的系统配置
17.2 预警记录
菜单入口：HRM人力 → 人事合同预警 → 预警记录
页面操作：查询、新增、编辑、删除、导出、处理
页面顶部提供未处理 / 已处理统计卡；查询条件：员工姓名、合同编号、预警类型（合同到期 / 试用期到期 / 续签提醒）、预警级别（一般 / 重要 / 紧急）、处理状态（未处理 / 已查看 / 已处理）、发送状态（待发送 / 发送成功 / 发送失败）。
列表展示：员工姓名、合同编号、预警类型、预警级别、剩余天数、合同期限、预警规则、发送状态、处理状态、发送时间、处理时间；行内操作：
- 【详情】：查看预警完整信息
- 【处理】：仅「未处理」状态显示，填写处理动作完成闭环（处理后状态流转为已查看 / 已处理）
- 【删除】：清理无效记录
业务规则：
- 记录由定时任务自动生成（也支持手工新增补录），剩余天数随扫描日动态计算，是催办处理的直接依据
- 处理状态流转：未处理（0）→ 已查看（1）→ 已处理（2）；建议 HR 每日上班先过滤「未处理 + 紧急」优先跟进
- 典型用法：合同到期前 30 天（一般）提醒摸底 → 前 7 天（重要）推动续签决策 → 前 3 天（紧急）升级至部门负责人
