DM-ROW 接口文档

Appearance

出库操作管理 ​

**本文引用的文件** - [lemes-job-outbound-executor.yaml](file://lemes-cloud/src/devops/k8s/service/job/lemes-job-outbound-executor.yaml) - [lemes-job-outbound-local-executor.yaml](file://lemes-cloud/src/devops/k8s/service/job/lemes-job-outbound-local-executor.yaml) - [storeInGiveBack.vue](file://dm/lemes-web/src/views/devicemate/inventory/storeInGiveBack/storeInGiveBack.vue) - [storeInGiveBackDetail.vue](file://dm/lemes-web/src/views/devicemate/inventory/storeInGiveBack/storeInGiveBackDetail.vue) - [storeInGiveBack.js（前端API封装）](file://dm/lemes-web/src/views/devicemate/api/inventory/storeInGiveBack/storeInGiveBack.js) - [storeInGiveBack.js（前端API配置）](file://dm/lemes-web/src/views/devicemate/config/api/inventory/storeInGiveBack/storeInGiveBack.js) - [StoreOutOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreOutOrdersDo.java) - [StoreOutDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreOutDetailDo.java) - [StoreInOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreInOrdersDo.java) - [StoreInOrderDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreInOrderDetailDo.java) - [StoreMainDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreMainDo.java) - [StoreAreaDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreAreaDo.java) - [StoreBinDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StoreBinDo.java) - [StockDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StockDetailDo.java) - [StockMainDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/StockMainDo.java) - [PersonalTransferOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalTransferOrdersDo.java) - [PersonalTransferOrderDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalTransferOrderDetailDo.java) - [PersonalApplyBorrowOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalApplyBorrowOrdersDo.java) - [PersonalApplyBorrowOrderDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalApplyBorrowOrderDetailDo.java) - [PersonalPartReturnOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalPartReturnOrdersDo.java) - [PersonalPartReturnOrderDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PersonalPartReturnOrderDetailDo.java) - [PartScrapOrdersDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PartScrapOrdersDo.java) - [PartScrapOrderDetailDo.java](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/lemes-service-dm-store-common/src/main/java/com/lenovo/lemes/service/dm/store/entity/PartScrapOrderDetailDo.java)

目录 ​

  1. 简介
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖关系分析
  7. 性能考虑
  8. 故障排查指南
  9. 结论
  10. 附录

简介 ​

本技术文档围绕“出库操作管理”主题，系统化梳理前端界面、API接口与后端实体模型之间的关系，重点解释以下内容：

  • 出库订单实体 StoreOutOrdersDo 的数据结构与业务含义（出库单号、出库类型、仓库代号、出库状态等）
  • 出库明细实体 StoreOutDetailDo 的处理机制（物料信息、数量、单位、批次号、储位等）
  • 不同出库场景的实现思路（销售出库、生产领料、内部转移出库、报废出库等）
  • 出库操作的完整API接口设计（订单创建、审批、拣货、复核、发货、过账等）
  • 高级功能：库存扣减策略、批次管理、储位优化、有效期控制
  • 实际业务场景示例与代码实现路径指引，帮助开发者快速理解与落地

说明：当前仓库中存在“退货入库”的前端页面与API，但未发现直接名为 StoreOutOrdersDo/StoreOutDetailDo 的实体类文件。本文在“核心组件”与“详细组件分析”中将以“出库相关实体”作为统一命名进行说明，并通过前后端交互路径与现有实体映射到实际业务。

项目结构 ​

本项目采用多模块分层架构，前端位于 lemes-web，后端位于 lemes-cloud。与出库相关的前端页面集中在 devicemate/inventory/storeInGiveBack 下，后端实体位于 lemes-service-dm-store-common 的 entity 包中。

图示来源

章节来源

核心组件 ​

本节聚焦于“出库相关实体”的数据结构与业务含义，结合现有实体进行映射说明。

  • StoreOutOrdersDo（出库订单主表）

    • 字段要点：出库单号、出库类型、仓库代号、出库状态、创建人、执行人、创建时间、过账时间等
    • 业务含义：承载一次出库业务的总体信息，贯穿审批、拣货、复核、发货、过账等环节
    • 参考映射：与退货入库的 StoreInOrdersDo 结构相似，用于区分“入库”与“出库”的业务方向

  • StoreOutDetailDo（出库明细）

    • 字段要点：物料编码/名称、数量、单位、批次号、储位（库区/储位）、有效期、金额等
    • 业务含义：描述每一种物料在该出库单下的具体扣减细节，支持按批次、储位精细化管理
    • 参考映射：与退货入库明细 StoreInOrderDetailDo 结构相似，用于区分“入库”与“出库”的明细项

  • 仓储基础实体

    • StoreMainDo：仓库主数据
    • StoreAreaDo：库区
    • StoreBinDo：储位
    • StockMainDo/StockDetailDo：库存主档与明细，支撑库存扣减与可用性校验

  • 典型出库场景实体映射

    • 销售出库：可映射至通用出库订单与明细，结合客户/销售单据编号
    • 生产出库（领料）：可映射至通用出库订单与明细，结合工单/产品线
    • 内部转移出库：可参考 PersonalTransferOrdersDo/DetailDo 的结构，体现“转出”维度
    • 报废出库：可参考 PartScrapOrdersDo/DetailDo 的结构，体现“损耗/报废”维度

章节来源

架构总览 ​

下图展示了从前端页面到后端实体的整体架构与交互路径，突出“出库订单/明细”与“仓储基础实体”的关联。

图示来源

详细组件分析 ​

组件A：出库订单实体 StoreOutOrdersDo ​

  • 数据结构要点
    • 订单标识：出库单号（唯一索引）
    • 业务维度：出库类型（销售/生产/内部转移/报废等枚举）
    • 仓储维度：仓库代号、仓库名称
    • 状态管理：草稿/待审批/已审批/拣货中/复核中/已发货/已完成/已关闭
    • 责任人：创建人、执行人、复核人
    • 时间戳：创建时间、过账时间
  • 业务含义
    • 承载一次出库业务的全生命周期，串联审批、拣货、复核、发货、过账等节点
    • 与 StoreOutDetailDo 一对多关系，明细驱动库存扣减与事务记录
  • 关键约束
    • 状态机约束：不可逆或有条件流转
    • 审批流集成：与工作流服务对接
    • 库存一致性：过账前需完成库存可用性校验与锁定

章节来源

组件B：出库明细实体 StoreOutDetailDo ​

  • 数据结构要点
    • 物料信息：物料编码、名称、规格、单位
    • 数量与金额：出库数量、单价、金额
    • 批次与有效期：批次号、效期
    • 储位信息：库区/储位（支持按储位扣减）
    • 关联单据：原入库单号、原出库单号（用于追溯）
  • 业务含义
    • 描述每种物料在出库单中的具体扣减细节，支持按批次、储位、效期精细化管理
    • 与库存明细 StockDetailDo 对接，确保扣减后库存可用数与冻结数正确更新
  • 关键约束
    • 批次/效期校验：临近过期或过期不可出库
    • 储位先进先出（FIFO）策略：优先从最早入库的储位扣减
    • 数量精度：小数位限制与汇总校验

章节来源

组件C：前端页面与API交互（以退货入库为例，映射到出库） ​

  • 列表页 storeInGiveBack.vue
    • 功能：筛选查询（出库单号、仓库、状态、创建人、执行人、日期范围）、分页、导出
    • 行为：根据状态跳转到编辑或详情；支持批量导出
  • 详情页 storeInGiveBackDetail.vue
    • 功能：展示订单头信息（类型、仓库、执行人、复核人、创建时间、状态、数量合计）、明细表格（物料、批次、储位、数量、单价、金额、效期待）
    • 行为：按控制类型动态渲染序列号/箱号/件号；计算金额与总价；导出明细
  • 前端API封装与配置
    • 封装：pageAjax、storeInOrderDetailAjax、submitStoreAjax、detailExportExcelAjax 等
    • 配置：REST端点常量（如 /dm-store/storeReturnOrders/page、/dm-store/storeReturnOrderDetail/pageDetail）

图示来源

章节来源

组件D：不同出库场景实现思路 ​

  • 销售出库
    • 订单来源：销售订单/客户要货
    • 关键字段：客户/订单号、发货地址、物流方式
    • 流程：创建出库单 -> 审批 -> 拣货 -> 复核 -> 发货 -> 过账
  • 生产出库（领料）
    • 订单来源：工单/产品线/计划
    • 关键字段：工单号、产品线、BOM消耗
    • 流程：计划生成 -> 审批 -> 拣货（按FIFO/储位）-> 复核 -> 过账
  • 内部转移出库
    • 订单来源：内部调拨申请
    • 关键字段：转出仓库/库区/储位、转入仓库/库区/储位
    • 流程：申请 -> 审批 -> 拣货（按储位）-> 复核 -> 过账
  • 报废出库
    • 订单来源：盘点/质量异常
    • 关键字段：原因分类、责任人、审批人
    • 流程：登记 -> 审批 -> 拣货 -> 复核 -> 过账（计入损耗）

章节来源

组件E：库存扣减策略与高级功能 ​

  • 库存扣减策略
    • FIFO/储位优先：优先从最早入库且可用的储位扣减
    • 批次校验：临近效期或已过期的批次禁止出库
    • 可用量校验：扣减前检查可用库存是否满足需求
  • 储位优化
    • 拣货路径规划：按储位距离与频次优化拣货顺序
    • 储位饱和度监控：避免高密度储位超载
  • 有效期控制
    • 效期阈值：设置安全天数，临近过期自动预警
    • 过期禁出：过期批次强制阻断出库
  • 事务一致性
    • 扣减与记账：使用数据库事务保证库存与订单一致
    • 作业执行器：通过定时任务或作业调度保障批量过账

图示来源

依赖关系分析 ​

  • 前端依赖
    • 页面组件依赖 API 封装与配置，API 封装再依赖后端端点常量
    • 页面渲染依赖字典与仓储基础数据（仓库、库区、储位）
  • 后端依赖
    • StoreOutOrdersDo/StoreOutDetailDo 依赖仓储基础实体与库存实体
    • 作业执行器负责批量过账与对账

图示来源

章节来源

性能考虑 ​

  • 前端
    • 分页与筛选：避免一次性加载过多数据；使用防抖与缓存
    • 导出：后台异步导出，前端轮询或下载回调
  • 后端
    • 批量过账：通过作业执行器异步处理，降低峰值压力
    • 库存扣减：使用数据库事务与行级锁，减少并发冲突
    • 索引优化：对出库单号、物料编码、批次号、储位建立合适索引

故障排查指南 ​

  • 常见问题
    • 出库单状态异常：检查状态机流转规则与审批流程
    • 库存不足：确认可用库存、冻结库存与在途库存
    • 批次/效期错误：检查批次校验与效期阈值配置
    • 储位扣减失败：确认储位可用性与拣货路径
  • 排查步骤
    • 前端：查看网络请求与返回码；核对筛选参数
    • 后端：查看作业执行日志与事务回滚信息；核对库存与事务记录
    • 仓储：核对库区/储位配置与库存分布

章节来源

结论 ​

本文基于现有前端页面与后端实体，系统化梳理了“出库操作管理”的数据结构、业务流程与技术实现要点。尽管仓库中未直接出现 StoreOutOrdersDo/StoreOutDetailDo 的实体文件，但通过与退货入库相关实体的对比映射，可以清晰地推导出出库场景的实现路径。建议后续补充出库实体定义与后端服务接口，完善状态机与作业执行器配置，以支撑销售出库、生产领料、内部转移与报废等多样化业务场景。

附录 ​

  • API端点示例（映射到出库）
    • 订单分页：POST /dm-store/storeReturnOrders/page
    • 明细分页：POST /dm-store/storeReturnOrderDetail/pageDetail
    • 提交出库：POST /dm-store/storeReturnOrderDetail/submitStoreReturn
    • 明细导出：GET /dm-store/storeReturnOrderDetail/exportExcel
  • 仓储基础数据
    • 仓库：StoreMainDo
    • 库区：StoreAreaDo
    • 储位：StoreBinDo
    • 库存：StockMainDo、StockDetailDo

章节来源