DM 全路径知识库

Appearance

orderDetail 链路分析 ​

源文件：docs/front end/dm/lemes-web/src/views/devicemate/maintain/task/orderDetail.vue

前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/maintain/task/index.js

后端落点：lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-server/src/main/java/com/lenovo/lemes/service/dm/device/controller/MaintenanceWorkOrdersController.java / lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-server/src/main/java/com/lenovo/lemes/service/dm/device/service/impl/MaintenanceWorkOrdersServiceImpl.java

主表：maintenance_work_orders

Vue 组件总览 ​

组件层级路径角色是否主链路是否直接CRUD独立MD跳转一句话作用
indexindex主页面是否当前页查看承接 orderDetail 页面主入口、列表查询和业务操作入口。
toolConsumableindex > toolConsumable业务子模块是是否查看负责 toolConsumable 模块的展示、操作编排和新增提交、删除提交、更新提交。
indexindex > toolConsumable > index共享业务组件是否否查看作为共享组件复用在当前页面主链路中，负责业务处理。
indexindex > toolConsumable > index > index共享业务组件是否否查看作为共享组件复用在当前页面主链路中，负责业务处理。

辅助组件说明 ​

  • basicInfo：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
  • fileList：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
  • iTitle：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
  • iTable：负责通用列表渲染、分页、多选、排序和操作列承载，在 toolConsumable / index 中复用。
  • dialogs：负责通用弹窗容器、确认和关闭交互，在 index / toolConsumable 中复用。
  • boxSearch：负责查询条件区，支持搜索和清空事件触发。
  • checkList：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。

技术图 ​

orderDetail 页面数据流图

  • Flow 布局：standardorderDetail 页面摘要图

  • Summary 布局：standard

1. 页面概览 ​

  • 当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/maintain/task/orderDetail.vue。
  • 当前节点识别到 3 个重点组件、21 个辅助组件。
  • 当前节点识别到 1 条业务页面跳转链路、3 个真实接口。

2. 上游入口 ​

  • taskDetail 通过 方法 goOrderDetail 跳转到当前页，路由为 /default/devicemate/maintain/task/orderDetail，携带参数 id / type。

3. 业务页面跳转链路 ​

  • 方法 closeCurrentPage -> /default/devicemate/maintain/task/taskDetail -> taskDetail，该目标页已在上游链路展开，当前只保留回跳引用。

4. 前端真实调用链 ​

  • <toolConsumable> @applySuccess -> applySuccessHandler -> worderOrderDetailAjax
  • <el-button> @click -> save -> updatOrdereAjax
  • <el-button> @click -> dialogConfirm -> executeWorkOrdersAjax / updatOrdereAjax
  • activated 生命周期 -> activated -> worderOrderDetailAjax
  • <el-button> @click -> cancel -> closeCurrentPage
  • <el-button> @click -> dialogCancel -> closeClick

5. 接口总览 ​

methodpath功能所属节点前端触发后端入口
POST/dm-device/maintenanceWorkOrders/update更新提交主页面<el-button> @click -> save -> updatOrdereAjaxupdate
GET/dm-device/maintenanceWorkOrders业务请求主页面<toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> worderOrderDetailAjax-
POST/dm-device/maintenanceWorkOrders/executeWorkOrders业务请求主页面<el-button> @click -> dialogConfirm -> executeWorkOrdersAjaxexecuteWorkOrders

6. 接口详细说明 ​

6.1 POST /dm-device/maintenanceWorkOrders/update ​

接口信息 ​

  • 请求地址：/dm-device/maintenanceWorkOrders/update
  • 请求方式：POST
  • 功能简述：更新提交
  • 所属页面：主页面
  • 前端触发链路：
  • <el-button> @click -> save -> updatOrdereAjax
  • <el-button> @click -> dialogConfirm -> saveBeforeSelectUser -> save -> updatOrdereAjax
  • 后端入口：update
  • Service 方法：update

入参 ​

  • 后端接口实际接收对象：MaintenanceWorkOrdersVo
  • 参数位置：body
json
{
  "id": ""
}
  • 当前链路未展开到更细的字段级定义。

出参 ​

  • 外层响应：ResultData

  • 业务数据体：框架统一成功响应

  • 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路 ​

  1. 校验
  • Controller 入口为 update(@RequestBody MaintenanceWorkOrdersVo workOrdersVo)，由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 会更新 part_main 现有记录；若上传了新附件，会先删旧图再绑定新图。
  1. 数据影响
  • 主表更新既有物料主数据，附件关联可能被替换。
  1. 收尾
  • Controller 通过 success(...) 返回框架统一成功响应。

数据链路 ​

接口调用类型库名.表名mapper.pagesql作用（简写）
POST /dm-device/maintenanceWorkOrders/update更新?.maintenance_work_ordersMyBatis-Plus updateById按 id 更新物料主数据
POST /dm-device/maintenanceWorkOrders/update远程写入?.附件数据fileClient.updateFile回写附件 targetId，绑定业务对象
POST /dm-device/maintenanceWorkOrders/update远程写入?.附件数据fileClient.deleteFiles删除旧附件文件

