预警提醒
按模块里"到期日期字段"自动扫描:红色=已逾期、黄色=临期、蓝色=临近,办结类记录(如医保已缴、隐患已整改)扫描时会自动消解,不用手动清。
1. 谁能用
「预警提醒」是仅管理员可见可用的功能。左侧菜单只有 admin 角色能看到这一项,所有相关接口(查看列表、Snooze、办结、触发扫描)后端都会校验角色,不是 admin 一律拒绝,提示"仅管理员可操作预警"。如果系统关闭了账号密码登录(单机模式),所有操作都以 superadmin 身份进行,等同管理员,可以直接用。
2. 预警规则是什么
一条预警规则 = "某个模块的某个日期字段 + 到期算法 + 提前预警天数"。到期算法(due_type)有 4 种:
| 算法 | 截止日怎么算 | 举例 |
|---|---|---|
direct | 日期字段的值本身就是截止日 | 残疾证到期日、公益岗合同到期日 |
year_end | 取日期所在年份,截止日固定是当年 12 月 31 日 | 医保缴费年度 |
annual_upcoming | 取这个日期"距今最近的下一个周年" | 低保年审日期(第一次登记日往后每年提醒一次) |
offset_days | 日期字段的值 + N 天(N 可正可负) | 整改时限提前/延后若干天提醒 |
算出截止日后,按"距今天数"分级:已过期(负数)= 红;0 到"临期天数"以内 = 黄;超过临期天数但在"临近天数"以内 = 蓝;超过临近天数不告警。规则还能配一个"办结字段"和一组"办结值",当那条记录该字段的值命中办结值列表时(比如"缴费状态"="已缴"或"减免"),这条告警会自动转成"自动消解",不需要人工处理。
预警规则的新建/修改/删除只有后端接口,还没有接到任何页面按钮上,界面上看不到规则配置表单。部分模块模板在"建议预警规则"里声明了推荐配置,但那只是说明文字,导入模板不会自动帮你建规则。也就是说:如果没有人通过技术手段单独配置过规则,「预警提醒」页面通常是空的——这是当前版本的已知限制。日常能做的只是查看和处理"已经存在的"告警。
3. 页面组成
页面顶部是三张统计卡:已逾期(红)、临期(黄)、临近(蓝),点一张卡可以按对应级别筛选列表,再点一次取消筛选。下面是四个 Tab 切页:
| Tab | 含义 |
|---|---|
| 待办 | 还没处理的告警,红/黄/蓝三色都在这里 |
| 已 Snooze | 被推后处理的告警 |
| 已办结 | 手动标记办结的告警 |
| 自动消解 | 办结字段命中/记录已删除,系统自动清掉的告警 |
列表每行显示:级别、规则名、所属模块、对象(点击可跳转到具体那条记录)、截止日、距今天数。
4. 触发扫描
点页面右上角"立刻扫描"手动触发一次全量扫描;系统后台每小时也会自动扫描一次,逻辑完全一样,不需要人一直点。扫描会遍历规则所在模块的所有未删除记录,按上面的算法重新计算级别和截止日;已经办结/自动消解的记录不会再被重新拉回来打扰你;如果一条记录被彻底删除(不是移进回收站),它挂着的"待办"或"已 Snooze"告警会在下次扫描时自动转成"自动消解",不会一直卡在列表里。扫描完成后会弹出提示,例如"扫描完成:3 条规则,新增 2、刷新 5、自动消解 1"。
5. 处理告警
在"待办"Tab 下,每行有两个操作按钮:
- Snooze(推后):填"推到"日期(默认明天)和理由(必填,用于合规留痕),点"推后"后这条告警转到"已 Snooze",等到了那天再由下次扫描重新变回待办(如果还没解决)。
- 办结:填办结说明(必填,如"已通知村民缴费"),点"办结"后这条告警转到"已办结",不会再出现在待办里。
Snooze 和办结的操作说明都会记录到操作日志,方便事后核查。