Appearance
check 链路分析
源文件:
docs/front end/dm/lemes-web/src/views/devicemate/inventory/check/check.vue前端 API:
docs/front end/dm/lemes-web/src/views/devicemate/api/inventory/check/check.js后端落点:未识别 / 未识别
主表:
check
Vue 组件总览
| 组件 | 层级路径 | 角色 | 是否主链路 | 是否直接CRUD | 独立MD | 跳转 | 一句话作用 |
|---|---|---|---|---|---|---|---|
index | index | 主页面 | 是 | 否 | 当前页 | 查看 | 承接 check 页面主入口、列表查询和业务操作入口。 |
importFile | index > importFile | 业务化公共组件 | 是 | 否 | 否 | 查看 | 复用通用组件外壳,但当前页通过 :import-file-ajax 注入业务配置,承接业务处理。 |
辅助组件说明
boxSearch:负责查询条件区,支持搜索和清空事件触发。iTable:负责通用列表渲染、分页、多选、排序和操作列承载。dialogs:负责通用弹窗容器、确认和关闭交互。
技术图

Flow 布局:
standard
Summary 布局:
standard
1. 页面概览
- 当前节点对应文件
docs/front end/dm/lemes-web/src/views/devicemate/inventory/check/check.vue。 - 当前节点识别到 1 个重点组件、5 个辅助组件。
- 当前节点识别到 3 条业务页面跳转链路、5 个真实接口。
- 页面激活时会先加载字典数据,再自动触发首屏分页查询。
- 搜索动作会把
filterList同步到searchFilter,并把页码重置为第 1 页。 - 重置动作会清空查询条件,再走一次分页查询。
- 导出动作会把当前筛选条件、排序字段以及勾选 ids 一起传给导出接口。
2. 上游入口
addCheck通过 方法addStoreCheck跳转到当前页,路由为/default/devicemate/inventory/check/check。
3. 业务页面跳转链路
- <el-button> @click ->
/default/devicemate/inventory/check/addCheck->addCheck。 - <el-button> @click ->
/default/devicemate/inventory/check/addCheck->addCheck,参数stockCheckOrderNo/type。 - 方法
toDetail->/default/devicemate/inventory/check/detail->detail,参数auditNo/stockCheckOrderNo。
4. 前端真实调用链
- <boxSearch> @research -> research ->
pageAjax - <boxSearch> @reempty -> reempty ->
pageAjax - <iTable> @size-change / <iTable> @current-change -> currentChange ->
pageAjax - <el-button> @click -> deleteProductLineArr ->
delStoreCheckAjax/pageAjax - <el-button> @click -> exportAction ->
exportCheckAjax - <importFile> @importAction -> importAction ->
pageAjax - activated 生命周期 -> activated ->
pageAjax
5. 接口总览
| method | path | 功能 | 所属节点 | 前端触发 | 后端入口 |
|---|---|---|---|---|---|
| POST | dm-store/stock/check/page | 分页查询 | 主页面 | <boxSearch> @research -> research -> currentChange -> getPage -> pageAjax | - |
| POST | dm-store/stock/detail/import | 详情回显 | 主页面 | - | - |
| GET | dm-store/stock/check/del | 业务请求 | 主页面 | <el-button> @click -> deleteProductLineArr -> delStoreCheckAjax | - |
| POST | dm-store/stock/check/export | 业务请求 | 主页面 | <el-button> @click -> exportAction -> exportCheckAjax | - |
| POST | dm-store/stockMain/list/part | 业务请求 | 主页面 | - | - |
6. 接口详细说明
6.1 POST dm-store/stock/check/page
接口信息
- 请求地址:
dm-store/stock/check/page - 请求方式:
POST - 功能简述:分页查询
- 所属页面:主页面
- 前端触发链路:
- <boxSearch> @research -> research -> currentChange -> getPage -> pageAjax
- <boxSearch> @reempty -> reempty -> currentChange -> getPage -> pageAjax
- <iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> pageAjax
- <el-button> @click -> deleteProductLineArr -> currentChange -> getPage -> pageAjax
- <importFile> @importAction -> importAction -> currentChange -> getPage -> pageAjax
- activated 生命周期 -> activated -> currentChange -> getPage -> pageAjax
入参
- 参数位置:
body
json
{
"pageSize": 10,
"pageNum": 1,
"field": "",
"order": "",
"stockCheckOrderNo": "",
"storeNo": "",
"checkUser": "",
"checkStatus": "",
"startTime": "",
"endTime": ""
}- 当前链路未展开到更细的字段级定义。
出参
- 外层响应: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
}idpartNopartCodepartNamebigCategorysmallCategorysonCategoryspecuomcontrolTypecurrencypricepreferredSuppliersupplierNoisPeriodisLifemaxLifemaxLifeUomuseModelpreciousTypevalidFlagdescriptionpackageNumberserialRulebaseUrlBaseController.getDataTable(IPage<?>)会固定组装rows与total。前端
ajax.js会继续把ResultData.data解包后返回给页面。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路无数据库写操作。
- 数据影响
- 库存、金额、业务状态都不会发生持久化变更;若有价格处理,仅作用于返回值或导出值。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
| 接口 | 调用类型 | 库名.表名 | mapper.page | sql作用(简写) |
|---|---|---|---|---|
POST dm-store/stock/check/page | 查询 | ?.check | MyBatis-Plus ServiceImpl.page | 按筛选条件分页查询物料主数据 |
数据流走向
- 数据来源:
- 前端页面通过 <boxSearch> @research -> research -> currentChange -> getPage -> pageAjax 触发请求
- 数据处理路径:
- 数据落点:
- ?.check
备注
- 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
6.2 POST dm-store/stock/detail/import
接口信息
- 请求地址:
dm-store/stock/detail/import - 请求方式:
POST - 功能简述:详情回显
- 所属页面:主页面
入参
- 后端接口实际接收对象:
Long - 参数位置:
path
json
{
"id": 1
}已在源码中确认的有效字段包括:
id;类型:Long;说明:路径中的业务 id;校验:必填
出参
- 外层响应:ResultData<PartMainVo>
- 业务数据体:单个 PartMainVo 对象
json
{
"id": 1,
"partNo": "...",
"partCode": "...",
"partName": "...",
"spec": "...",
"uom": "...",
"controlType": "...",
"price": "...",
"preferredSupplier": "...",
"isPeriod": "...",
"isLife": "...",
"maxLife": "...",
"maxLifeUom": "...",
"useModel": "...",
"preciousType": "...",
"validFlag": "...",
"description": "...",
"packageNumber": "...",
"attachmentVoList": "...",
"baseUrl": "..."
}idpartNopartCodepartNamespecuomcontrolTypepricepreferredSupplierisPeriodisLifemaxLifemaxLifeUomuseModelpreciousTypevalidFlagdescriptionpackageNumberattachmentVoListbaseUrl详情接口会把附件集合写入
attachmentVoList,并补充前端可直接回显的baseUrl。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路无数据库写操作。
- 数据影响
- 库存、金额、业务状态都不会发生持久化变更;若有价格处理,仅作用于返回值或导出值。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
| 接口 | 调用类型 | 库名.表名 | mapper.page | sql作用(简写) |
|---|---|---|---|---|
POST dm-store/stock/detail/import | 查询 | ?.check | MyBatis-Plus getById | 按 id 查询物料详情 |
数据流走向
- 数据来源:
- 前端页面通过 当前页面动作 触发请求
- 数据处理路径:
- 数据落点:
- ?.check
备注
- 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
6.3 GET dm-store/stock/check/del
接口信息
- 请求地址:
dm-store/stock/check/del - 请求方式:
GET - 功能简述:业务请求
- 所属页面:主页面
- 前端触发链路:
- <el-button> @click -> deleteProductLineArr -> delStoreCheckAjax
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
- 当前链路未识别到明确数据库表操作。
数据流走向
- 数据来源:
- 前端页面通过 <el-button> @click -> deleteProductLineArr -> delStoreCheckAjax 触发请求
- 数据处理路径:
- 数据落点:
- 当前链路未识别到明确数据落点。
备注
- 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
6.4 POST dm-store/stock/check/export
接口信息
- 请求地址:
dm-store/stock/check/export - 请求方式:
POST - 功能简述:业务请求
- 所属页面:主页面
- 前端触发链路:
- <el-button> @click -> exportAction -> exportCheckAjax
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
- 当前链路未识别到明确数据库表操作。
数据流走向
- 数据来源:
- 前端页面通过 <el-button> @click -> exportAction -> exportCheckAjax 触发请求
- 数据处理路径:
- 数据落点:
- 当前链路未识别到明确数据落点。
备注
- 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
6.5 POST dm-store/stockMain/list/part
接口信息
- 请求地址:
dm-store/stockMain/list/part - 请求方式:
POST - 功能简述:业务请求
- 所属页面:主页面
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
- 当前链路未识别到明确数据库表操作。
数据流走向
- 数据来源:
- 前端页面通过 当前页面动作 触发请求
- 数据处理路径:
- 数据落点:
- 当前链路未识别到明确数据落点。
备注
- 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
重点组件说明
组件:index
- 角色:主页面
- 层级路径:
index - 是否直接CRUD:否
- 一句话作用:承接 check 页面主入口、列表查询和业务操作入口。
- 业务动作:删除提交、详情回显
- 下游重点组件:
importFile
组件:importFile
- 角色:业务化公共组件
- 层级路径:
index > importFile - 父组件:
index - 是否直接CRUD:否
- 一句话作用:复用通用组件外壳,但当前页通过
:import-file-ajax注入业务配置,承接业务处理。 - 详细说明:不单独生成 MD,说明保留在当前主页面文档。
7. 子组件列表
addCheck:路由路径/default/devicemate/inventory/check/addCheckdetail:路由路径/default/devicemate/inventory/check/detail
8. 修改入口
- 改当前节点逻辑:先看上游入口,再看组件总览和业务页面跳转链路,最后核对接口与后端落点。
- 改跳页逻辑:不仅要改当前页的方法和参数,还要同步检查目标页文档是否受影响。
- 当前节点有多条跨页面链路,改动前要确认所有下游页面是否同步受影响。