4. 召回批次库存锁定业务逻辑

召回批次库存锁定是召回管理的核心环节，其目标是在WMS系统中将指定批次的库存从“可售/可用”状态转变为“锁定/冻结”状态，防止这些库存被正常订单出库。本章详细阐述锁定策略的三种维度以及锁定状态机的完整设计。

4.1 锁定策略：三种核心维度

在实际业务中，召回操作并非总是针对整个批次。系统需要提供灵活的锁定策略，以应对不同的召回原因和范围。以下是三种最常用的锁定策略：

4.2 锁定策略执行流程

当接收到锁定请求时，系统会根据指定的策略，在WMS库存表中检索符合条件的库存记录，并执行锁定操作。以下流程图展示了按批次锁定的典型执行路径：

4.3 锁定状态机设计

库存锁定不是单一状态，而是一个包含多个阶段的生命周期。设计清晰的状态机，可以确保锁定操作的幂等性、可追溯性和安全性。以下是召回批次库存锁定的核心状态定义：

4.4 状态转换图

下图展示了库存锁定状态机的完整转换路径，以及触发状态变更的关键操作：

4.5 锁定记录数据结构

为了支持上述策略和状态机，数据库中的锁定记录表应包含以下核心字段：

-- 召回库存锁定记录表 (recall_stock_lock)
CREATE TABLE recall_stock_lock (
    id              BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键ID',
    lock_no         VARCHAR(64) NOT NULL COMMENT '锁定单号，全局唯一',
    recall_order_id BIGINT NOT NULL COMMENT '关联的召回单ID',
    sku_code        VARCHAR(64) NOT NULL COMMENT '商品编码',
    lot_no          VARCHAR(64) COMMENT '批次号（按批次锁定）',
    prod_date       DATE COMMENT '生产日期（按生产日期锁定）',
    supplier_code   VARCHAR(64) COMMENT '供应商编码（按供应商锁定）',
    lock_qty        DECIMAL(18,2) NOT NULL COMMENT '锁定数量',
    lock_status     VARCHAR(20) NOT NULL DEFAULT 'LOCKED' COMMENT '锁定状态：FREE/LOCKED/ISOLATED/SCRAPPED/UNLOCKED',
    lock_reason     VARCHAR(255) COMMENT '锁定原因',
    created_by      VARCHAR(64) COMMENT '创建人',
    created_at      DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    updated_at      DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    INDEX idx_recall_order (recall_order_id),
    INDEX idx_lot_no (lot_no),
    INDEX idx_lock_status (lock_status)
) COMMENT='召回库存锁定记录表';