measure 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/measure/measure/measure.vue
前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/measure/measure.js
后端落点：未识别 / 未识别
主表：measure

Vue 组件总览

组件	层级路径	角色	是否主链路	是否直接CRUD	独立MD	跳转	一句话作用
`index`	`index`	主页面	是	否	当前页	查看	承接 measure 页面主入口、列表查询，以及 2 个重点子组件的调度。
`addMeasure`	`index > addMeasure`	重点子组件	是	是	是	查看	承接新增表单录入、校验和提交。
`updateMeasure`	`index > updateMeasure`	重点子组件	是	是	是	查看	承接详情回显、字段修改和提交。
`importFile`	`index > importFile`	业务化公共组件	是	是	否	查看	复用通用组件外壳，但当前页通过 `:import-file-ajax` 注入业务配置，承接业务请求。
`importZipFile`	`index > importZipFile`	业务化公共组件	是	是	否	查看	复用通用组件外壳，但当前页通过 `:import-zip-file-ajax` 注入业务配置，承接业务请求。

辅助组件说明

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

技术图

Flow 布局：standard
Summary 布局：standard

1. 页面概览

当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/measure/measure/measure.vue。
当前节点识别到 4 个重点组件、23 个辅助组件。
当前节点识别到 0 条业务页面跳转链路、13 个真实接口。
搜索动作会把 filterList 同步到 searchFilter，并把页码重置为第 1 页。
重置动作会清空查询条件，再走一次分页查询。
表格排序会把前端排序字段写入 field / order，再触发服务端排序查询。
导出动作会把当前筛选条件、排序字段以及勾选 ids 一起传给导出接口。

2. 上游入口

当前节点是本次递归文档的根入口。

3. 业务页面跳转链路

当前节点未识别出业务页面跳转链路。

4. 前端真实调用链

<boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear -> research -> measureMainAjax
<boxSearch> @reempty -> reempty -> measureMainAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> measureMainAjax
<el-button> @click -> deleteMeasureArr -> measureDelArr / measureMainAjax
<el-button> @click -> exportAction -> exportAjax
<importFile> @importAction -> importAction -> measureMainAjax
<importZipFile> @importZipAction -> importZipAction -> measureMainAjax
activated 生命周期 -> activated -> measureMainAjax
<el-button> @click -> getTemplateData -> getTemplateList

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	`/dm-device/measure/main/page`	分页查询	主页面	<boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear -> research -> currentChange -> getPage -> measureMainAjax	-
POST	`/dm-device/measure/main/update`	更新提交	主页面	-	-
GET	`/dm-device/measure/main/{deviceNo}`	业务请求	updateMeasure 编辑页	-	-
POST	`/dm-device/measure/main/byId/upload`	业务请求	主页面	-	-
POST	`/dm-device/measure/main/del`	业务请求	主页面	<el-button> @click -> deleteMeasureArr -> measureDelArr	-
GET	`/dm-device/measure/main/del/img/{id}`	业务请求	updateMeasure 编辑页	-	-
POST	`/dm-device/measure/main/export`	业务请求	主页面	<el-button> @click -> exportAction -> exportAjax	-
POST	`/dm-device/measure/main/import`	业务请求	主页面	-	-
POST	`/dm-device/measure/main/import/pic`	业务请求	主页面	-	-
POST	`/dm-device/measure/main/save`	业务请求	主页面 addMeasure 新增页	-	-
POST	`/dm-device/measure/main/upload/img`	业务请求	updateMeasure 编辑页	-	-
GET	`dm-common/dept`	业务请求	addMeasure 新增页	-	-
POST	`dm-common/dept/list`	业务请求	addMeasure 新增页	-	-

6. 接口详细说明

6.1 `POST /dm-device/measure/main/page`

接口信息

请求地址：/dm-device/measure/main/page
请求方式：POST
功能简述：分页查询
所属页面：主页面
前端触发链路：
<boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear -> research -> currentChange -> getPage -> measureMainAjax
<boxSearch> @reempty -> reempty -> currentChange -> getPage -> measureMainAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> measureMainAjax
<el-button> @click -> deleteMeasureArr -> currentChange -> getPage -> measureMainAjax
<importFile> @importAction -> importAction -> currentChange -> getPage -> measureMainAjax
<importZipFile> @importZipAction -> importZipAction -> currentChange -> getPage -> measureMainAjax
activated 生命周期 -> activated -> currentChange -> getPage -> measureMainAjax

入参

参数位置：body

json

{
  "pageSize": 10,
  "pageNum": 1,
  "field": "",
  "order": "",
  "deviceName": "",
  "deviceSerialNumber": "",
  "deviceModel": "",
  "deviceCode": "",
  "measureType": "",
  "calibrationUnit": "",
  "calibrationResult": "",
  "certificateNumber": "",
  "startTime": "",
  "endTime": "",
  "useDeptNo": ""
}

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

出参

外层响应：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
packageNumber
serialRule
baseUrl
BaseController.getDataTable(IPage<?>) 会固定组装 rows 与 total。
前端 ajax.js 会继续把 ResultData.data 解包后返回给页面。

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

数据来源：
前端页面通过 <boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear / <el-select> @clear / <el-input> @clear -> research -> currentChange -> getPage -> measureMainAjax 触发请求
数据处理路径：
数据落点：
?.measure

备注

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

6.2 `POST /dm-device/measure/main/update`

接口信息

请求地址：/dm-device/measure/main/update
请求方式：POST
功能简述：更新提交
所属页面：主页面

