orderDetail 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/routingInspection/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	跳转	一句话作用
index	index	主页面	是	否	当前页	查看	承接 orderDetail 页面主入口、列表查询和业务操作入口。

辅助组件说明

• basicInfo：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
• fileList：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
• checkList：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
• dialogs：负责通用弹窗容器、确认和关闭交互。

技术图

• Flow 布局：standard

• Summary 布局：standard

1. 页面概览

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

2. 上游入口

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

3. 业务页面跳转链路

• 方法 closeCurrentPage -> /default/devicemate/routingInspection/task/taskDetail -> taskDetail。

4. 前端真实调用链

• <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. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	/dm-device/maintenanceWorkOrders/update	更新提交	主页面	<el-button> @click -> save -> updatOrdereAjax	update
GET	/dm-device/maintenanceWorkOrders	业务请求	主页面	activated 生命周期 -> activated -> getBasicInfoData -> worderOrderDetailAjax	-
POST	/dm-device/maintenanceWorkOrders/executeWorkOrders	业务请求	主页面	<el-button> @click -> dialogConfirm -> executeWorkOrdersAjax	executeWorkOrders

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

{
  "id": ""
}

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

出参

• 外层响应：ResultData

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

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

后端逻辑链路

1. 校验

• Controller 入口为 update(@RequestBody MaintenanceWorkOrdersVo workOrdersVo)，由 @Validated 和请求对象注解触发基础参数校验。

2. 预处理

• 当前链路未识别出额外步骤。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 会更新 part_main 现有记录；若上传了新附件，会先删旧图再绑定新图。

5. 数据影响

• 主表更新既有物料主数据，附件关联可能被替换。

6. 收尾

• Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
POST /dm-device/maintenanceWorkOrders/update	更新	?.maintenance_work_orders	MyBatis-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
• 功能简述：业务请求
• 所属页面：主页面
• 前端触发链路：
• activated 生命周期 -> activated -> getBasicInfoData -> worderOrderDetailAjax

入参

• 参数位置：unknown

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

出参

• 外层响应：ResultData

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

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

后端逻辑链路

1. 校验

• 当前链路未识别出额外步骤。

2. 预处理

• 当前链路未识别出额外步骤。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 当前链路未识别出额外步骤。

5. 数据影响

• 当前链路未识别出额外步骤。

6. 收尾

• 当前链路未识别出额外步骤。

数据链路

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

数据流走向

• 数据来源：
• 前端页面通过 activated 生命周期 -> activated -> 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 和请求对象注解触发基础参数校验。

2. 预处理

• Service 内先构造 LambdaQueryWrapper 作为条件容器。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 当前链路未识别出额外步骤。

5. 数据影响

• 当前链路未识别出额外步骤。

6. 收尾

• Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
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 页面主入口、列表查询和业务操作入口。
• 业务动作：更新提交

7. 子组件列表

• taskDetail：路由路径 /default/devicemate/routingInspection/task/taskDetail

8. 修改入口

• 改当前节点逻辑：先看上游入口，再看组件总览和业务页面跳转链路，最后核对接口与后端落点。
• 改跳页逻辑：不仅要改当前页的方法和参数，还要同步检查目标页文档是否受影响。
• 当前节点被多个上游入口复用，改动前要确认所有入口语义是否一致。