Atlas CMMS预防性维护设置指南:如何自动排期并触发仪表维护工单
Atlas CMMS预防性维护设置指南:如何自动排期并触发仪表维护工单
Atlas CMMS 是一款免费、自托管的 CMMS(计算机化维护管理系统)Web 与移动端应用。本文讲解 Atlas CMMS 预防性维护(Preventive Maintenance)的完整设置方法:如何为设备创建自动排期计划,让系统按计划自动生成维护工单,以及如何通过仪表(Meter)读数触发条件自动产生工单,实现"按时间 + 按使用量"双维度维护。
预防性维护的两种自动触发方式
Atlas CMMS 的维护自动化有两条互补的路径:
| 方式 | 触发依据 | 适用场景 |
|---|---|---|
| 周期性排期(Schedule) | 按天 / 周 / 月 / 年自动运行 | 润滑、巡检、定期保养等固定节奏维护 |
| 仪表触发(Meter Trigger) | 仪表读数超过 / 低于设定阈值 | 按里程、小时数、压力等使用量维护 |
两者的核心逻辑都写在后端:排期由 Quartz 任务 WorkOrderCreationJob.java 在到点时调用 PreventiveMaintenanceController.java 所在服务自动建单;仪表触发则由 ReadingService.java 在每次记录读数时校验触发条件并创建工单。
第一步:创建预防性维护任务并配置自动排期
进入 Web 端的 Preventive Maintenance(预防性维护) 页面(访问路径为 /app/preventive-maintenances),点击右上角 Add 按钮,表单中会分为两大区块:Trigger Configuration(触发配置) 与 WO Configuration(工单配置),字段定义见 index.tsx。
排期相关的关键字段如下:
- Trigger Name:触发器名称,如"冷却泵月度保养";
- Based On(排期依据):
SCHEDULED_DATE(按计划日期):按固定周期自动运行;COMPLETED_DATE(按完成日期):上一张工单完成后,再按周期计算下一次,适合"干完一批再排下一批"的场景;
- Starts On / Ends On:排期的开始与结束日期(结束日期可选);
- Frequency + 周期类型:支持 DAILY(每 N 天)、WEEKLY(每 N 周)、MONTHLY(每 N 月)、YEARLY(每 N 年);选择 WEEKLY 时还需勾选 On(具体星期几),见 index.tsx;
- Due Date Delay:工单到期日相对排期日的顺延天数,字段定义见 Schedule.java。
WO Configuration 区块则决定自动生成工单的内容:标题、优先级、预估工期、指定资产 / 地点 / 负责人 / 团队、附件图片、任务清单(Tasks),还可以开启 Requires Signature(需要签名)。
💡 小技巧:如果多台设备保养内容相同,可以先创建一条 PM 任务,然后通过右上角菜单选择 Copy(复制),快速派生出新计划,无需重复填写。
第二步:了解工单如何自动生成与提前提醒
排期保存后,系统会在 ScheduleService.java 中注册 Quartz 定时任务,按所选周期自动执行,全程无需人工干预:
- 到点自动建单:
WorkOrderCreationJob触发时,校验排期未被停用、未超出周期间隔,然后基于 PM 模板生成一张新工单,直接进入工单列表待办; - 提前邮件提醒:在"公司设置 → 常规偏好"中可配置 提前 N 天发送 PM 通知(
daysBeforePMNotification),系统在工单生成前 N 天通过 PreventiveMaintenanceNotificationJob.java 向相关人员和管理员发送邮件; - 自动停更保护:若最近 5 张工单全部无人处理(从未开始处理),排期会自动标记为
disabled(页面上显示 Paused 暂停),避免工单无限堆积。
打开任意一条 PM 详情(PMDetails.tsx),可以查看 Trigger Details(排期依据、起止日期、频率描述)与 Recent Work Orders(近期工单) 两个标签页,直观确认自动排期是否在正常运转。
第三步:用仪表读数触发"按使用量"维护工单
对于"每运转 500 小时保养一次"这类场景,时间排期不够用,此时用 Meter(仪表)触发:
- 在 Meters 页面创建仪表(访问路径
/app/meters),绑定到对应资产,如"运行小时数"、"里程",单位为小时或公里; - 打开仪表详情页(MeterDetails.tsx),在 WO Triggers(工单触发器) 标签页点击 Add Trigger,填写 AddTriggerModal.tsx 中的字段:
- Trigger Name:触发器名称;
- When Reading Is:
Greater Than(读数大于)或Less Than(读数小于); - Value:阈值,单位自动取自仪表单位;
- WO Configuration:同 PM 一样配置生成的工单标题、优先级、负责人、资产等;
- 之后每当员工在 Web 端或 移动端 App 录入一次读数,系统立即检查所有触发器:一旦读数越限,自动生成对应维护工单,同时推送应用内通知,并可向外发送 Webhook 事件,详见 ReadingService.java。
仪表详情中还内置读数历史图表,可以直观看到读数曲线与阈值线的关系,帮助确认触发时机是否符合预期。
手动触发工单与日常维护技巧
除了自动排期,Atlas CMMS 也保留了手动干预能力,方便应对临时计划外的维护:
- 手动触发:在 PM 详情页右上角菜单中选择 Trigger Work Order,立即按模板生成一张工单并跳转查看(实现见 PMDetails.tsx);
- 暂停 / 恢复排期:通过 Edit 调整排期或临时禁用,页面上会显示 Paused 状态;
- 修改排期:编辑
startsOn、频率等字段后,系统会重建定时任务,无需重启; - 权限控制:只有具备 PREVENTIVE_MAINTENANCES 创建 / 编辑权限的角色才能管理 PM 任务,适合分配给维护主管。
常见问题(FAQ)
Q1:工单到期后没人处理,为什么排期停了? 这是防堆积保护机制:最近 5 张工单若都未被开始处理,排期自动暂停。处理完积压工单后,重新编辑并保存该 PM 排期即可恢复。
Q2:按完成日期(COMPLETED_DATE)排期,第一张工单什么时候生成?
第一次按 startsOn 生成;此后每次以最近一张已完成工单的完成日期为基准,叠加一个周期(N 天 / 周 / 月 / 年)自动排下一次。
Q3:移动端能录入仪表读数吗? 可以。移动端 App 支持扫码、离线查看工单,并录入读数,读数一旦越限同样会触发自动建单,详见 mobile/ 目录下的 Meters 相关页面。
Q4:如何确认自动排期真的生效了? 打开 PM 详情页的 Recent Work Orders 标签,若系统按计划周期性地产出工单,即表示 Quartz 任务运行正常;也可以检查是否收到了"工单即将生成"的提前提醒邮件。
总结
通过本文介绍的方法,你可以用 Atlas CMMS 在 10 分钟内完成:① 基于日历的周期性维护排期;② 自动生成维护工单与提前邮件提醒;③ 基于仪表读数阈值的"按使用量"触发。时间计划与使用量触发两者结合,就能覆盖绝大多数设备的预防性维护场景,真正把"被动抢修"变成"主动保养"。
更多功能页面源码可参考:PreventiveMaintenance 模块、Meters 模块、Quartz 定时任务配置。