入参

参数位置：body

json

{
  "id": ""
}

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-device/measure/main/update`	更新	`?.measure`	`MyBatis-Plus updateById`	按 id 更新物料主数据

数据流走向

数据来源：
前端页面通过当前页面动作触发请求
数据处理路径：
数据落点：
?.measure

备注

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

6.3 `GET /dm-device/measure/main/:deviceNo`

接口信息

请求地址：/dm-device/measure/main/{deviceNo}
请求方式：GET
功能简述：业务请求
所属页面：updateMeasure 编辑页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.4 `POST /dm-device/measure/main/byId/upload`

接口信息

请求地址：/dm-device/measure/main/byId/upload
请求方式：POST
功能简述：业务请求
所属页面：主页面

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.5 `POST /dm-device/measure/main/del`

接口信息

请求地址：/dm-device/measure/main/del
请求方式：POST
功能简述：业务请求
所属页面：主页面
前端触发链路：
<el-button> @click -> deleteMeasureArr -> measureDelArr

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.6 `GET /dm-device/measure/main/del/img/:id`

接口信息

请求地址：/dm-device/measure/main/del/img/{id}
请求方式：GET
功能简述：业务请求
所属页面：updateMeasure 编辑页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.7 `POST /dm-device/measure/main/export`

接口信息

请求地址：/dm-device/measure/main/export
请求方式：POST
功能简述：业务请求
所属页面：主页面
前端触发链路：
<el-button> @click -> exportAction -> exportAjax

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.8 `POST /dm-device/measure/main/import`

接口信息

请求地址：/dm-device/measure/main/import
请求方式：POST
功能简述：业务请求
所属页面：主页面

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.9 `POST /dm-device/measure/main/import/pic`

接口信息

请求地址：/dm-device/measure/main/import/pic
请求方式：POST
功能简述：业务请求
所属页面：主页面

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.10 `POST /dm-device/measure/main/save`

接口信息

请求地址：/dm-device/measure/main/save
请求方式：POST
功能简述：业务请求
所属页面：主页面 / addMeasure 新增页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.11 `POST /dm-device/measure/main/upload/img`

接口信息

请求地址：/dm-device/measure/main/upload/img
请求方式：POST
功能简述：业务请求
所属页面：updateMeasure 编辑页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

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

6.12 `GET dm-common/dept`

接口信息

请求地址：dm-common/dept
请求方式：GET
功能简述：业务请求
所属页面：addMeasure 新增页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

当前只定位到前端接口与后端落点文件，未从 Controller 中匹配到完全一致的方法映射。

6.13 `POST dm-common/dept/list`

接口信息

请求地址：dm-common/dept/list
请求方式：POST
功能简述：业务请求
所属页面：addMeasure 新增页

入参

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

出参

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

后端逻辑链路

校验

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

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

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

数据链路

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

数据流走向

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

备注

当前只定位到前端接口与后端落点文件，未从 Controller 中匹配到完全一致的方法映射。

重点组件说明

组件：index

角色：主页面
层级路径：index
是否直接CRUD：否
一句话作用：承接 measure 页面主入口、列表查询，以及 2 个重点子组件的调度。
业务动作：业务请求、新增提交、更新提交、删除提交
下游重点组件：addMeasure / updateMeasure / importFile / importZipFile

组件：addMeasure

角色：重点子组件
层级路径：index > addMeasure
父组件：index
是否直接CRUD：是
一句话作用：承接新增表单录入、校验和提交。
业务动作：新增提交
详细说明：查看独立说明

组件：updateMeasure

角色：重点子组件
层级路径：index > updateMeasure
父组件：index
是否直接CRUD：是
一句话作用：承接详情回显、字段修改和提交。
业务动作：删除提交、更新提交
详细说明：查看独立说明

组件：importFile

角色：业务化公共组件
层级路径：index > importFile
父组件：index
是否直接CRUD：是
一句话作用：复用通用组件外壳，但当前页通过 :import-file-ajax 注入业务配置，承接业务请求。
业务动作：业务请求
详细说明：不单独生成 MD，说明保留在当前主页面文档。

组件：importZipFile

角色：业务化公共组件
层级路径：index > importZipFile
父组件：index
是否直接CRUD：是
一句话作用：复用通用组件外壳，但当前页通过 :import-zip-file-ajax 注入业务配置，承接业务请求。
业务动作：业务请求
详细说明：不单独生成 MD，说明保留在当前主页面文档。

7. 子组件列表

addMeasure：组件角色重点子组件
updateMeasure：组件角色重点子组件

8. 修改入口

改当前节点逻辑：先看上游入口，再看组件总览和业务页面跳转链路，最后核对接口与后端落点。
重点组件较多，改组件分类或主链路时要同时看组件链和路由链。

measure 链路分析 ​

Vue 组件总览 ​

辅助组件说明 ​

技术图 ​

1. 页面概览 ​

2. 上游入口 ​

3. 业务页面跳转链路 ​

4. 前端真实调用链 ​

5. 接口总览 ​

6. 接口详细说明 ​

6.1 POST /dm-device/measure/main/page ​

接口信息 ​

入参 ​

出参 ​

后端逻辑链路 ​

measure 链路分析

Vue 组件总览

辅助组件说明

技术图

1. 页面概览

2. 上游入口

3. 业务页面跳转链路

4. 前端真实调用链

5. 接口总览

6. 接口详细说明

6.1 `POST /dm-device/measure/main/page`

接口信息

入参

出参

后端逻辑链路