Skip to content

storeInOrder 链路分析

源文件:docs/front end/dm/lemes-web/src/views/devicemate/inventory/storeInOrder/storeInOrder.vue

前端 API:docs/front end/dm/lemes-web/src/views/devicemate/api/inventory/storeInOrder/storeInOrder.js

后端落点:lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-server/src/main/java/com/lenovo/lemes/service/dm/store/controller/StoreInOrdersController.java / lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-server/src/main/java/com/lenovo/lemes/service/dm/store/service/impl/StoreInOrdersServiceImpl.java

主表:store_in_orders

Vue 组件总览

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

辅助组件说明

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

技术图

storeInOrder 页面数据流图

  • Flow 布局:standardstoreInOrder 页面摘要图

  • Summary 布局:standard

1. 页面概览

  • 当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/inventory/storeInOrder/storeInOrder.vue
  • 当前节点识别到 0 个重点组件、3 个辅助组件。
  • 当前节点识别到 1 条业务页面跳转链路、4 个真实接口。
  • 页面激活时会先加载字典数据,再自动触发首屏分页查询。
  • 搜索动作会把 filterList 同步到 searchFilter,并把页码重置为第 1 页。
  • 重置动作会清空查询条件,再走一次分页查询。
  • 导出动作会把当前筛选条件、排序字段以及勾选 ids 一起传给导出接口。

2. 上游入口

  • storeInOrderAdd 通过 <el-button> @click 跳转到当前页,路由为 /default/devicemate/inventory/storeInOrder/storeInOrder

3. 业务页面跳转链路

  • <el-button> @click -> /default/devicemate/inventory/storeInOrder/storeInOrderAdd -> storeInOrderAdd

4. 前端真实调用链

  • <boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear -> research -> pageAjax
  • <boxSearch> @reempty -> reempty -> pageAjax
  • <iTable> @size-change / <iTable> @current-change -> currentChange -> pageAjax
  • <el-button> @click -> submitStoreInaArr -> submitStoreBatchAjax / pageAjax
  • <el-button> @click -> deleteStoreInArr -> storeInOrderdeleteArr / pageAjax
  • <el-button> @click -> exportAction -> exportAjax
  • activated 生命周期 -> activated -> pageAjax

5. 接口总览

methodpath功能所属节点前端触发后端入口
POST/dm-store/storeInOrders/page分页查询主页面<boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear -> research -> currentChange -> getPage -> pageAjaxstoreInOrdersPage
POST/dm-store/storeInOrders/delete删除提交主页面<el-button> @click -> deleteStoreInArr -> storeInOrderdeleteArrdeleteStoreInOrders
POST/dm-store/storeInOrders/exportExcelExcel 导出主页面<el-button> @click -> exportAction -> exportAjaxexportExcel
POST/dm-store/storeInOrderDetail/submitStoreBatch业务请求主页面<el-button> @click -> submitStoreInaArr -> submitStoreBatchAjax-

6. 接口详细说明

6.1 POST /dm-store/storeInOrders/page

接口信息

  • 请求地址:/dm-store/storeInOrders/page
  • 请求方式:POST
  • 功能简述:分页查询
  • 所属页面:主页面
  • 前端触发链路:
  • <boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear -> research -> currentChange -> getPage -> pageAjax
  • <boxSearch> @reempty -> reempty -> currentChange -> getPage -> pageAjax
  • <iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> pageAjax
  • <el-button> @click -> submitStoreInaArr -> currentChange -> getPage -> pageAjax
  • <el-button> @click -> deleteStoreInArr -> currentChange -> getPage -> pageAjax
  • activated 生命周期 -> activated -> currentChange -> getPage -> pageAjax
  • 后端入口:storeInOrdersPage
  • Service 方法:query

入参

  • 后端接口实际接收对象:StoreInOrdersQueryVo
  • 参数位置:body
