taskDetail 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/spotCheck/task/taskDetail.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/MaintenanceTasksController.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/MaintenanceTasksServiceImpl.java
主表：maintenance_tasks

Vue 组件总览

组件	层级路径	角色	是否主链路	是否直接CRUD	独立MD	跳转	一句话作用
`index`	`index`	主页面	是	否	当前页	查看	承接 taskDetail 页面主入口、列表查询和业务操作入口。

辅助组件说明

iTable：负责通用列表渲染、分页、多选、排序和操作列承载。
dialogs：负责通用弹窗容器、确认和关闭交互。

技术图

Flow 布局：standard
Summary 布局：standard

1. 页面概览

当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/spotCheck/task/taskDetail.vue。
当前节点识别到 0 个重点组件、3 个辅助组件。
当前节点识别到 1 条业务页面跳转链路、4 个真实接口。
表格排序会把前端排序字段写入 field / order，再触发服务端排序查询。
导出动作会把当前筛选条件、排序字段以及勾选 ids 一起传给导出接口。

2. 上游入口

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

3. 业务页面跳转链路

方法 goOrderDetail -> /default/devicemate/spotCheck/task/orderDetail -> orderDetail，参数 id / type。

4. 前端真实调用链

<el-button> @click -> confirmAction -> orderStatusUpdateAjax / detailAjax / workorderPageAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> workorderPageAjax
<el-button> @click -> dialogConfirm -> orderStatusUpdateAjax / workorderPageAjax
<el-button> @click -> closeReasonDialogConfirm -> orderStatusUpdateAjax / detailAjax / workorderPageAjax
<el-button> @click -> recordExceptionOKClick -> exceptAjax
activated 生命周期 -> activated -> detailAjax / workorderPageAjax
<el-button> @click -> dialogCancel -> closeClick
<el-button> @click -> closeReasonDialogCancel -> closeReasonCloseClick
<el-button> @click -> recordExceptionCancelClick -> recordExceptionCloseClick

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	`/dm-device/maintenanceWorkOrders/page`	分页查询	主页面	<el-button> @click -> confirmAction -> currentChange -> getPage -> workorderPageAjax	-
POST	`/dm-device/maintenanceWorkOrders/add/except`	新增提交	主页面	<el-button> @click -> recordExceptionOKClick -> exceptAjax	-
GET	`/dm-device/maintenanceTasks`	业务请求	主页面	<el-button> @click -> confirmAction -> getHeaderInfo -> detailAjax	-
POST	`/dm-device/maintenanceWorkOrders/orderStatusUpdate`	业务请求	主页面	<el-button> @click -> confirmAction -> orderStatusUpdateAjax	-

6. 接口详细说明

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

接口信息

请求地址：/dm-device/maintenanceWorkOrders/page
请求方式：POST
功能简述：分页查询
所属页面：主页面
前端触发链路：
<el-button> @click -> confirmAction -> currentChange -> getPage -> workorderPageAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> workorderPageAjax
<el-button> @click -> dialogConfirm -> currentChange -> getPage -> workorderPageAjax
<el-button> @click -> closeReasonDialogConfirm -> currentChange -> getPage -> workorderPageAjax
activated 生命周期 -> activated -> currentChange -> getPage -> workorderPageAjax

入参

后端接口实际接收对象：MaintenanceTasksQueryVo
参数位置：body

json

{
  "pageSize": 10,
  "pageNum": 1,
  "field": "",
  "order": ""
}

已在源码中确认的有效字段包括：

field；类型：String；来源：前端当前页面实际发送/可发送
order；类型：String；来源：前端当前页面实际发送/可发送
factoryNo；类型：String；来源：后端对象支持，当前页面未发送
taskNo；类型：String；说明：保养单号；校验：长度不超过 50；来源：后端对象支持，当前页面未发送
planName；类型：String；说明：保养计划名称；校验：长度不超过 50；来源：后端对象支持，当前页面未发送
planType；类型：Integer；说明：计划类型；来源：后端对象支持，当前页面未发送
maintenanceLevel；类型：Integer；说明：维保等级；来源：后端对象支持，当前页面未发送
taskGenerateTimeStart；类型：Date；说明：任务生成时间-开始；来源：后端对象支持，当前页面未发送
taskGenerateTimeEnd；类型：Date；说明：任务生成时间-结束；来源：后端对象支持，当前页面未发送
taskCompletedTimeStart；类型：Date；说明：任务完成时间-开始；来源：后端对象支持，当前页面未发送
taskCompletedTimeEnd；类型：Date；说明：任务完成时间-结束；来源：后端对象支持，当前页面未发送
lineNo；类型：String；说明：线体；来源：后端对象支持，当前页面未发送
productLineNo；类型：String；说明：产品线；来源：后端对象支持，当前页面未发送
deptList；类型：List<String>；来源：后端对象支持，当前页面未发送
bussinessType；类型：Integer；说明：业务类型,0、保养 1、点检 2、巡检；来源：后端对象支持，当前页面未发送

出参

