-- 表：wms_stock_log
-- 用途：库存流水。库存变化的事实记录，只能追加。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：一次业务动作跨两个数量桶或两个库位时写多行，共用 biz_type 与 biz_no。例如预占写 available 减少和 reserved 增加；上架写移出库位与移入库位各一行，桶仍是 available_qty。打包不改变数量桶。禁止 UPDATE 与 DELETE。

CREATE TABLE `wms_stock_log` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
  `stock_log_no` VARCHAR(64) NOT NULL COMMENT '流水号，租户内唯一',
  `idempotency_key` VARCHAR(128) 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 '批次号',
  `inventory_id` BIGINT UNSIGNED NOT NULL COMMENT '余额行内部主键，仅用于对账，业务关联以编码为准',
  `bucket` VARCHAR(32) NOT NULL COMMENT '变化的数量桶：available_qty、reserved_qty、picked_qty、hold_qty、damaged_qty、in_transit_qty',
  `biz_type` VARCHAR(32) NOT NULL COMMENT '业务类型：inbound_receipt、inbound_putaway、reserve、release、pick、ship、adjust、stocktake、freeze、unfreeze、return_restock、scrap、transfer',
  `biz_no` VARCHAR(64) NOT NULL COMMENT '业务单号',
  `qty_before` DECIMAL(16,4) NOT NULL COMMENT '变化前数量',
  `qty_change` DECIMAL(16,4) NOT NULL COMMENT '变化量，入库为正、出库为负',
  `qty_after` DECIMAL(16,4) NOT NULL COMMENT '变化后数量',
  `request_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '请求 ID',
  `occurred_at` DATETIME(3) NOT NULL COMMENT '业务发生时间',
  `created_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '操作人 user_code，系统任务为空',
  `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_tenant_stock_log_no` (`tenant_code`, `stock_log_no`),
  UNIQUE KEY `uk_tenant_idempotency` (`tenant_code`, `idempotency_key`),
  KEY `idx_tenant_sku_time` (`tenant_code`, `warehouse_code`, `sku_code`, `occurred_at`),
  KEY `idx_tenant_biz` (`tenant_code`, `biz_type`, `biz_no`),
  KEY `idx_inventory_id` (`inventory_id`),
  CONSTRAINT `chk_stock_log_balance` CHECK (`qty_after` = `qty_before` + `qty_change`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='库存流水';