reservoir 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/information/warehouse/reservoir.vue
前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/information/warehouse/reservoir.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/StoreAreaController.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/StoreAreaServiceImpl.java
主表：store_area

Vue 组件总览

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

辅助组件说明

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

技术图

Flow 布局：standard
Summary 布局：standard

1. 页面概览

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

2. 上游入口

warehouse 通过 <el-button> @click 跳转到当前页，路由为 /default/devicemate/information/warehouse/reservoir，携带参数 storeId。

3. 业务页面跳转链路

方法 goSeatMaintain -> /default/devicemate/information/warehouse/seat -> seat，参数 storeAreaObj。

4. 前端真实调用链

<boxSearch> @research -> research -> pageAjax
<boxSearch> @reempty -> reempty -> pageAjax
<iTable> @size-change / <iTable> @current-change -> currentChange -> pageAjax
<el-button> @click -> deleteStoreAreaArr -> storeAreadeleteArr / pageAjax
activated 生命周期 -> activated -> pageAjax

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	`/dm-store/storeArea/page`	分页查询	主页面	<boxSearch> @research -> research -> currentChange -> getPage -> pageAjax	`storeAreaPage`
POST	`/dm-store/storeArea/add`	新增提交	主页面	-	`addStoreArea`
POST	`/dm-store/storeArea/update`	更新提交	主页面	-	`update`
POST	`/dm-store/storeArea/delete`	删除提交	主页面	<el-button> @click -> deleteStoreAreaArr -> storeAreadeleteArr	`deleteStoreArea`
POST	`/dm-store/storeArea/importExcel`	Excel 导入	主页面	-	`importExcel`
POST	`/dm-store/storeArea/exportExcel`	Excel 导出	主页面	-	`exportExcel`

6. 接口详细说明

6.1 `POST /dm-store/storeArea/page`

接口信息

请求地址：/dm-store/storeArea/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 -> deleteStoreAreaArr -> currentChange -> getPage -> pageAjax
activated 生命周期 -> activated -> currentChange -> getPage -> pageAjax
后端入口：storeAreaPage
Service 方法：query

入参

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

json

{
  "pageSize": 10,
  "pageNum": 1,
  "field": "",
  "order": "",
  "ids": [],
  "storeAreaCode": "",
  "storeAreaName": "",
  "storeAreaType": "",
  "location": "",
  "startTime": "",
  "endTime": ""
}

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

field；类型：String；来源：前端当前页面实际发送/可发送
order；类型：String；来源：前端当前页面实际发送/可发送
factoryNo；类型：String；来源：后端对象支持，当前页面未发送
ids；类型：List<Long>；说明：id集合；来源：前端当前页面实际发送/可发送
mainIds；类型：List<Long>；来源：后端对象支持，当前页面未发送
storeAreaCode；类型：String；说明：库区编码；校验：长度不超过 50；来源：前端当前页面实际发送/可发送
storeAreaName；类型：String；说明：库区名称；校验：长度不超过 50；来源：前端当前页面实际发送/可发送
storeAreaNo；类型：String；来源：后端对象支持，当前页面未发送
storeAreaType；类型：Integer；说明：库区类型；来源：前端当前页面实际发送/可发送
location；类型：String；说明：位置；校验：长度不超过 100；来源：前端当前页面实际发送/可发送
startTime；类型：Date；说明：开始时间；来源：前端当前页面实际发送/可发送
endTime；类型：Date；说明：结束时间；来源：前端当前页面实际发送/可发送
storeNo；类型：String；说明：仓库代号；校验：长度不超过 20；来源：后端对象支持，当前页面未发送
partNo；类型：String；来源：后端对象支持，当前页面未发送
partName；类型：String；来源：后端对象支持，当前页面未发送
partCode；类型：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": 1,
      "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；类型：Integer；说明：是否可用 0-否 1-是
description
packageNumber
serialRule
baseUrl
BaseController.getDataTable(IPage<?>) 会固定组装 rows 与 total。
前端 ajax.js 会继续把 ResultData.data 解包后返回给页面。

后端逻辑链路

校验

Controller 入口为 storeAreaPage(@Validated @RequestBody StoreAreaQueryVo storeAreaQueryVo)，由 @Validated 和请求对象注解触发基础参数校验。
已确认的长度校验字段：storeAreaCode、storeAreaName、location、storeNo。

预处理

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

核心业务

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

状态变更

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

数据影响

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

收尾

Controller 调用 getDataTable(...) 把分页对象组装成 {rows, total}。
最终通过 success(map) 返回 ResultData。

数据链路

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

数据流走向

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

备注

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