json
{
  "pageSize": 10,
  "pageNum": 1,
  "field": "",
  "order": "",
  "storeInOrderNo": "",
  "excutor": "",
  "storeName": "",
  "storeInStatus": "",
  "creator": "",
  "startTime": "",
  "endTime": ""
}

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

  • field;类型:String;来源:前端当前页面实际发送/可发送
  • order;类型:String;来源:前端当前页面实际发送/可发送
  • factoryNo;类型:String;来源:后端对象支持,当前页面未发送
  • ids;类型:List&lt;Long&gt;;说明:id集合;来源:后端对象支持,当前页面未发送
  • borrowUser;类型:String;说明:借用人;校验:长度不超过 20;来源:后端对象支持,当前页面未发送
  • startTime;类型:Date;说明:开始时间;来源:前端当前页面实际发送/可发送
  • endTime;类型:Date;说明:结束时间;来源:前端当前页面实际发送/可发送
  • storeInType;类型:Integer;来源:后端对象支持,当前页面未发送
  • storeNo;类型:String;来源:后端对象支持,当前页面未发送
  • storeNos;类型:List&lt;String&gt;;来源:后端对象支持,当前页面未发送
  • seriesNumber;类型:String;来源:后端对象支持,当前页面未发送
  • count;类型:Integer;来源:后端对象支持,当前页面未发送
  • partCode;类型:String;来源:后端对象支持,当前页面未发送
  • partName;类型:String;来源:后端对象支持,当前页面未发送
  • storeNames;类型:List&lt;String&gt;;来源:后端对象支持,当前页面未发送
  • lifeTimeCount;类型:BigDecimal;说明:寿命数;来源:后端对象支持,当前页面未发送
  • productLineNo;类型:String;说明:产品线代号;来源:后端对象支持,当前页面未发送
  • storeAreaNo;类型:String;说明:库区代号;来源:后端对象支持,当前页面未发送
  • storeBinNo;类型:String;说明:库区编码;来源:后端对象支持,当前页面未发送
  • supplierNo;类型:String;说明:供应商代号;来源:后端对象支持,当前页面未发送
  • usefulLife;类型:Date;来源:后端对象支持,当前页面未发送
  • serialRule;类型:Integer;说明:序列号生成规则 1 自动生成 2手动输入;来源:后端对象支持,当前页面未发送
  • isPeriod;类型:Integer;说明:是否有效期件 1-是 0-否;来源:后端对象支持,当前页面未发送
  • isLife;类型:Integer;说明:是否寿命件 1-是 0-否;来源:后端对象支持,当前页面未发送

出参

  • 外层响应:ResultData,前端实际消费的是 data 中的 rows / total。
  • 业务数据体:rows + total
json
{
  "rows": [
    {
      "id": 1,
      "partNo": "...",
      "partCode": "...",
      "partName": "...",
      "bigCategory": "...",
      "smallCategory": "...",
      "sonCategory": "...",
      "spec": "...",
      "uom": "...",
      "controlType": 1,
      "currency": "...",
      "price": "...",
      "preferredSupplier": "...",
      "supplierNo": "...",
      "isPeriod": "...",
      "isLife": "...",
      "maxLife": "...",
      "maxLifeUom": "...",
      "useModel": "...",
      "preciousType": "...",
      "validFlag": "...",
      "description": "...",
      "packageNumber": 1,
      "serialRule": "..."
    }
  ],
  "total": 0
}
  • id

  • partNo

  • partCode;类型:String;说明:物料编码

  • partName;类型:String;说明:物料名称

  • bigCategory

  • smallCategory

  • sonCategory

  • spec;类型:String;说明:物料规格

  • uom;类型:String;说明:单位

  • controlType;类型:Integer;说明:控制类型

  • currency

  • price

  • preferredSupplier

  • supplierNo;类型:String;说明:供应商代号

  • isPeriod

  • isLife

  • maxLife

  • maxLifeUom

  • useModel

  • preciousType

  • validFlag

  • description

  • packageNumber;类型:Long;说明:包装数量

  • serialRule

  • baseUrl

  • BaseController.getDataTable(IPage<?>) 会固定组装 rowstotal

  • 前端 ajax.js 会继续把 ResultData.data 解包后返回给页面。

后端逻辑链路

  1. 校验
  • Controller 入口为 storeInOrdersPage(@Validated @RequestBody StoreInOrdersQueryVo storeInOrdersQueryVo),由 @Validated 和请求对象注解触发基础参数校验。
  • 已确认的长度校验字段:borrowUser
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路无数据库写操作。
  1. 数据影响
  • 库存、金额、业务状态都不会发生持久化变更;若有价格处理,仅作用于返回值或导出值。
  1. 收尾
  • Controller 调用 getDataTable(...) 把分页对象组装成 {rows, total}
  • 最终通过 success(map) 返回 ResultData

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
POST /dm-store/storeInOrders/page查询?.store_in_ordersMyBatis-Plus ServiceImpl.page按筛选条件分页查询物料主数据

