工单流程管理

**本文引用的文件** - [MaintenanceWorkOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-common/src/main/java/com/lenovo/lemes/service/dm/device/client/entity/inner/MaintenanceWorkOrdersDo.java) - [MwCheckListDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-common/src/main/java/com/lenovo/lemes/service/dm/device/client/entity/inner/MwCheckListDo.java) - [MsAndMvCheckListVo.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/model/device/MsAndMvCheckListVo.java) - [MaintenanceWorkOrdersService.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/service/device/MaintenanceWorkOrdersService.java) - [MaintenanceWorkOrdersMapper.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/mapper/device/MaintenanceWorkOrdersMapper.java) - [MaintenanceWorkOrdersServiceImpl.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/service/device/impl/MaintenanceWorkOrdersServiceImpl.java) - [MaintenancePlansServiceImpl.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/service/device/impl/MaintenancePlansServiceImpl.java) - [MpLevelCloseWotJob.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/handler/MpLevelCloseWotJob.java) - [inspectTasks.vue](file://app/devicemate-app/modules/inspectTasks/inspectTasks.vue) - [maintain.vue](file://app/devicemate-app/modules/maintain/maintain.vue) - [repair.vue](file://app/devicemate-app/modules/common/repair.vue) - [device.sql](file://docs/ddl/device.sql) - [workflow.sql](file://docs/ddl/workflow.sql)

目录

1. 简介
2. 项目结构
3. 核心组件
4. 架构总览
5. 详细组件分析
6. 依赖分析
7. 性能考虑
8. 故障排查指南
9. 结论
10. 附录

简介

本技术文档围绕“工单流程管理”主题，系统化梳理设备维修、保养、巡检等工单类型的流程设计与实现机制。重点覆盖以下方面：

• 工单数据模型设计：工单类型、优先级、状态、责任人、完成时间等字段定义与约束
• 工单全生命周期管理：创建、派发、执行、验收、关闭
• 工单与设备、部件、人员等实体的关联关系
• 工单执行过程中的数据记录：执行时间、完成情况、异常记录、附件上传等
• 统计分析：工单完成率、平均处理时间、设备故障率等指标计算思路
• 流程自定义配置与最佳实践

项目结构

本项目采用前后端分离架构，移动端前端位于 app/devicemate-app，后端服务位于 lemes-cloud 与 lemes-job-devicemate。工单相关的核心逻辑集中在“设备工单执行器”模块（job executor），并通过公共设备服务模块（business dm device）共享数据模型。

图示来源

• inspectTasks.vue
• maintain.vue
• repair.vue
• MaintenanceWorkOrdersDo.java
• MwCheckListDo.java
• MaintenanceWorkOrdersMapper.java
• MpLevelCloseWotJob.java
• device.sql
• workflow.sql

章节来源

• inspectTasks.vue
• maintain.vue
• repair.vue

核心组件

• 工单实体模型
  • 工单主表：维护工单基本信息与状态流转字段
  • 检查清单子表：记录每次执行的具体检查项、结果与执行人
• 工单服务层
  • 工单查询、状态更新、逾期提醒标记等
• 工单执行器
  • 计划生成工单、批量保存、优先级冲突处理与自动关单
• 前端页面
  • 工单列表、执行、验收、历史记录等页面联动

章节来源

• MaintenanceWorkOrdersDo.java
• MwCheckListDo.java
• MaintenanceWorkOrdersService.java
• MaintenanceWorkOrdersMapper.java
• MaintenanceWorkOrdersServiceImpl.java
• MaintenancePlansServiceImpl.java
• MpLevelCloseWotJob.java

架构总览

工单流程由“计划生成—批量创建—执行—验收—关闭/延续”的闭环构成。系统通过定时任务与策略处理器对高优先级冲突进行自动关单，保障生产现场的执行效率与一致性。

图示来源

• MaintenancePlansServiceImpl.java
• MpLevelCloseWotJob.java
• MaintenanceWorkOrdersMapper.java

详细组件分析

数据模型设计

• 工单主表字段要点
  • 工单编号、任务编号、设备编号、业务类型（保养/点检/巡检）
  • 状态、优先级、开始/结束时间、责任人/确认人
  • 逾期提醒、提前预警、指定确认人、关单原因等
• 检查清单字段要点
  • 工单号、模块/项目、检查内容、参考值/实际值、单位
  • 结果、执行人、执行时间、最小/最大阈值

图示来源

• MaintenanceWorkOrdersDo.java
• MwCheckListDo.java

章节来源

• MaintenanceWorkOrdersDo.java
• MwCheckListDo.java

工单生命周期管理

• 创建
  • 依据计划与设备清单生成工单，设置初始状态为“待执行”，写入检查清单
• 派发
  • 通过计划服务批量落库，生成唯一工单编号
• 执行
  • 执行人填写检查项结果、实际值、执行时间；支持异常记录与附件上传
• 验收
  • 确认人核验并签名，更新验收时间与状态
• 关闭
  • 自动关单或人工关单，记录关单原因与完成时间

图示来源

• MaintenancePlansServiceImpl.java
• MaintenanceWorkOrdersDo.java

章节来源

• MaintenancePlansServiceImpl.java

工单与实体的关联关系

• 工单与设备：通过设备编号关联，支持按设备筛选与统计
• 工单与人员：执行人/确认人/巡检负责人等角色字段
• 工单与标准：通过标准编号关联检查清单模板
• 工单与产品线：用于区域化/产线化管理与报表

章节来源

• MaintenanceWorkOrdersDo.java

执行过程中的数据记录

• 执行记录
  • 执行时间、执行人、检查项结果、实际值、单位、阈值范围
• 异常记录
  • 可在检查项中标注异常并附加说明
• 附件上传
  • 支持图片/文档等附件与工单绑定，便于追溯

章节来源

• MwCheckListDo.java

统计分析与指标

• 工单完成率
  • 公式：已完成工单数 / 总工单数 × 100%
  • 来源：按状态统计工单数量
• 平均处理时间
  • 公式：Σ(完成时间 - 创建时间) / 已完成工单数
  • 可按设备/产线/类型聚合
• 设备故障率
  • 公式：故障工单数 / 设备总台数 × 100%
  • 可结合设备维度与时间窗口

章节来源

• MaintenanceWorkOrdersDo.java

前端交互与页面联动

• 工单列表页
  • 支持分页、筛选（状态、设备、产线）、跳转到执行/验收/历史
• 执行页
  • 展示检查清单，填写结果与异常，提交后更新状态
• 验收页
  • 确认人核验并签名，完成关单
• 历史页
  • 查看历史工单与流程轨迹

章节来源

• inspectTasks.vue
• maintain.vue
• repair.vue

依赖分析

• 后端模块耦合
  • 工单执行器依赖设备公共模型与 MyBatis 映射
  • 定时任务依赖工单服务以实现自动关单
• 前端与后端
  • 前端通过接口调用后端服务，实现工单的增删改查与状态变更

图示来源

• MaintenanceWorkOrdersService.java
• MaintenanceWorkOrdersMapper.java
• MpLevelCloseWotJob.java

章节来源

• MaintenanceWorkOrdersService.java
• MaintenanceWorkOrdersMapper.java
• MpLevelCloseWotJob.java

性能考虑

• 批量操作
  • 工单与检查清单采用批量插入，减少事务开销
• 状态查询优化
  • 对常用过滤条件建立索引（设备号、状态、业务类型、时间区间）
• 定时任务节流
  • 优先级关单任务按设备维度去重，避免重复处理
• 前端分页与懒加载
  • 列表页使用分页与上拉加载，降低首屏压力

故障排查指南

• 工单未生成
  • 检查计划是否下发、设备清单是否存在、Redis序号是否可用
• 工单状态异常
  • 核对服务层状态更新逻辑与定时任务是否触发
• 优先级冲突未关单
  • 检查关单任务日志、比较逻辑与级别字段是否正确
• 执行记录缺失
  • 确认前端提交路径与后端接收接口，检查检查清单是否落库

章节来源

• MaintenanceWorkOrdersServiceImpl.java
• MpLevelCloseWotJob.java

结论

本方案通过统一的工单模型与执行器，实现了设备维修、保养、巡检等多类型工单的标准化管理。结合前端页面与定时策略，形成从计划到执行再到验收/关闭的完整闭环，并为后续统计分析与流程优化提供了坚实基础。

附录

• 数据库 DDL
  • 设备相关表：设备基础信息、工单主表、检查清单等
  • 工作流相关表：流程定义、实例、任务节点等
• 前端页面
  • 工单列表、执行、验收、历史等页面组件

章节来源

• device.sql
• workflow.sql