deviceType 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/information/deviceType/deviceType.vue
前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/information/deviceType/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/DeviceTypeController.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/DeviceTypeServiceImpl.java
主表：device_type

Vue 组件总览

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

辅助组件说明

boxSearch：负责查询条件区，支持搜索和清空事件触发。
iTable：负责通用列表渲染、分页、多选、排序和操作列承载。

技术图

Flow 布局：standard
Summary 布局：standard

1. 页面概览

当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/information/deviceType/deviceType.vue。
当前节点识别到 0 个重点组件、3 个辅助组件。
当前节点识别到 3 条业务页面跳转链路、4 个真实接口。
搜索动作会把 filterList 同步到 searchFilter，并把页码重置为第 1 页。
重置动作会清空查询条件，再走一次分页查询。

2. 上游入口

add 通过 <el-button> @click 跳转到当前页，路由为 /default/devicemate/information/deviceType/deviceType。
edit 通过 <el-button> @click 跳转到当前页，路由为 /default/devicemate/information/deviceType/deviceType。

3. 业务页面跳转链路

<el-button> @click -> /default/devicemate/information/deviceType/add -> add。
方法 editHandler -> /default/devicemate/information/deviceType/edit -> edit，参数 id。
方法 goDetail -> /default/devicemate/information/deviceType/detail -> detail，参数 id。

4. 前端真实调用链

<boxSearch> @research -> research -> getPageListAjax
<boxSearch> @reempty -> reempty -> getPageListAjax
<el-tree> @node-click -> nodeClick -> getPageListAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> getPageListAjax
<el-button> @click -> deleteList -> batchDeleteDeviceByIdAjax / getTreeListAjax / getPageListAjax
activated 生命周期 -> activated -> getTreeListAjax / getPageListAjax

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	`/dm-device/deviceType/page`	分页查询	主页面	<boxSearch> @research -> research -> currentChange -> getPage -> getPageListAjax	`page`
POST	`/dm-device/deviceType/{id}`	业务请求	主页面	-	`delete`
POST	`/dm-device/deviceType/batchDelete`	业务请求	主页面	<el-button> @click -> deleteList -> batchDeleteDeviceByIdAjax	`batchDelete`
POST	`/dm-device/deviceType/tree`	业务请求	主页面	<el-button> @click -> deleteList -> getTreeList -> getTreeListAjax	`getDeviceTypeTree`

6. 接口详细说明

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

接口信息

请求地址：/dm-device/deviceType/page
请求方式：POST
功能简述：分页查询
所属页面：主页面
前端触发链路：
<boxSearch> @research -> research -> currentChange -> getPage -> getPageListAjax
<boxSearch> @reempty -> reempty -> currentChange -> getPage -> getPageListAjax
<el-tree> @node-click -> nodeClick -> currentChange -> getPage -> getPageListAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> getPageListAjax
<el-button> @click -> deleteList -> currentChange -> getPage -> getPageListAjax
activated 生命周期 -> activated -> currentChange -> getPage -> getPageListAjax
后端入口：page
Service 方法：pages

入参

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

json

{
  "pageSize": 10,
  "pageNum": 1,
  "field": "",
  "order": "",
  "deviceTypeName": "",
  "deviceClassify": "",
  "deviceName": "",
  "deviceModel": ""
}

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

field；类型：String；来源：前端当前页面实际发送/可发送
order；类型：String；来源：前端当前页面实际发送/可发送
factoryNo；类型：String；来源：后端对象支持，当前页面未发送
deviceTypeName；类型：String；说明：设备种类；校验：长度不超过 50；来源：前端当前页面实际发送/可发送
deviceClassify；类型：Integer；说明：设备分类；来源：前端当前页面实际发送/可发送
deviceName；类型：String；说明：设备名称；校验：长度不超过 255；来源：前端当前页面实际发送/可发送
deviceModel；类型：String；说明：设备型号；校验：长度不超过 50；来源：前端当前页面实际发送/可发送
type；类型：Integer；说明：查询类型，1/其他设备种类(去重)/根据条件查询；来源：后端对象支持，当前页面未发送
partCode；类型：String；说明：物料编码；校验：长度不超过 50；来源：后端对象支持，当前页面未发送
deviceCode；类型：String；校验：长度不超过 50；来源：后端对象支持，当前页面未发送
deptName；类型：String；校验：长度不超过 20；来源：后端对象支持，当前页面未发送
productLineNos；类型：List<String>；说明：产品线集合；来源：后端对象支持，当前页面未发送
partNo；类型：String；来源：后端对象支持，当前页面未发送
deptNoList；类型：List<String>；来源：后端对象支持，当前页面未发送

出参

外层响应：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 解包后返回给页面。

后端逻辑链路

校验

Controller 入口为 page(@RequestBody DeviceTypeQueryVo vo)，由 @Validated 和请求对象注解触发基础参数校验。
已确认的长度校验字段：deviceTypeName、deviceName、deviceModel、partCode、deviceCode、deptName。

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <boxSearch> @research -> research -> currentChange -> getPage -> getPageListAjax 触发请求
数据处理路径：
Controller：page
Service：pages
数据落点：
?.device_type

备注

当前 /page 主链没有走自定义 Mapper XML，而是走 MyBatis-Plus 通用分页查询。
前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.2 `POST /dm-device/deviceType/:id`

接口信息

请求地址：/dm-device/deviceType/{id}
请求方式：POST
功能简述：业务请求
所属页面：主页面
后端入口：delete
Service 方法：deleteById

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过当前页面动作触发请求
数据处理路径：
Controller：delete
Service：deleteById
数据落点：
当前链路未识别到明确数据落点。

备注

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

6.3 `POST /dm-device/deviceType/batchDelete`

接口信息

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

入参

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

出参

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

后端逻辑链路

校验

Controller 入口为 batchDelete(@RequestBody Long[] ids)，由 @Validated 和请求对象注解触发基础参数校验。

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.4 `POST /dm-device/deviceType/tree`

接口信息

请求地址：/dm-device/deviceType/tree
请求方式：POST
功能简述：业务请求
所属页面：主页面
前端触发链路：
<el-button> @click -> deleteList -> getTreeList -> getTreeListAjax
activated 生命周期 -> activated -> getTreeList -> getTreeListAjax
后端入口：getDeviceTypeTree
Service 方法：getDeviceTypeTree

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

重点组件说明

组件：index

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

7. 子组件列表

add：路由路径 /default/devicemate/information/deviceType/add
edit：路由路径 /default/devicemate/information/deviceType/edit
detail：路由路径 /default/devicemate/information/deviceType/detail

8. 修改入口

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

deviceType 链路分析 ​

Vue 组件总览 ​

辅助组件说明 ​

技术图 ​

1. 页面概览 ​

2. 上游入口 ​

3. 业务页面跳转链路 ​

4. 前端真实调用链 ​

5. 接口总览 ​

6. 接口详细说明 ​

6.1 POST /dm-device/deviceType/page ​

接口信息 ​

入参 ​

出参 ​

后端逻辑链路 ​

deviceType 链路分析

Vue 组件总览

辅助组件说明

技术图

1. 页面概览

2. 上游入口

3. 业务页面跳转链路

4. 前端真实调用链

5. 接口总览

6. 接口详细说明

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

接口信息

入参

出参

后端逻辑链路