6.2 `POST /dm-store/storeArea/add`

接口信息

请求地址：/dm-store/storeArea/add
请求方式：POST
功能简述：新增提交
所属页面：主页面
后端入口：addStoreArea
Service 方法：save

入参

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

json

{}

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

出参

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

后端逻辑链路

校验

Controller 入口为 addStoreArea(@Validated @RequestBody StoreAreaVo storeAreaVo)，由 @Validated 和请求对象注解触发基础参数校验。
业务校验会额外检查库存台账占用、物料名称重复和物料编码重复。

预处理

新增时会先通过 Redis 序列号服务生成 partNo。

核心业务

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

状态变更

会向 part_main 插入一条新记录，并在有附件时回写附件 targetId。

数据影响

主表新增一条物料主数据；附件记录绑定到新生成的业务 id。

收尾

Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-store/storeArea/add`	新增	`?.store_area`	`MyBatis-Plus save`	新增物料主数据

数据流走向

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

备注

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

6.3 `POST /dm-store/storeArea/update`

接口信息

请求地址：/dm-store/storeArea/update
请求方式：POST
功能简述：更新提交
所属页面：主页面
后端入口：update
Service 方法：update

入参

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

json

{
  "id": ""
}

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

出参

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

后端逻辑链路

校验

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

预处理

Service 内先构造 LambdaQueryWrapper 作为条件容器。

核心业务

使用 ServiceImpl 通用查询能力拉取目标数据集合。

状态变更

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

数据影响

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

收尾

Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-store/storeArea/update`	更新	`?.store_area`	`MyBatis-Plus updateById`	按 id 更新物料主数据
`POST /dm-store/storeArea/update`	校验查询	`?.stock_main`	`stockMainService.findAllList`	删除或保存前校验物料是否被库存台账占用

数据流走向

数据来源：
前端页面通过当前页面动作触发请求
数据处理路径：
Controller：update
Service：update
使用 ServiceImpl 通用查询能力拉取目标数据集合。
数据落点：
?.store_area
?.stock_main

备注

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

6.4 `POST /dm-store/storeArea/delete`

接口信息

请求地址：/dm-store/storeArea/delete
请求方式：POST
功能简述：删除提交
所属页面：主页面
前端触发链路：
<el-button> @click -> deleteStoreAreaArr -> storeAreadeleteArr
后端入口：deleteStoreArea
Service 方法：delete

入参

后端接口实际接收对象：Long[]
参数位置：body

json

{
  "ids": []
}

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

ids；类型：Long[]；说明：待删除物料主数据 id 集合

出参

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

后端逻辑链路

校验

Controller 入口为 deleteStoreArea(@RequestBody Long[] ids)，由 @Validated 和请求对象注解触发基础参数校验。
删除前会先查库存台账，若物料已被库存台账使用则拒绝删除。

预处理

Service 内先构造 LambdaQueryWrapper 作为条件容器。

核心业务

使用 ServiceImpl 通用查询能力拉取目标数据集合。

状态变更

执行的是逻辑删除：更新 is_delete、update_user、update_time。

数据影响

物料主数据不会物理删库，但会被标记为删除，同时删除对应附件。

收尾

Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-store/storeArea/delete`	逻辑删除	`?.store_area`	`MyBatis-Plus LambdaUpdateWrapper.update`	更新 is_delete、update_user、update_time，逻辑删除物料主数据
`POST /dm-store/storeArea/delete`	校验查询	`?.stock_main`	`stockMainService.findListByParam`	删除或保存前校验物料是否被库存台账占用

数据流走向

数据来源：
前端页面通过 <el-button> @click -> deleteStoreAreaArr -> storeAreadeleteArr 触发请求
数据处理路径：
Controller：deleteStoreArea
Service：delete
使用 ServiceImpl 通用查询能力拉取目标数据集合。
数据落点：
?.store_area
?.stock_main

备注

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

6.5 `POST /dm-store/storeArea/importExcel`

接口信息

请求地址：/dm-store/storeArea/importExcel
请求方式：POST
功能简述：Excel 导入
所属页面：主页面
后端入口：importExcel
Service 方法：importExcel

入参

后端接口实际接收对象：MultipartFile
参数位置：formData

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

file；类型：MultipartFile；说明：Excel 文件；校验：必填

出参

外层响应：ResultData<ImportResultInfo>
业务数据体：导入结果对象
当前链路可证实返回导入成功/失败汇总，但未继续展开 ImportResultInfo 的全部字段定义。

后端逻辑链路

校验

导入链路除了基础 Bean 校验，还会检查文件内重复、必填字段、controlType 联动规则以及供应商有效性。

预处理

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

核心业务

导入入口交给 ExcelImportHandler.execute(...)，再由 handleImportData(...) 做明细校验与落库。

状态变更

成功导入后会批量新增或更新 part_main。

数据影响

导入数据会对主表做批量 upsert。

收尾

Controller 通过 success(...) 返回框架统一成功响应。

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-store/storeArea/importExcel`	更新	`?.store_area`	`MyBatis-Plus saveOrUpdateBatch`	批量新增或更新物料主数据