数据流走向

  • 数据来源:
  • 前端页面通过 <boxSearch> @research / <el-input> @clear / <el-input> @clear / <el-input> @clear -> research -> currentChange -> getPage -> pageAjax 触发请求
  • 数据处理路径:
  • Controller:storeInOrdersPage
  • Service:query
  • 数据落点:
  • ?.store_in_orders

备注

  • 当前 /page 主链没有走自定义 Mapper XML,而是走 MyBatis-Plus 通用分页查询。
  • 前端请求路径含服务前缀 /dm-store,合理推断该前缀来自网关或服务路由。
  • PartMainServiceImpl 类上存在 @DSTransactional,但只读接口本身不会产生写事务效果。

6.2 POST /dm-store/storeInOrders/delete

接口信息

  • 请求地址:/dm-store/storeInOrders/delete
  • 请求方式:POST
  • 功能简述:删除提交
  • 所属页面:主页面
  • 前端触发链路:
  • <el-button> @click -> deleteStoreInArr -> storeInOrderdeleteArr
  • 后端入口:deleteStoreInOrders
  • Service 方法:delete

入参

  • 后端接口实际接收对象:Long[]
  • 参数位置:body
json
{
  "ids": []
}

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

  • ids;类型:Long[];说明:待删除物料主数据 id 集合

出参

  • 外层响应:ResultData

  • 业务数据体:框架统一成功响应

  • 当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。

后端逻辑链路

  1. 校验
  • Controller 入口为 deleteStoreInOrders(@RequestBody Long[] ids),由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • Service 内先构造 LambdaQueryWrapper 作为条件容器。
  1. 核心业务
  • 使用 ServiceImpl 通用查询能力拉取目标数据集合。
  1. 状态变更
  • 执行的是逻辑删除:更新 is_deleteupdate_userupdate_time
  1. 数据影响
  • 物料主数据不会物理删库,但会被标记为删除,同时删除对应附件。
  1. 收尾
  • Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
POST /dm-store/storeInOrders/delete逻辑删除?.store_in_ordersMyBatis-Plus LambdaUpdateWrapper.update更新 is_delete、update_user、update_time,逻辑删除物料主数据

数据流走向

  • 数据来源:
  • 前端页面通过 <el-button> @click -> deleteStoreInArr -> storeInOrderdeleteArr 触发请求
  • 数据处理路径:
  • Controller:deleteStoreInOrders
  • Service:delete
  • 使用 ServiceImpl 通用查询能力拉取目标数据集合。
  • 数据落点:
  • ?.store_in_orders

备注

  • 前端请求路径含服务前缀 /dm-store,合理推断该前缀来自网关或服务路由。
  • PartMainServiceImpl 类上存在 @DSTransactional,但只读接口本身不会产生写事务效果。

6.3 POST /dm-store/storeInOrders/exportExcel

接口信息

  • 请求地址:/dm-store/storeInOrders/exportExcel
  • 请求方式:POST
  • 功能简述:Excel 导出
  • 所属页面:主页面
  • 前端触发链路:
  • <el-button> @click -> exportAction -> exportAjax
  • 后端入口:exportExcel
  • Service 方法:exportExcel

入参

  • 后端接口实际接收对象:StoreInOrdersQueryVo
  • 参数位置:body
