DM-ROW 接口文档

Appearance

点检巡检数据架构 ​

**本文档引用的文件** - [device.sql](file://docs/ddl/device.sql) - [ConfigController.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-common/lemes-service-dm-common-server/src/main/java/com/lenovo/lemes/service/dm/common/controller/ConfigController.java) - [ExceptionCode.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-common/lemes-service-dm-common-common/src/main/java/com/lenovo/lemes/service/dm/common/client/tools/entity/constant/ExceptionCode.java) - [MaintenanceStandardsMapper.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/mapper/device/MaintenanceStandardsMapper.java) - [MaintenanceStandardsServiceImpl.java](file://lemes-job-devicemate/lemes-job-devicemate-executor/src/main/java/com/lenovo/lemes/job/devicemate/executor/service/device/impl/MaintenanceStandardsServiceImpl.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) - [inspectTasks.vue](file://app/devicemate-app/modules/inspectTasks/inspectTasks.vue) - [execute.vue](file://app/devicemate-app/modules/inspectTasks/execute.vue) - [checkDetail.vue](file://app/devicemate-app/modules/inspectTasks/checkDetail.vue) - [patrolTasks.vue](file://app/devicemate-app/modules/patrolTasks/execute.vue) - [patrolTasks-checkDetail.vue](file://app/devicemate-app/modules/patrolTasks/checkDetail.vue) - [maintain-checkDetail.vue](file://app/devicemate-app/modules/maintain/checkDetail.vue) - [RegularInspection.vue](file://dm/lemes-web/src/views/wh/material/RegularInspection.vue) - [createEmailPatrolInspectionTask.html](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-common/lemes-service-dm-common-server/src/main/resources/templates/createEmailPatrolInspectionTask.html) - [delayEmailPatrolInspection.html](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-common/lemes-service-dm-common-server/src/main/resources/templates/delayEmailPatrolInspection.html) - [delayEmailSpotInspection.html](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-common/lemes-service-dm-common-server/src/main/resources/templates/delayEmailSpotInspection.html)

目录 ​

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

简介 ​

本文件为点检巡检模块的详细数据架构文档，围绕点检计划表(inspection_plan)、巡检任务表(inspection_tasks)、点检结果表(inspection_results)、巡检标准表(inspection_standards)等核心实体进行深入解析。重点阐述点检周期设置、点检项目、点检标准、点检人员、点检结果判定等关键字段的业务含义；说明点检计划与设备位置、维护标准的关联关系；解释点检任务的自动创建和执行机制；并提供标准流程数据模型与异常处理的数据设计示例。

项目结构 ​

点检巡检模块由前端应用、后端服务与作业调度三部分组成：

  • 前端应用：提供点检任务列表、执行页面、检查详情展示等界面交互。
  • 后端服务：负责配置初始化、字典项管理、业务流程控制与数据持久化。
  • 作业调度：基于定时任务自动生成点检/巡检任务，并发送提醒邮件。

图表来源

章节来源

核心组件 ​

本节聚焦点检巡检模块的核心数据实体与关键字段，结合业务语义进行说明。

  • inspection_plan（点检计划）

    • 关键字段：计划编号、计划名称、计划类型、周期单位、周期数值、开始日期、结束日期、审批状态、生成方式、负责人、关联设备/产线等。
    • 业务含义：定义点检/巡检的周期性规则与范围，决定任务生成频率与覆盖对象。

  • inspection_tasks（点检任务）

    • 关键字段：任务编号、计划编号、任务状态、执行人、确认人、设备/产线、计划执行时间、实际执行时间、维护等级、备注等。
    • 业务含义：具体执行层面的任务实例，承载执行进度与结果流转。

  • inspection_results（点检结果）

    • 关键字段：结果编号、任务编号、检查项目、检查标准、检查值、判定结果、图片/附件、执行人、确认人、创建时间等。
    • 业务含义：记录每次检查的具体数据与判定，支撑质量追溯与统计分析。

  • inspection_standards（点检标准）

    • 关键字段：标准编号、标准名称、父级标准、模块/项目、检查方法、参考图片、提示图片、标准值域、判定规则、适用设备分类等。
    • 业务含义：规范检查行为与判定依据，确保检查一致性与可复现性。

  • 相关字典与枚举

    • 通过配置接口加载计划状态、任务状态、维护等级、计划类型、审批状态等字典项，用于前端展示与后端校验。

章节来源

架构概览 ​

点检巡检模块采用“前端展示 + 后端配置 + 作业调度”的分层架构：

  • 前端负责任务列表、执行页面与详情展示；
  • 后端提供配置初始化与字典加载，保障业务参数一致；
  • 作业调度根据计划规则生成任务并发送提醒邮件，形成闭环。

图表来源

详细组件分析 ​

数据模型与字段解析 ​

以下为点检巡检相关核心表的关键字段与业务含义（基于DDL注释与业务上下文归纳）：

  • inspection_plan（点检计划）

    • 字段要点：计划编号、计划名称、计划类型(plan_type_inspection)、周期单位(period_plan_unit)、周期数值、开始/结束日期、审批状态(plan_audit_status)、生成方式(plan_generate_type)、负责人(patrolName/patrolNo)、关联产线(productLineNo/productLineName)等。
    • 业务含义：定义周期性点检/巡检的范围与节奏，支持按产线/设备分类生成任务。

  • inspection_tasks（点检任务）

    • 字段要点：任务编号、计划编号、任务状态(task_status)、执行人(excutorName)、确认人(confirmName)、设备/产线、计划执行时间、实际执行时间、维护等级(maintain_Level)、备注等。
    • 业务含义：具体执行实例，承载任务推进与结果收集。

  • inspection_results（点检结果）

    • 字段要点：结果编号、任务编号、检查项目(moduleName/projectName)、检查标准(content/workingMethod)、检查值、判定结果(ok_ng_na)、图片/附件(referenceImg/tipsImg)、执行人、确认人、创建时间等。
    • 业务含义：记录检查事实与判定，支撑质量追溯与统计分析。

  • inspection_standards（点检标准）

    • 字段要点：标准编号、标准名称、父级标准(parentStandardCode)、模块/项目(moduleName/projectName)、内容(content)、工作方法(workingMethod)、参考图片(referenceImg)、提示图片(tipsImg)、适用设备分类(device_classify)等。
    • 业务含义：标准化检查流程与判定依据，确保一致性。

  • 关联关系

    • inspection_tasks 与 inspection_plan：一对多，一个计划生成多个任务实例。
    • inspection_results 与 inspection_tasks：一对多，一个任务包含多项检查结果。
    • inspection_standards 与 inspection_tasks：通过标准编码关联，决定检查项目与判定规则。

图表来源

章节来源

点检周期设置与任务生成流程 ​

  • 周期设置：inspection_plan中通过“周期单位”和“周期数值”定义生成频率；“开始/结束日期”限定生效范围。
  • 任务生成：作业调度根据计划规则扫描inspection_plan，按周期计算生成inspection_tasks；同时读取inspection_standards构建检查清单。
  • 任务状态：生成后默认进入待执行状态，后续由执行人更新为进行中/已完成，并触发邮件提醒。

图表来源

章节来源

点检项目、标准与结果判定 ​

  • 点检项目：来源于inspection_standards，包含模块/项目、内容、工作方法、参考/提示图片等。
  • 点检标准：定义检查值域与判定规则，支持父级标准继承，便于统一管理。
  • 结果判定：inspection_results中的判定结果字段对应字典项，如OK/NG/NA，用于统计与报表。

图表来源

章节来源

前端交互与页面职责 ​

  • inspectTasks.vue：展示点检任务列表，支持分配、执行、维修与历史记录入口。
  • execute.vue：展示任务基本信息、检查清单、备件/耗材/工具清单、安全提示与文件附件，支持状态切换与字典渲染。
  • checkDetail.vue：展示检查项目的标准、内容、方法、参考/提示图片等详情。
  • patrolTasks/execute.vue：巡检执行页面，与点检页面类似，但字段包含巡检负责人与维护等级。
  • RegularInspection.vue：定期巡检视图，用于展示与管理巡检计划与任务。

图表来源

章节来源

依赖分析 ​

  • 前端依赖后端配置接口获取字典项，保证任务状态、维护等级等字段的一致性展示。
  • 作业调度依赖标准数据服务与映射器，读取inspection_standards构建检查清单并生成inspection_tasks。
  • 异常码集中定义于ExceptionCode，用于统一处理点检/巡检相关的业务异常场景。

图表来源

章节来源

性能考虑 ​

  • 数据访问优化：标准数据查询通过Mapper与Service封装，建议在高频查询场景下增加缓存策略，减少重复查询。
  • 任务生成批处理：周期性任务生成建议采用批处理与限流策略，避免高峰期对数据库造成压力。
  • 前端渲染优化：检查详情与图片资源建议懒加载与分页展示，提升页面响应速度。
  • 邮件发送异步化：提醒邮件通过模板异步发送，避免阻塞任务生成流程。

故障排除指南 ​

  • 异常码定位

    • 点检标准名称已存在：EX1000061
    • 巡检标准名称已存在：EX1000062
    • 审批未完成无法修改计划：EX1000063
    • 审批未通过无法修改启用计划：EX1000064
    • 其他异常码详见异常码定义文件。

  • 常见问题与处理

    • 任务未生成：检查inspection_plan的周期设置与生效日期，确认作业调度是否正常运行。
    • 检查项目缺失：核对inspection_standards是否存在父级标准继承关系，确保标准编码匹配。
    • 结果判定异常：确认字典项task_status与maintain_Level是否正确加载，检查inspection_results的判定字段映射。

章节来源

结论 ​

本数据架构文档系统梳理了点检巡检模块的核心实体、字段语义与业务流程，明确了计划-任务-结果的闭环关系，并给出了自动创建与执行机制、前端交互职责与异常处理的设计示例。通过标准化的检查清单与判定规则，结合作业调度与邮件提醒，实现了高效、可追溯的点检巡检管理体系。