工单管理

一、工单管理

1、概述

工单管理模块，利用物联网技术对设备或资产的维护、维修、检查等任务进行自动化、智能化和全流程化管理的系统。它不再是传统意义上被动响应故障的“报修单”，而是一个集成了实时数据、预测性分析和自动化流程的主动式运维中心。

2、工单类型

2.1、常规维护

是一种主动维护策略，需要对设备进行经常性定期保养，人为主动或者系统定期派发工单。

提示

注意：可结合设备维保功能使用，配置设备维保可指定周期内系统自动生成工单，参考设备维保文档

2.2、设备故障

设备故障是指设备在运行过程中由于各种原因导致其功能失效或性能下降的现象，需要人为主动创建派发工单。

2.3、设备安装

当需要去现场安装设备时，可人为主动创建派发工单，可填写区域、具体位置信息。

2.4、设备告警

在一些重要的告警场景下，当告警触发时，同时系统会自动生成工单，当管理人员看到工单后可以派发给维护人员检查维修。

提示

注意：可结合告警配置功能使用，告警配置启用生成工单，参考告警配置文档

2.5、用户反馈

主要是终端用户使用，终端用户购买设备后在使用过程中遇到问题，可直接在app或小程序，查看设备-问题反馈那里新增。

3、具体流程

• 常规维护、设备故障、设备安装工单类型：先派单，然后工单联系人接单，最后结单。如果截止时间内未完成，系统自动结单。
• 设备告警、用户反馈、常规维护工单类型：系统自动生成或者终端用户添加，先生成工单，然后管理员派单，然后工单联系人接单，最后结单。如果截止时间内未完成，系统自动结单。

4、工单记录

每次对工单的变更都会做一个记录，可点击记录按钮查询详细。

二、用户区分

区分为租户和终端用户使用。

• 终端用户：在小程序或app中查看设备-问题反馈界面，新增或查看自己提交的工单。也可以在我的界面点击问题反馈查看工单。

用户反馈后由设备厂家（租户）在后台管理处理工单。

• 租户：可以在pc端后台工单管理、我的工单管理工单；也可以在小程序或app中查看，和终端用户操作类似。

三、工单通知

1、QQ邮箱

工单派发后会通知到联系人的QQ邮箱，联系人收到邮件后点击链接进入后台管理处理工单。

提示

• 联系人（用户）信息必须要配置QQ邮箱号才能收到通知，可由管理人员去企业管理-用户管理统一修改用户邮箱号，或者自行去个人中心填写正确的邮箱号。
• QQ邮箱工单通知模板目前支持的变量如图所示，可参考消息通知文档自行调整。

三、后续优化

新增其它通知；

四、结果验证

工单配置完成后，建议按以下清单验收：

验收项	正常表现
手动创建	常规维护、设备故障、设备安装工单可手动创建
自动生成	告警和设备维保能按配置自动生成工单
派单	管理员可将工单派发给指定联系人
接单	联系人可在后台或移动端查看并接单
结单	处理完成后可填写结果并结单
日志	每次状态变化都有工单记录
通知	联系人邮箱或后续通知渠道能收到提醒

五、常见问题

联系人收不到通知

检查联系人用户是否配置邮箱，通知模板是否启用，消息通知渠道是否可用，邮件服务是否被拦截。

告警没有生成工单

检查告警配置是否启用“生成工单”，关联场景是否触发，告警执行次数限制是否阻止了重复通知。

维保没有生成工单

检查设备维保计划、提前派工时间、定时任务状态和服务器时间。

普通用户看不到工单

检查租户、角色、数据权限、设备分配关系，以及用户是否为工单联系人。

六、二次开发入口

类型	路径或接口	说明
前端页面	vue3/src/views/iot/workOrder	工单管理页面
前端页面	vue3/src/views/iot/maintenance	维保自动派单来源
后端接口	/iot/workOrder	工单增删改查与状态流转
后端接口	/iot/alert	告警生成工单来源
通知模块	springboot/fastbee-notify	邮件、HTTP 等通知能力