设备维保

一、设备维保

1、概述

对需要周期执行维护保养的设备制定维保计划，按开始维保时间自动生成常规维护工单。

2、维保类型

2.1、保内维保

新建的设备维保默认是保内维保类型。

2.2、保外维保

设备维保如果未勾选保内维保到期停止执行，当从开始维保时间到保内维保时间到期后，根据维保周期，还会继续生成维保工单，此时类型自动变更为保外维保。

3、维保状态

• 未开始：保计划未进入设定的开始维保时间；
• 维保中：维保计划进入了设定的开始维保时间；
• 已停止：设定维保时间到期（必须勾选了保内维保到期停止执行）

4、配置说明

• 设备名称：数据来源为设备列表，单选某个设备。
• 保内维保时间：设备的维保时长（未勾选保内维保到期停止执行，无意义）
• 维保周期：在保内维保时间内，维保计划执行的周期，维保周期时长要小于保内维保时间；
• 开始维保时间：开始自动生成维保工单的时间；
• 保内维保到期停止执行：勾选了-会在保内维保时间内结束维保工单；未勾选-到保内维保时间，仍会执行维保计划；
• 提前派工单时间：按提前时间，在开始维保时间提前自动生成计划工单，同步至“工单管理”； 例如：保内维保时间为3年，维保周期为2个月，开始维保时间为2026-01-31，提前派工单时间为1天，维保计划会在2026-01-30号开始生成常规维护的工单，工单状态为待分配。

二、定时任务

定时任务每日凌晨执行，会查询出所有未开始、维保中的设备维保，然后根据配置的计划判断是否生成工单，运维人员每天上班后可去工单管理查看有没有需要常规维护的工单，并指派给维护人员维护。

三、结果验证

配置设备维保后，建议按以下顺序确认：

验收项	正常表现
维保计划	设备、开始时间、周期、保内到期时间显示正确
维保状态	未开始、维保中、已停止状态与时间设置一致
自动派单	到达提前派工时间后生成常规维护工单
工单关联	工单中能看到设备、联系人、截止时间和日志
到期处理	勾选保内到期停止后，到期不再生成新工单

四、常见问题

没有自动生成工单

优先检查开始维保时间、提前派工单时间、维保周期、定时任务是否启用，以及服务器时间是否正确。

生成了重复工单

检查同一设备是否配置了多个维保计划，或定时任务是否被多个节点重复执行。集群部署时需要确认任务调度策略。

维保状态不符合预期

检查保内维保时间、是否勾选保内到期停止执行，以及当前时间是否已经超过计划区间。

五、二次开发入口

类型	路径或接口	说明
前端页面	vue3/src/views/iot/maintenance	设备维保页面
前端页面	vue3/src/views/iot/workOrder	生成后的工单处理
后端接口	/iot/maintenance	维保计划接口
后端接口	/iot/workOrder	工单接口
定时任务	springboot/fastbee-plugs/fastbee-quartz	周期生成工单