【WMS学习笔记系列】03-功能模块设计

功能模块设计

3.1 模块总览

WMS 功能模块 ├── 基础数据管理 → wms-core ├── 入库管理 → wms-inbound ├── 出库管理 → wms-outbound ├── 库存管理 → wms-inventory ├── 盘点管理 → wms-count └── 报表看板 → wms-report

3.2 入库管理流程

3.2.1 整体状态机

ASN 创建 → 已通知 → 收货中 → 收货完成 → 上架中 → 上架完成 ↓ ↓ 已取消 异常

3.2.2 详细流程

Step 1: ASN 创建 │ 上游（采购系统/ERP）推送 ASN 数据 │ 包含：ASN 单号、供应商、预计到货时间、商品明细 │ 状态：已通知 │ Step 2: 收货 │ 仓库管理员扫描 ASN 单号 │ 逐 SKU 扫描条码 / 输入实收数量 │ 系统校验：实收 vs 预计 │ ├── 一致 → 收货完成 │ ├── 少于 → 标记差异，部分收货 │ └── 多于 → 标记异常（无单收货审批） │ Step 3: 上架 │ 系统根据上架策略推荐库位 │ 管理员扫描库位码确认上架 │ 库存数量 +N，库位状态更新 │ 状态：上架完成

3.2.3 上架策略伪代码

