-- 表：wms_inbound
-- 用途：入库单。入库作业的头单据。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：状态只能按 draft、receiving、received、qc、putting_away、completed 前进。免检时可从 received 进入 putting_away。cancelled 只允许在尚未上架时发生。入库引起的库存变化记在 wms_stock_log，不另建入库流水表。

CREATE TABLE `wms_inbound` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
  `inbound_no` VARCHAR(64) NOT NULL COMMENT '入库单号，租户内唯一',
  `warehouse_code` VARCHAR(32) NOT NULL COMMENT '仓库编码',
  `customer_code` VARCHAR(32) NOT NULL COMMENT '货主编码',
  `supplier_code` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '供应商编码，可空',
  `inbound_type` VARCHAR(32) NOT NULL COMMENT 'purchase 采购，return 退货，transfer 调拨，other 其他',
  `status` VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT 'draft 草稿，receiving 收货中，received 已收货，qc 质检中，putting_away 上架中，completed 已完成，cancelled 已取消',
  `ref_no` VARCHAR(64) NULL COMMENT '外部参考号，如 ASN；空必须为 NULL，以便唯一约束允许多张无参考号单据',
  `expected_arrive_at` DATETIME(3) NULL COMMENT '预计到货时间',
  `remark` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '备注',
  `created_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人 user_code，系统任务为空',
  `updated_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_inbound_no` (`tenant_code`, `inbound_no`),
  UNIQUE KEY `uk_tenant_ref_no` (`tenant_code`, `ref_no`),
  KEY `idx_tenant_wh_status_created` (`tenant_code`, `warehouse_code`, `status`, `created_at`),
  KEY `idx_tenant_customer` (`tenant_code`, `customer_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='入库单';