数据流走向 ​

  • 数据来源：
  • 前端页面通过 <el-button> @click -> save -> updatOrdereAjax 触发请求
  • 数据处理路径：
  • Controller：update
  • Service：update
  • 数据落点：
  • ?.maintenance_work_orders
  • ?.附件数据
  • ?.附件数据

备注 ​

  • 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.2 GET /dm-device/maintenanceWorkOrders ​

接口信息 ​

  • 请求地址：/dm-device/maintenanceWorkOrders
  • 请求方式：GET
  • 功能简述：业务请求
  • 所属页面：主页面
  • 前端触发链路：
  • <toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> worderOrderDetailAjax
  • activated 生命周期 -> activated -> getBasicInfoData -> worderOrderDetailAjax

入参 ​

  • 参数位置：unknown

  • 当前链路未展开到更细的字段级定义。

出参 ​

  • 外层响应：ResultData

  • 业务数据体：框架统一成功响应

  • 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路 ​

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路 ​

  • 当前链路未识别到明确数据库表操作。

数据流走向 ​

  • 数据来源：
  • 前端页面通过 <toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> worderOrderDetailAjax 触发请求
  • 数据处理路径：
  • 数据落点：
  • 当前链路未识别到明确数据落点。

备注 ​

  • 当前只定位到前端接口与后端落点文件，未从 Controller 中匹配到完全一致的方法映射。
  • 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.3 POST /dm-device/maintenanceWorkOrders/executeWorkOrders ​

接口信息 ​

  • 请求地址：/dm-device/maintenanceWorkOrders/executeWorkOrders
  • 请求方式：POST
  • 功能简述：业务请求
  • 所属页面：主页面
  • 前端触发链路：
  • <el-button> @click -> dialogConfirm -> executeWorkOrdersAjax
  • 后端入口：executeWorkOrders
  • Service 方法：executeWorkOrders

入参 ​

  • 参数位置：unknown

  • 当前链路未展开到更细的字段级定义。

出参 ​

  • 外层响应：ResultData

  • 业务数据体：框架统一成功响应

  • 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路 ​

  1. 校验
  • Controller 入口为 executeWorkOrders(@RequestBody MaintenanceWorkOrdersVo workOrdersVo)，由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • Service 内先构造 LambdaQueryWrapper 作为条件容器。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • Controller 通过 success(...) 返回框架统一成功响应。

数据链路 ​

接口调用类型库名.表名mapper.pagesql作用（简写）
POST /dm-device/maintenanceWorkOrders/executeWorkOrders远程写入?.附件数据fileClient.updateFile回写附件 targetId，绑定业务对象
POST /dm-device/maintenanceWorkOrders/executeWorkOrders远程写入?.附件数据fileClient.deleteFiles删除旧附件文件

数据流走向 ​

  • 数据来源：
  • 前端页面通过 <el-button> @click -> dialogConfirm -> executeWorkOrdersAjax 触发请求
  • 数据处理路径：
  • Controller：executeWorkOrders
  • Service：executeWorkOrders
  • 数据落点：
  • ?.附件数据
  • ?.附件数据

备注 ​

  • 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

重点组件说明 ​

组件：index ​

  • 角色：主页面
  • 层级路径：index
  • 是否直接CRUD：否
  • 一句话作用：承接 orderDetail 页面主入口、列表查询和业务操作入口。
  • 业务动作：更新提交
  • 下游重点组件：toolConsumable

组件：toolConsumable ​

  • 角色：业务子模块
  • 层级路径：index > toolConsumable
  • 父组件：index
  • 是否直接CRUD：是
  • 一句话作用：负责 toolConsumable 模块的展示、操作编排和新增提交、删除提交、更新提交。
  • 业务动作：新增提交、删除提交、更新提交
  • 详细说明：不单独生成 MD，说明保留在当前主页面文档。
  • 下游重点组件：index

组件：index ​

  • 角色：共享业务组件
  • 层级路径：index > toolConsumable > index
  • 父组件：toolConsumable
  • 是否直接CRUD：否
  • 一句话作用：作为共享组件复用在当前页面主链路中，负责业务处理。
  • 详细说明：不单独生成 MD，说明保留在当前主页面文档。
  • 下游重点组件：index

组件：index ​

  • 角色：共享业务组件
  • 层级路径：index > toolConsumable > index > index
  • 父组件：index
  • 是否直接CRUD：否
  • 一句话作用：作为共享组件复用在当前页面主链路中，负责业务处理。
  • 详细说明：不单独生成 MD，说明保留在当前主页面文档。

7. 子组件列表 ​

  • taskDetail：路由路径 /default/devicemate/maintain/task/taskDetail，当前为回跳引用

8. 修改入口 ​

  • 改当前节点逻辑：先看上游入口，再看组件总览和业务页面跳转链路，最后核对接口与后端落点。
  • 改跳页逻辑：不仅要改当前页的方法和参数，还要同步检查目标页文档是否受影响。
  • 当前自动分析未识别出额外高风险点，但仍建议顺着子组件列表逐级核对。