orderDetail 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/spotCheck/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 页面主入口、列表查询和业务操作入口。
`toolConsumable`	`index > toolConsumable`	共享业务组件	是	否	否	查看	作为共享组件复用在当前页面主链路中，负责业务处理。
`index`	`index > toolConsumable > index`	共享业务组件	是	否	否	查看	作为共享组件复用在当前页面主链路中，负责业务处理。

辅助组件说明

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

技术图

Flow 布局：standard
Summary 布局：standard

1. 页面概览

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

2. 上游入口

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

3. 业务页面跳转链路

方法 closeCurrentPage -> /default/devicemate/spotCheck/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. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	`/dm-device/maintenanceWorkOrders/update`	更新提交	主页面	<el-button> @click -> save -> updatOrdereAjax	`update`
GET	`/dm-device/maintenanceWorkOrders`	业务请求	主页面	<toolConsumable> @applySuccess -> applySuccessHandler -> 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

json

{
  "id": ""
}

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

出参

外层响应：ResultData
业务数据体：框架统一成功响应
当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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
功能简述：业务请求
所属页面：主页面
前端触发链路：
<toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> worderOrderDetailAjax
activated 生命周期 -> activated -> getBasicInfoData -> worderOrderDetailAjax

入参

参数位置：unknown
当前链路未展开到更细的字段级定义。

出参

外层响应：ResultData
业务数据体：框架统一成功响应
当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <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
业务数据体：框架统一成功响应
当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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 页面主入口、列表查询和业务操作入口。
业务动作：更新提交
下游重点组件：toolConsumable

组件：toolConsumable

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

组件：index

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

7. 子组件列表

taskDetail：路由路径 /default/devicemate/spotCheck/task/taskDetail

8. 修改入口

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

orderDetail 链路分析 ​

Vue 组件总览 ​

辅助组件说明 ​

技术图 ​

1. 页面概览 ​

2. 上游入口 ​

3. 业务页面跳转链路 ​

4. 前端真实调用链 ​

5. 接口总览 ​

6. 接口详细说明 ​

6.1 POST /dm-device/maintenanceWorkOrders/update ​

接口信息 ​

入参 ​

出参 ​

后端逻辑链路 ​

orderDetail 链路分析

Vue 组件总览

辅助组件说明

技术图

1. 页面概览

2. 上游入口

3. 业务页面跳转链路

4. 前端真实调用链

5. 接口总览

6. 接口详细说明

6.1 `POST /dm-device/maintenanceWorkOrders/update`

接口信息

入参

出参

后端逻辑链路