外层响应：ResultData，前端实际消费的是 data 中的 rows / total。
业务数据体：rows + total

json

{
  "rows": [
    {
      "id": 1,
      "partNo": "...",
      "partCode": "...",
      "partName": "...",
      "bigCategory": "...",
      "smallCategory": "...",
      "sonCategory": "...",
      "spec": "...",
      "uom": "...",
      "controlType": "...",
      "currency": "...",
      "price": "...",
      "preferredSupplier": "...",
      "supplierNo": "...",
      "isPeriod": "...",
      "isLife": "...",
      "maxLife": "...",
      "maxLifeUom": "...",
      "useModel": "...",
      "preciousType": "...",
      "validFlag": "...",
      "description": "...",
      "packageNumber": "...",
      "serialRule": "..."
    }
  ],
  "total": 0
}

id
partNo
partCode
partName
bigCategory
smallCategory
sonCategory
spec
uom
controlType
currency
price
preferredSupplier
supplierNo
isPeriod
isLife
maxLife
maxLifeUom
useModel
preciousType
validFlag
description；类型：String；说明：计划描述；校验：长度不超过 255
packageNumber
serialRule
baseUrl
BaseController.getDataTable(IPage<?>) 会固定组装 rows 与 total。
前端 ajax.js 会继续把 ResultData.data 解包后返回给页面。

后端逻辑链路

校验

已确认的长度校验字段：taskNo、planName。

预处理

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

核心业务

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

状态变更

当前链路无数据库写操作。

数据影响

库存、金额、业务状态都不会发生持久化变更；若有价格处理，仅作用于返回值或导出值。

收尾

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

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-device/maintenanceWorkOrders/page`	查询	`?.maintenance_tasks`	`MyBatis-Plus ServiceImpl.page`	按筛选条件分页查询物料主数据

数据流走向

数据来源：
前端页面通过 <el-button> @click -> confirmAction -> currentChange -> getPage -> workorderPageAjax 触发请求
数据处理路径：
数据落点：
?.maintenance_tasks

备注

当前 /page 主链没有走自定义 Mapper XML，而是走 MyBatis-Plus 通用分页查询。
当前只定位到前端接口与后端落点文件，未从 Controller 中匹配到完全一致的方法映射。
前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.2 `POST /dm-device/maintenanceWorkOrders/add/except`

接口信息

请求地址：/dm-device/maintenanceWorkOrders/add/except
请求方式：POST
功能简述：新增提交
所属页面：主页面
前端触发链路：
<el-button> @click -> recordExceptionOKClick -> exceptAjax

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <el-button> @click -> recordExceptionOKClick -> exceptAjax 触发请求
数据处理路径：
数据落点：
当前链路未识别到明确数据落点。

备注

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

6.3 `GET /dm-device/maintenanceTasks`

接口信息

请求地址：/dm-device/maintenanceTasks
请求方式：GET
功能简述：业务请求
所属页面：主页面
前端触发链路：
<el-button> @click -> confirmAction -> getHeaderInfo -> detailAjax
<el-button> @click -> closeReasonDialogConfirm -> getHeaderInfo -> detailAjax
activated 生命周期 -> activated -> getHeaderInfo -> detailAjax

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <el-button> @click -> confirmAction -> getHeaderInfo -> detailAjax 触发请求
数据处理路径：
数据落点：
当前链路未识别到明确数据落点。

备注

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

6.4 `POST /dm-device/maintenanceWorkOrders/orderStatusUpdate`

接口信息

请求地址：/dm-device/maintenanceWorkOrders/orderStatusUpdate
请求方式：POST
功能简述：业务请求
所属页面：主页面
前端触发链路：
<el-button> @click -> confirmAction -> orderStatusUpdateAjax
<el-button> @click -> dialogConfirm -> orderStatusUpdateAjax
<el-button> @click -> closeReasonDialogConfirm -> orderStatusUpdateAjax

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <el-button> @click -> confirmAction -> orderStatusUpdateAjax 触发请求
数据处理路径：
数据落点：
当前链路未识别到明确数据落点。

备注

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

重点组件说明

组件：index

角色：主页面
层级路径：index
是否直接CRUD：否
一句话作用：承接 taskDetail 页面主入口、列表查询和业务操作入口。
业务动作：新增提交

7. 子组件列表

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

8. 修改入口

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

taskDetail 链路分析 ​

Vue 组件总览 ​

辅助组件说明 ​

技术图 ​

1. 页面概览 ​

2. 上游入口 ​

3. 业务页面跳转链路 ​

4. 前端真实调用链 ​

5. 接口总览 ​

6. 接口详细说明 ​

6.1 POST /dm-device/maintenanceWorkOrders/page ​

接口信息 ​

入参 ​

出参 ​

后端逻辑链路 ​

taskDetail 链路分析

Vue 组件总览

辅助组件说明

技术图

1. 页面概览

2. 上游入口

3. 业务页面跳转链路

4. 前端真实调用链

5. 接口总览

6. 接口详细说明

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

接口信息

入参

出参

后端逻辑链路