-- 表：wms_location
-- 用途：库位。仓库内可存放库存的最小位置，同时保存容量。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：空置还是占用由库存余额推导，不在本表存占用状态。容量字段即库位容量，不另建容量表。

CREATE TABLE `wms_location` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
  `warehouse_code` VARCHAR(32) NOT NULL COMMENT '仓库编码',
  `zone_code` VARCHAR(32) NOT NULL COMMENT '库区编码',
  `location_code` VARCHAR(64) NOT NULL COMMENT '库位编码，仓库内唯一',
  `location_type_code` VARCHAR(32) NOT NULL COMMENT '库位类型编码',
  `aisle` VARCHAR(16) NOT NULL DEFAULT '' COMMENT '巷道',
  `rack` VARCHAR(16) NOT NULL DEFAULT '' COMMENT '货架',
  `level_no` VARCHAR(16) NOT NULL DEFAULT '' COMMENT '层',
  `bin_no` VARCHAR(16) NOT NULL DEFAULT '' COMMENT '位',
  `pick_sequence` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '拣货路径序号，小的优先',
  `status` VARCHAR(32) NOT NULL DEFAULT 'enabled' COMMENT 'enabled 可作业，disabled 停用，locked 锁定（盘点或异常，暂停入出）',
  `max_qty` DECIMAL(16,4) NULL COMMENT '容量：最大件数，空表示不限制',
  `max_weight` DECIMAL(12,4) NULL COMMENT '容量：最大重量千克，空表示不限制',
  `max_volume` DECIMAL(16,4) NULL COMMENT '容量：最大体积立方厘米，空表示不限制',
  `length_cm` DECIMAL(12,4) NULL COMMENT '长，厘米，空表示未维护',
  `width_cm` DECIMAL(12,4) NULL COMMENT '宽，厘米，空表示未维护',
  `height_cm` DECIMAL(12,4) NULL COMMENT '高，厘米，空表示未维护',
  `remark` VARCHAR(500) NOT NULL DEFAULT '' 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_tenant_wh_location` (`tenant_code`, `warehouse_code`, `location_code`),
  KEY `idx_tenant_wh_zone` (`tenant_code`, `warehouse_code`, `zone_code`),
  KEY `idx_tenant_wh_status` (`tenant_code`, `warehouse_code`, `status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='库位';