-- 表：wms_inventory
-- 用途：库存余额。某个货主、仓库、库位、SKU、批次上的数量结果。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：余额是结果。任何数量变化必须与 wms_stock_log 处于同一事务。扣减使用带数量条件的原子 UPDATE（affected rows = 0 即库存不足），禁止先 SELECT 再在应用里计算后 UPDATE。多行更新按 id 升序加锁。库位上的待检、待上架库存放在收货或质检库位，靠库位策略排除出可分配范围，不另设数量桶。

CREATE TABLE `wms_inventory` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
  `warehouse_code` VARCHAR(32) NOT NULL COMMENT '仓库编码',
  `customer_code` VARCHAR(32) NOT NULL COMMENT '货主编码',
  `location_code` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '库位编码；在途库存使用空字符串，表示仓库级',
  `sku_code` VARCHAR(64) NOT NULL COMMENT 'SKU 编码',
  `batch_no` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '批次号，不管批次时为空字符串',
  `available_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '可用数量',
  `reserved_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '预占数量，已分配给出库尚未拣货',
  `picked_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '已拣数量，已拣下尚未出库',
  `hold_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '冻结数量',
  `damaged_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '残损数量',
  `in_transit_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '在途数量，只出现在库位编码为空的行',
  `version` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '乐观锁版本',
  `created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  `updated_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_inventory_bucket` (`tenant_code`, `warehouse_code`, `customer_code`, `location_code`, `sku_code`, `batch_no`),
  KEY `idx_tenant_wh_sku` (`tenant_code`, `warehouse_code`, `sku_code`),
  KEY `idx_tenant_sku` (`tenant_code`, `sku_code`),
  KEY `idx_tenant_wh_location` (`tenant_code`, `warehouse_code`, `location_code`),
  CONSTRAINT `chk_inventory_qty_nonneg` CHECK (
    `available_qty` >= 0 AND `reserved_qty` >= 0 AND `picked_qty` >= 0
    AND `hold_qty` >= 0 AND `damaged_qty` >= 0 AND `in_transit_qty` >= 0
  )
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='库存余额';