两套页面,同一套规则:水泵房与机房接入统一告警的边界
给水泵房和机房各加一套告警页面,最省事的做法可能是复制页面、复制规则,再复制一份后端逻辑。真正难维护的也正是这些副本。这次接入选择另一条路:页面只做薄包装,规则 ID、关联配置、记录处置和权限继续复用统一告警实现。
🎧 文章导读
复用不是把旧页面换个菜单名
这次需求是在水泵房监测、机房监控下分别增加“告警规则”和“告警记录”,同时保留原环境监控及统一告警入口。两个新业务分别使用固定的业务范围参数,列表、统计、详情、导出和站内信跳转都必须沿同一范围收敛。
图 1:新增的是业务入口,不是另一套规则数据和处置链路。
前端复用环境监控的共用组件,各业务只保留薄包装页面;后端继续走共享规则和统一告警记录接口。校验的重点不只是“传了业务范围”,还包括园区、规则级归属和可编辑字段:保存规则时不能借修改接口篡改规则身份或业务类型。
规则仍使用原 ID,也不重新初始化一套水泵房、机房规则。这意味着原来配置的流程、设备、预置位、显示屏和通知接收人都能保留,统一入口与新业务入口看到的是同一份事实。
这也带来一条验收标准:不能只看新页面“有数据”。还要确认原入口数据没有翻倍,编辑后另一个入口读到的是同一规则,导出结果不会混入其他业务。
数值型与状态型,不能共用一个阈值解释
接入时有一个很容易误读的字段:threshold_status。在本次规则配置里,它决定编辑和判断方式,不是设备上报的“当前告警状态”。
图 2:配置模型不同,不能为了复用页面而强行统一成数值比较。
threshold_status=0:按数值阈值配置和比较,例如压力、温度或湿度上限。threshold_status=1:沿用状态型告警处理,不提供数值阈值编辑,例如某些设备异常状态。
原记录中的边界样本很能说明问题:压力规则为 >20 时,19 和 20 不触发,21 触发;连续 22 会合并到未关闭告警,计数变为 2。停用规则或不在执行时间内,同样不应触发。状态型样本则不需要数值阈值,也能生成记录。
规则原值也不能在接入时顺手“修正”。导出配置中有一条机房湿度规则的单位写成了温度单位,语义明显可疑,但本次只记录并保留原值,等待业务确认。复用存量规则意味着连历史问题一起继承,不意味着开发者可以替业务改阈值。
权限与通知要沿链路验证
新页面沿用现有的处理、忽略、工单、导出和数据权限逻辑。只读角色可以查看,但应优先拒绝写操作;普通用户则按既有分派和处理权限执行。前端不显示按钮只是交互表现,直接调用后端接口仍必须被拒绝。
站内信接入现有持久化链路后,还要验证两个动作:刷新页面消息仍在,点击后进入对应业务的告警记录,并携带告警编号定位。只验证“弹出来了”,覆盖不到持久化和跳转;只验证通知存在,也证明不了接收人拥有处置权限。
原笔记记录了完整链路的本机验证:从真实接收入口送入“已经接收、解析后”的模拟事件,后续规则匹配、告警记录、站内信和 BPM 都走真实实现。相关检查包括 41 项接口/数据库检查、14 项浏览器检查,并补做只读角色页面验证;后续精简和合并主分支后,相关后端 36 项、前端 13 项测试及改动文件 ESLint 通过。
这些数字都有边界。测试没有启动上游 MQ、物联网或环境服务,也没有验证设备状态位的产生过程;BPM 完成动作由有权限的处理人调用真实接口执行,不是浏览器点击。它们证明的是本机目标链路,不是生产端到端验收。
上线清单里最容易混淆的四件事
这次新增迁移只负责菜单和编辑功能点,不创建告警业务表,不新增业务字段,也不初始化新规则。目标环境若尚未具备此前环境告警和统一告警的迁移,不能只执行这一个菜单脚本。
| 事项 | 原记录中的状态 | 不能推导出的结论 |
|---|---|---|
| 前后端源码 | 已合并并推送项目远端主分支 | 不等于生产服务已更新 |
| 菜单迁移 | 已有可重复执行的脚本 | 不等于目标库已经执行 |
| 本机规则数据 | 只补入目标规则及关联用于验证 | 不应导入生产,也不能替代生产配置 |
| 生产运行包 | 最终合并版本未重新制作部署包 | 旧运行包不包含最后精简优化 |
这里尤其要把“代码推送”和“最终包部署”分开。初轮本机运行包包含通知修复,后续优化虽然完成编译、测试和提交,却没有重新打包并重启到最终主分支版本。上线时应从最新主分支重新构建,而不是拿本机现有包凑数。
这次接入的价值不在于少了几个前端文件,而在于避免了规则、权限和处置流程的多份真相。相应的验收也不能停在页面可见:同 ID、业务隔离、只读拒绝、通知定位、迁移前置和部署包版本,缺一项都可能让“复用成功”变成误判。
延伸阅读
本文根据 2026 年 10 月 23 日工程笔记整理。业务标识和内部路径已省略;测试结果均为原记录结果,本次整理未重新执行业务测试或生产部署。