数据流走向

数据来源：
前端页面通过当前页面动作触发请求
数据处理路径：
Controller：importExcel
Service：importExcel
导入入口交给 ExcelImportHandler.execute(...)，再由 handleImportData(...) 做明细校验与落库。
数据落点：
?.store_area

备注

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

6.6 `POST /dm-store/storeArea/exportExcel`

接口信息

请求地址：/dm-store/storeArea/exportExcel
请求方式：POST
功能简述：Excel 导出
所属页面：主页面
后端入口：exportExcel
Service 方法：exportStoreAreaExcel

入参

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

json

{
  "ids": [],
  "field": "",
  "order": "",
  "storeAreaCode": "",
  "storeAreaName": "",
  "storeAreaType": "",
  "location": "",
  "selectDate": ""
}

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

field；类型：String；来源：前端导出动作实际可发送
order；类型：String；来源：前端导出动作实际可发送
factoryNo；类型：String；来源：后端对象支持，当前导出动作未发送
ids；类型：List<Long>；说明：id集合；来源：前端导出动作实际可发送
mainIds；类型：List<Long>；来源：后端对象支持，当前导出动作未发送
storeAreaCode；类型：String；说明：库区编码；校验：长度不超过 50；来源：前端导出动作实际可发送
storeAreaName；类型：String；说明：库区名称；校验：长度不超过 50；来源：前端导出动作实际可发送
storeAreaNo；类型：String；来源：后端对象支持，当前导出动作未发送
storeAreaType；类型：Integer；说明：库区类型；来源：前端导出动作实际可发送
location；类型：String；说明：位置；校验：长度不超过 100；来源：前端导出动作实际可发送
startTime；类型：Date；说明：开始时间；来源：后端对象支持，当前导出动作未发送
endTime；类型：Date；说明：结束时间；来源：后端对象支持，当前导出动作未发送
storeNo；类型：String；说明：仓库代号；校验：长度不超过 20；来源：后端对象支持，当前导出动作未发送
partNo；类型：String；来源：后端对象支持，当前导出动作未发送
partName；类型：String；来源：后端对象支持，当前导出动作未发送
partCode；类型：String；来源：后端对象支持，当前导出动作未发送

出参

外层响应：文件下载流
业务数据体：Excel 二进制响应
前端通过下载服务直接处理文件响应，不经过普通 JSON 列表渲染。

后端逻辑链路

校验

Controller 入口为 exportExcel(@Validated @RequestBody StoreAreaQueryVo storeAreaQueryVo, HttpServletResponse response)，由 @Validated 和请求对象注解触发基础参数校验。

预处理

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

核心业务

把查询结果转成 Excel 视图对象后导出文件。

状态变更

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

数据影响

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

收尾

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

数据链路

接口	调用类型	库名.表名	mapper.page	sql作用（简写）
`POST /dm-store/storeArea/exportExcel`	查询	`?.store_area`	`MyBatis-Plus ServiceImpl.list`	按筛选条件导出物料主数据

数据流走向

数据来源：
前端页面通过当前页面动作触发请求
数据处理路径：
Controller：exportExcel
Service：exportStoreAreaExcel
把查询结果转成 Excel 视图对象后导出文件。
数据落点：
?.store_area

备注

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

重点组件说明

组件：index

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

7. 子组件列表

seat：路由路径 /default/devicemate/information/warehouse/seat

8. 修改入口

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

reservoir 链路分析 ​

Vue 组件总览 ​

辅助组件说明 ​

技术图 ​

1. 页面概览 ​

2. 上游入口 ​

3. 业务页面跳转链路 ​

4. 前端真实调用链 ​

5. 接口总览 ​

6. 接口详细说明 ​

6.1 POST /dm-store/storeArea/page ​

接口信息 ​

入参 ​

出参 ​

后端逻辑链路 ​

reservoir 链路分析

Vue 组件总览

辅助组件说明

技术图

1. 页面概览

2. 上游入口

3. 业务页面跳转链路

4. 前端真实调用链

5. 接口总览

6. 接口详细说明

6.1 `POST /dm-store/storeArea/page`

接口信息

入参

出参

后端逻辑链路