fix(lastleg): account return carton outbound stock atomically

lastleg-service/src/main/resources/db/lastleg.sql

@@ -2487,6 +2487,34 @@ CREATE TABLE IF NOT EXISTS ll_return_inventory_carton_item (
  id BIGINT NOT NULL COMMENT '退货库存箱SKU明细ID', carton_id BIGINT NOT NULL COMMENT '退货库存箱ID', customer_id VARCHAR(128) NOT NULL COMMENT '客户ID和隔离键', sku_code VARCHAR(128) NOT NULL COMMENT 'SKU编码', product_name_zh VARCHAR(255) NULL COMMENT '中文品名', quantity BIGINT NOT NULL COMMENT '该SKU箱内数量',
  PRIMARY KEY(id), UNIQUE KEY uk_ll_return_inventory_carton_item(carton_id,sku_code), KEY idx_ll_return_inventory_carton_item_customer(customer_id,sku_code), CONSTRAINT chk_ll_return_inventory_carton_item_quantity CHECK(quantity>0)
 ) ENGINE=InnoDB COMMENT='退货库存箱内SKU和数量';
+-- 退货出库按SKU固化扣减前后快照，与PDA拣货同事务提交；不修改历史箱内容。
+CREATE TABLE IF NOT EXISTS ll_return_inventory_outbound_movement (
+ id BIGINT NOT NULL COMMENT '退货出库SKU流水ID',
+ outbound_pick_id BIGINT NOT NULL COMMENT '同事务PDA出库拣货记录ID',
+ customer_id VARCHAR(128) NOT NULL COMMENT '库存所属客户ID和隔离键',
+ overseas_warehouse_id VARCHAR(128) NOT NULL COMMENT '实际出库海外仓ID',
+ carton_id BIGINT NOT NULL COMMENT '真实退货库存箱ID',
+ carton_mark VARCHAR(128) NOT NULL COMMENT '冻结的真实退货箱业务码',
+ outbound_no VARCHAR(64) NOT NULL COMMENT '本次退货出库业务单号',
+ sku_code VARCHAR(128) NOT NULL COMMENT '本次出库SKU编码快照',
+ product_name_zh VARCHAR(255) NULL COMMENT '中文品名快照',
+ quantity BIGINT NOT NULL COMMENT '本箱该SKU实际出库件数，始终为正',
+ total_before BIGINT NOT NULL COMMENT '客户仓SKU出库前实物总数量',
+ total_after BIGINT NOT NULL COMMENT '客户仓SKU出库后实物总数量',
+ available_before BIGINT NOT NULL COMMENT '客户仓SKU出库前可用数量',
+ available_after BIGINT NOT NULL COMMENT '客户仓SKU出库后可用数量',
+ cartons_before BIGINT NOT NULL COMMENT '客户仓包含该SKU的出库前可用箱数',
+ cartons_after BIGINT NOT NULL COMMENT '客户仓包含该SKU的出库后可用箱数',
+ occurred_at DATETIME(3) NOT NULL COMMENT '出库记账时间',
+ PRIMARY KEY(id),
+ UNIQUE KEY uk_ll_return_outbound_pick_sku(outbound_pick_id,sku_code),
+ UNIQUE KEY uk_ll_return_outbound_carton_sku(customer_id,carton_id,sku_code),
+ KEY idx_ll_return_outbound_movement_query(customer_id,overseas_warehouse_id,sku_code,occurred_at),
+ CONSTRAINT chk_ll_return_outbound_movement_delta CHECK(quantity>0 AND total_after>=0 AND available_after>=0
+   AND total_before-total_after=quantity AND available_before-available_after=quantity
+   AND cartons_after>=0 AND cartons_before-cartons_after=1 AND total_after>=available_after)
+) ENGINE=InnoDB COMMENT='不可变退货出库SKU库存流水';
+
 CREATE TABLE IF NOT EXISTS ll_return_inventory_balance (
  id BIGINT NOT NULL COMMENT '退货库存余额ID', customer_id VARCHAR(128) NOT NULL COMMENT '客户ID和隔离键', overseas_warehouse_id VARCHAR(128) NOT NULL COMMENT '海外仓ID', sku_code VARCHAR(128) NOT NULL COMMENT 'SKU编码', product_name_zh VARCHAR(255) NULL COMMENT '中文品名', total_quantity BIGINT NOT NULL DEFAULT 0 COMMENT '实物总库存，仅实际出库扣减', available_quantity BIGINT NOT NULL COMMENT '未合箱可用上架数量', carton_quantity BIGINT NOT NULL COMMENT '包含该SKU的可用箱数', created_at DATETIME(3) NOT NULL COMMENT '创建时间', updated_at DATETIME(3) NOT NULL COMMENT '最后更新时间',
  PRIMARY KEY(id), UNIQUE KEY uk_ll_return_inventory_balance(customer_id,overseas_warehouse_id,sku_code), CONSTRAINT chk_ll_return_inventory_balance_quantity CHECK(total_quantity>=available_quantity AND available_quantity>=0 AND carton_quantity>=0)