public List<Location> recommendLocations(Sku sku, int qty) { // 1. 查询该 SKU 已有库存的库位 List<Location> existingLocations = inventoryMapper .findLocationsBySkuId(sku.getId()); if (!existingLocations.isEmpty()) { return existingLocations.stream() .filter(loc -> loc.getAvailableCapacity() >= qty) .sorted(Comparator.comparingInt(Location::getAvailableCapacity)) .limit(3) .collect(Collectors.toList()); } // 2. 按 ABC 分类 + 容量筛选空库位 String abcClass = sku.getAbcClass(); // A / B / C return locationMapper.findAvailableByAbcClass(abcClass, qty, 3); }

3.3 出库管理流程

3.3.1 整体状态机

订单接收 → 波次生成 → 分配库存 → 拣货中 → 拣货完成 → 复核中 → 复核完成 → 已发货 ↓ ↓ ↓ ↓ 已取消 缺货异常 缺货标记 差异退回

3.3.2 详细流程

Step 1: 订单接收 │ OMS 推送出库订单 │ 含：订单号、客户、商品明细、期望发货时间、承运商 │ Step 2: 波次生成 │ 根据波次策略将多个订单合并为波次 │ 波次 = 拣货任务的基本单位 │ Step 3: 库存分配 │ 按 FIFO / 批次优先规则分配库存 │ 锁定库存（预占，防止被其他订单抢走） │ 生成拣货任务清单 │ Step 4: 拣货 │ 拣货员 PDA 接收任务 │ 系统按库位排序优化拣货路径 │ 扫描库位 → 扫描商品 → 确认数量 │ Step 5: 复核 │ 扫描订单号 → 逐件扫描商品条码 │ 重量校验：实际重量 vs 理论重量 │ 差异处理 │ Step 6: 打包发货 │ 打印面单、装箱清单 │ 称重、测量体积 │ 交接承运商 → 扣减库存

3.3.3 拣货路径优化

仓库库位布局示例（数字为库位编号）： ┌──────────────────────────────┐ │ 01 02 03 04 │ 21 22 23 │ ← A 区（快周转） │ 05 06 07 08 │ 24 25 26 │ │─────────────────────────────│ │ 09 10 11 12 │ 27 28 29 │ ← B 区（中周转） │ 13 14 15 16 │ 30 31 32 │ │─────────────────────────────│ │ 17 18 19 20 │ 33 34 35 │ ← C 区（慢周转） └──────────────────────────────┘ ↑ 复核区 / 发货区 优化后路径：从靠近发货区的库位开始， 由近到远排列拣货任务 示例：需要拣 03, 18, 25 三个库位 原始顺序：03 → 18 → 25 (S型路径，效率低) 优化顺序：25 → 03 → 18 (由近及远)

3.3.4 播种式 vs 摘果式拣货

3.4 库存管理

3.4.1 库存维度模型

库存 = f(仓库, SKU, 库位, 批次, 状态, 货主) 查询示例： "查询仓库1中 SKU-1001 在所有库位的可用库存" → SUM(quantity) WHERE warehouse_id=1 AND sku_id=1001 AND status='AVAILABLE'

3.4.2 库存状态

3.4.3 库存扣减时序

出库订单分配库存的时序（防止并发超扣）： ┌────────────────┐ │ 开启事务 (BEGIN) │ └───────┬────────┘ ▼ ┌───────────────────────────────────┐ │ SELECT * FROM inventory │ │ WHERE sku_id = ? │ │ AND status = 'AVAILABLE' │ │ AND quantity > 0 │ │ ORDER BY production_date ASC │ ← FIFO: 先过期先出 │ FOR UPDATE │ ← 行锁 └───────┬───────────────────────────┘ ▼ ┌────────────────────────┐ │ 计算扣减量，逐行扣减 │ │ 若 quantity >= need： │ │ 扣 need，完成 │ │ 若 quantity < need： │ │ 全扣，继续下一行 │ └───────┬────────────────┘ ▼ ┌────────────────────┐ │ 更新库存行 │ │ 插入库存变更流水 │ └───────┬────────────┘ ▼ ┌──────────────────┐ │ 提交事务 (COMMIT) │ └──────────────────┘

3.4.4 安全库存预警

-- 低库存预警：当前可用库存 < 安全库存阈值 SELECT s.sku_code, s.sku_name, s.safety_stock, COALESCE(SUM(i.quantity), 0) AS current_stock FROM sku s LEFT JOIN inventory i ON s.id = i.sku_id AND i.status = 'AVAILABLE' GROUP BY s.id HAVING current_stock < s.safety_stock;

3.5 盘点管理

3.5.1 盘点类型

3.5.2 盘点流程

Step 1: 创建盘点计划 │ 选择盘点类型、范围（仓库/库区/SKU） │ 选择盘点方式：明盘（显示系统库存）/ 盲盘（不显示） │ Step 2: 生成盘点任务 │ 按库位/库区拆分任务 │ 分配盘点人员 │ 库位冻结（可选，盘点期间禁止出入库操作） │ Step 3: 执行盘点 │ 盘点员扫描库位码 │ 逐 SKU 扫描条码，录入实际数量 │ 系统对比账面数量 │ Step 4: 差异处理 │ 无差异 → 盘点完成 │ 有差异 → 复盘（二次盘点） │ 复盘仍有差异 → 生成差异报告 → 主管审核 │ Step 5: 库存调整 │ 审核通过后调整库存 │ 生成盘盈/盘亏单据 │ 记录操作日志

3.5.3 盘点锁定策略

盘点锁库策略（针对部分盘点）： ┌──────────────────────────────────────┐ │ 临时表：count_lock │ │ ┌──────────┬──────────┬────────────┐ │ │ │ location │ lock_type │ lock_time │ │ │ ├──────────┼──────────┼────────────┤ │ │ │ A-01-01 │ COUNTING │ 2026-07-30 │ │ │ │ A-01-02 │ COUNTING │ 2026-07-30 │ │ │ └──────────┴──────────┴────────────┘ │ │ │ │ 出入库时检查：若库位在 count_lock 中 │ │ 且 lock_type=COUNTING，则拒绝操作 │ └──────────────────────────────────────┘

3.6 库位管理

3.6.1 库位编码规则

推荐编码格式：仓库-库区-排-列-层 示例：WH01-A-03-05-02 WH01 仓库编号 A 库区（A区快周转 / B区中周转 / C区慢周转） 03 第 3 排货架 05 第 5 列 02 第 2 层

3.6.2 库位属性

3.7 事件驱动解耦

业务模块之间通过 Spring Event / RabbitMQ 解耦：

入库完成事件 ├── → 库存模块：更新库存 ├── → 报表模块：更新入库统计 └── → 通知模块：发送入库通知 出库完成事件 ├── → 库存模块：扣减库存 ├── → 报表模块：更新出库统计 └── → OMS：回传发货状态 盘点调整事件 ├── → 库存模块：调整库存 └── → 审计模块：记录调整日志

// 事件定义 public class InboundCompletedEvent extends ApplicationEvent { private final Long asnId; private final List<InboundDetail> details; // ... } // 事件发布 @Transactional public void completeInbound(Long asnId) { // 业务处理... eventPublisher.publishEvent(new InboundCompletedEvent(this, asnId, details)); } // 事件监听 @Component public class InventoryEventListener { @EventListener @Transactional public void handleInboundCompleted(InboundCompletedEvent event) { // 更新库存 } }