主题
配置预警规则
一、功能简介
把"什么情况算异常、发什么内容、什么时候发、发给谁"配置出来。规则本身在预警策略列表里定义，何时发给谁在预警策略组里编排。
二、什么时候用它
- 想让系统在项目工时/成本超过某个比例时自动提醒。
- 想按团队心情做预警（连续低落时提醒管理者）。
- 想定期自动发一份 AI 报告或 AI 周报。
三、开始之前
| 项 | 说明 |
|---|---|
| 入口 | 预警管理 →「预警策略列表」建规则；「预警策略组」做编排 |
| 操作权限 | 没有权限时新增/编辑按钮不显示，请联系管理员开通。 （2026-08 起预警的各项按钮权限统一在**权限中心 →「预警管理 → 预警组管理 / 预警项管理」**菜单下勾选，包含查询/查看/新增/修改/删除，以及「激活失效」「手动触发」「AI 内容预览」「查看预警历史」这几项独立开关。） |
| 先后顺序 | 必须先有规则，再建策略组把规则放进去 |
四、操作步骤
A. 新建一条预警规则
在「预警策略列表」点新增，填：
- 策略名称
- 策略类型（规则） —— 选了类型，下面需要填的字段会自动跟着变
- 触发条件（占比类规则填）或 AI 提示词（AI 类规则填）
- 预警正文
- 发送渠道 —— 邮件 / 企业微信（见 D）
〔待补截图：「新增预警策略」弹窗整体。⚠️ 此处原先误挂了预警中心列表页那张图（不是弹窗），已撤下。〕
B. 选对规则类型
内置这几类（具体清单由后端字典下发，各企业可能不同）：
| 类型 | 要填什么 | 用途 |
|---|---|---|
| 项目工时占比 | 触发占比区间 | 工时快用完时提醒 |
| 项目成本占比 | 触发占比区间 | 成本超支预警 |
| 日报心情 | 勾选心情档位（共 7 档） | 团队情绪关注 |
| AI 报告 | AI 提示词 + 关联报表字段 | 让 AI 生成一段分析 |
| AI 周报 | AI 提示词 + 日报时间范围 | 定期自动周报 |
- 占比类填的是 0～1 的小数区间（比如 0.8～1 表示 80%～100%）。
- AI 类没有占比字段，改填提示词。
- AI 周报的关联报表只能选「日报数据」。
C. 写预警正文（支持变量）
正文分三段：前置描述 / 正文 / 结尾。正文里可以用 ${...} 变量，发送时自动替换成真实数据。
- 点「表达式替换说明」可以看到当前类型能用哪些变量（按公共 / 工时 / 成本 / 心情分组）。
- 常见变量：项目名、工时占比、成本占比、人员姓名、心情等。
- 新建时切换类型会自动带出默认模板；编辑已有规则时不会覆盖你已经写好的正文。
〔待补截图 2：预警正文编辑区 + 点开的「表达式替换说明」，框住可用变量清单。〕
D. AI 类规则可以先预览
选了 AI 报告 类型后，填好提示词并选好关联报表与字段，可以点「预览 AI 生成内容」先看看 AI 会写出什么（按 Markdown 渲染）。
目前只有「AI 报告」支持预览，其它类型会提示暂不支持。
E. 建策略组：把规则编排起来
在「预警策略组」新增，需要配三个子表（至少各一条）：
- 预警策略 —— 选这个组要用哪几条规则
- 预警通知时间 —— 什么时候发（见下）
- 预警项目集及通知角色 —— 发给谁（见下）
另有预警通知个人（可选），可直接指定具体的人。
配好后把策略组激活，它才会跑。
F. 设通知时间
支持几种触发方式：
| 方式 | 说明 |
|---|---|
| 时间间隔 | 按周或按月 + 固定日期 |
| 相对时间 | 以某个标记日期为基准，前后 ± 若干自然日 |
| 特定日期 | 指定某一天 |
| 间隔天数 | 首次日期 + 每隔 N 天 |
还可以设发送时间，以及统计数据的截止口径（发送时间前一天 23 点 / 发送时间前 2 小时）。
〔待补截图 3：策略组编辑弹窗的「预警通知时间」子表，框住触发方式下拉与发送时间。〕
G. 定通知对象
两种方式，可同时用：
- 按项目集角色：选项目集(模板) → 选项目范围（全部项目或指定项目）→ 选角色。适合"所有项目的项目经理都通知到"。
- 按个人：直接指定具体的人（重复添加会自动去重）。
项目集角色这条必须选了项目范围且至少选一个角色才算完整。
D. 推到企业微信
除了邮件，预警还能推到员工的企业微信里，内容是摘要 + 一条预览链接（点链接回系统看全文）。
怎么开：企业先在 SaaS 侧配好自己的企业微信应用 → 回到 预警中心 → 策略组 → 编辑策略组 →「预警通知渠道」勾上「企业微信」。
⚠️ 企业没配企业微信时，这个选项是灰的，勾不上。
⭐ 勾了却收不到？按这个顺序查（四道开关全通过才会发，任何一道不通过都是「静默不发」，页面上不会报错）：
| 顺序 | 检查什么 | 找谁 |
|---|---|---|
| ① | 三方渠道总开关是否打开 | 运维 |
| ② | 企业微信渠道开关是否打开 | 运维 |
| ③ | 本企业的企业微信配置是否 enabled | 企业管理员 / 运营后台 |
| ④ | 旧的业务开关（为兼容老部署保留的那一道） | 运维 |
因为四道都是静默的，光看策略组里勾没勾是查不出问题的，必须让运维照上面的顺序逐道看日志。
另外，系统本身不保存企业微信的密钥（只用到 enabled 和 corpId），凭据留在企业微信侧；企业微信服务临时不可用时，该企业本次判定为不可发。
五、字段与选项说明
| 字段 | 说明 |
|---|---|
| 触发占比区间 | 0～1 的小数，如 0.8～1 表示 80%～100% |
| 是否只发一次 | 控制同一条件是否重复提醒 |
| 发送渠道 | 邮件；企业配好企业微信后还可勾选企业微信（见下） |
| 状态 | 规则/策略组可激活或失效 |
六、常见问题与注意事项
- 规则建好了但没动静 —— 规则必须被放进策略组、且策略组要激活。单条规则不会自己跑。
- 策略组存不下去 —— 策略、通知时间、项目集角色三个子表至少各一条；通知个人可以为空。
- AI 周报的关联报表只能选「日报数据」 —— 这是固定的，选别的会被限制。
- 只有 AI 报告能预览 —— 其它类型点预览会提示暂不支持。
- 编辑时正文不会被模板覆盖 —— 这是有意保护你已写的内容；如果想用新模板，需要自己清空重填。
- 变量写错不会报错，但会原样发出去 —— 建议先用「表达式替换说明」核对变量名。