json
{
  "ids": [],
  "field": "",
  "order": "",
  "storeInOrderNo": "",
  "excutor": "",
  "storeName": "",
  "storeInStatus": "",
  "creator": "",
  "selectDate": ""
}

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

  • field;类型:String;来源:前端导出动作实际可发送
  • order;类型:String;来源:前端导出动作实际可发送
  • factoryNo;类型:String;来源:后端对象支持,当前导出动作未发送
  • ids;类型:List&lt;Long&gt;;说明:id集合;来源:前端导出动作实际可发送
  • borrowUser;类型:String;说明:借用人;校验:长度不超过 20;来源:后端对象支持,当前导出动作未发送
  • startTime;类型:Date;说明:开始时间;来源:后端对象支持,当前导出动作未发送
  • endTime;类型:Date;说明:结束时间;来源:后端对象支持,当前导出动作未发送
  • storeInType;类型:Integer;来源:后端对象支持,当前导出动作未发送
  • storeNo;类型:String;来源:后端对象支持,当前导出动作未发送
  • storeNos;类型:List&lt;String&gt;;来源:后端对象支持,当前导出动作未发送
  • seriesNumber;类型:String;来源:后端对象支持,当前导出动作未发送
  • count;类型:Integer;来源:后端对象支持,当前导出动作未发送
  • partCode;类型:String;来源:后端对象支持,当前导出动作未发送
  • partName;类型:String;来源:后端对象支持,当前导出动作未发送
  • storeNames;类型:List&lt;String&gt;;来源:后端对象支持,当前导出动作未发送
  • lifeTimeCount;类型:BigDecimal;说明:寿命数;来源:后端对象支持,当前导出动作未发送
  • productLineNo;类型:String;说明:产品线代号;来源:后端对象支持,当前导出动作未发送
  • storeAreaNo;类型:String;说明:库区代号;来源:后端对象支持,当前导出动作未发送
  • storeBinNo;类型:String;说明:库区编码;来源:后端对象支持,当前导出动作未发送
  • supplierNo;类型:String;说明:供应商代号;来源:后端对象支持,当前导出动作未发送
  • usefulLife;类型:Date;来源:后端对象支持,当前导出动作未发送
  • serialRule;类型:Integer;说明:序列号生成规则 1 自动生成 2手动输入;来源:后端对象支持,当前导出动作未发送
  • isPeriod;类型:Integer;说明:是否有效期件 1-是 0-否;来源:后端对象支持,当前导出动作未发送
  • isLife;类型:Integer;说明:是否寿命件 1-是 0-否;来源:后端对象支持,当前导出动作未发送

出参

  • 外层响应:文件下载流

  • 业务数据体:Excel 二进制响应

  • 前端通过下载服务直接处理文件响应,不经过普通 JSON 列表渲染。

后端逻辑链路

  1. 校验
  • Controller 入口为 exportExcel(@Validated @RequestBody StoreInOrdersQueryVo storeInOrdersQueryVo, HttpServletResponse response),由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 把查询结果转成 Excel 视图对象后导出文件。
  1. 状态变更
  • 当前链路无数据库写操作。
  1. 数据影响
  • 库存、金额、业务状态都不会发生持久化变更;若有价格处理,仅作用于返回值或导出值。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
POST /dm-store/storeInOrders/exportExcel查询?.store_in_ordersMyBatis-Plus ServiceImpl.list按筛选条件导出物料主数据

数据流走向

  • 数据来源:
  • 前端页面通过 <el-button> @click -> exportAction -> exportAjax 触发请求
  • 数据处理路径:
  • Controller:exportExcel
  • Service:exportExcel
  • 把查询结果转成 Excel 视图对象后导出文件。
  • 数据落点:
  • ?.store_in_orders

备注

  • 前端请求路径含服务前缀 /dm-store,合理推断该前缀来自网关或服务路由。
  • PartMainServiceImpl 类上存在 @DSTransactional,但只读接口本身不会产生写事务效果。

6.4 POST /dm-store/storeInOrderDetail/submitStoreBatch

接口信息

  • 请求地址:/dm-store/storeInOrderDetail/submitStoreBatch
  • 请求方式:POST
  • 功能简述:业务请求
  • 所属页面:主页面
  • 前端触发链路:
  • <el-button> @click -> submitStoreInaArr -> submitStoreBatchAjax

入参

  • 参数位置:unknown

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

出参

  • 外层响应:ResultData

  • 业务数据体:框架统一成功响应

  • 当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

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

数据流走向

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

备注

  • 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
  • 前端请求路径含服务前缀 /dm-store,合理推断该前缀来自网关或服务路由。
  • PartMainServiceImpl 类上存在 @DSTransactional,但只读接口本身不会产生写事务效果。

重点组件说明

组件:index

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

7. 子组件列表

  • storeInOrderAdd:路由路径 /default/devicemate/inventory/storeInOrder/storeInOrderAdd

8. 修改入口

  • 改当前节点逻辑:先看上游入口,再看组件总览和业务页面跳转链路,最后核对接口与后端落点。
  • 改跳页逻辑:不仅要改当前页的方法和参数,还要同步检查目标页文档是否受影响。
  • 当前自动分析未识别出额外高风险点,但仍建议顺着子组件列表逐级核对。