init

docs/database/06-outbound/wms_order_item.sql

@@ -0,0 +1,23 @@
+-- 表：wms_order_item
+-- 用途：订单明细。订单要履约的 SKU 与数量。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：已发货数量由出库发货回写。不在订单行上直接扣库存。
+
+CREATE TABLE `wms_order_item` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `order_no` VARCHAR(64) NOT NULL COMMENT '订单号',
+  `line_no` INT UNSIGNED NOT NULL COMMENT '行号',
+  `sku_code` VARCHAR(64) NOT NULL COMMENT 'SKU 编码',
+  `sku_name` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '下单时的 SKU 名称快照',
+  `ordered_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '订购数量',
+  `cancelled_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '取消数量',
+  `shipped_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '已发货数量',
+  `declared_value` DECIMAL(16,4) NULL 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_order_line` (`tenant_code`, `order_no`, `line_no`),
+  KEY `idx_tenant_sku` (`tenant_code`, `sku_code`),
+  CONSTRAINT `chk_order_item_qty` CHECK (`ordered_qty` > 0 AND `cancelled_qty` >= 0 AND `shipped_qty` >= 0 AND `cancelled_qty` + `shipped_qty` <= `ordered_qty`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='订单明细';