outOfStockAdd 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/inventory/outOfStock/outOfStockAdd.vue

前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/inventory/safety/safety.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/StoreMainController.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/StoreMainServiceImpl.java

主表：store_main

Vue 组件总览

组件	层级路径	角色	是否主链路	是否直接CRUD	独立MD	跳转	一句话作用
index	index	主页面	是	否	当前页	查看	承接 outOfStockAdd 页面主入口、列表查询和业务操作入口。
selectStoreMain	index > selectStoreMain	共享业务组件	是	否	否	查看	作为共享组件复用在当前页面主链路中，负责业务处理。
importFile	index > importFile	业务化公共组件	是	否	否	查看	复用通用组件外壳，但当前页通过 :import-file-ajax 注入业务配置，承接业务处理。

辅助组件说明

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

技术图

• Flow 布局：standard

• Summary 布局：standard

1. 页面概览

• 当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/inventory/outOfStock/outOfStockAdd.vue。
• 当前节点识别到 2 个重点组件、8 个辅助组件。
• 当前节点识别到 0 条业务页面跳转链路、1 个真实接口。

2. 上游入口

• outOfStock 通过 <el-button> @click 跳转到当前页，路由为 /default/devicemate/inventory/outOfStock/outOfStockAdd。

3. 业务页面跳转链路

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

4. 前端真实调用链

• <el-button> @click -> getTemplateData -> getTemplateList
• <importFile> @importAction -> importAction -> getData / addData

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	/dm-store/storeMain/queryStoreMain	业务请求	主页面	-	queryStoreMain

6. 接口详细说明

6.1 POST /dm-store/storeMain/queryStoreMain

接口信息

• 请求地址：/dm-store/storeMain/queryStoreMain
• 请求方式：POST
• 功能简述：业务请求
• 所属页面：主页面
• 后端入口：queryStoreMain
• Service 方法：findStoreMain

入参

• 参数位置：unknown

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

出参

• 外层响应：ResultData

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

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

后端逻辑链路

1. 校验

• Controller 入口为 queryStoreMain(@Validated @RequestBody(required = false) StoreMainQueryVo storeMainQueryVo)，由 @Validated 和请求对象注解触发基础参数校验。

2. 预处理

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

3. 核心业务

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

4. 状态变更

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

5. 数据影响

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

6. 收尾

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

数据链路

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

数据流走向

• 数据来源：
• 前端页面通过 当前页面动作 触发请求
• 数据处理路径：
• Controller：queryStoreMain
• Service：findStoreMain
• 使用 ServiceImpl 通用查询能力拉取目标数据集合。
• 数据落点：
• 当前链路未识别到明确数据落点。

备注

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

重点组件说明

组件：index

• 角色：主页面
• 层级路径：index
• 是否直接CRUD：否
• 一句话作用：承接 outOfStockAdd 页面主入口、列表查询和业务操作入口。
• 下游重点组件：selectStoreMain / importFile

组件：selectStoreMain

• 角色：共享业务组件
• 层级路径：index > selectStoreMain
• 父组件：index
• 是否直接CRUD：否
• 一句话作用：作为共享组件复用在当前页面主链路中，负责业务处理。
• 详细说明：不单独生成 MD，说明保留在当前主页面文档。

组件：importFile

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

7. 子组件列表

• 当前节点没有继续下钻的子文档。

8. 修改入口

• 改当前节点逻辑：先看上游入口，再看组件总览和业务页面跳转链路，最后核对接口与后端落点。
• 当前自动分析未识别出额外高风险点，但仍建议顺着子组件列表逐级核对。