init

docs/database/08-logistics/wms_shipment.sql

@@ -0,0 +1,27 @@
+-- 表：wms_shipment
+-- 用途：发货单。包裹交给承运商的记录。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：状态变为 shipped 时扣减 picked_qty 并写 biz_type=ship 的流水，同时回写出库与订单的已发数量。获取面单、同步轨迹走队列，不在用户请求里等待承运商。
+
+CREATE TABLE `wms_shipment` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `shipment_no` VARCHAR(64) NOT NULL COMMENT '发货单号，租户内唯一',
+  `outbound_no` VARCHAR(64) NOT NULL COMMENT '出库单号',
+  `package_no` VARCHAR(64) NOT NULL COMMENT '包裹号',
+  `warehouse_code` VARCHAR(32) NOT NULL COMMENT '仓库编码',
+  `channel_code` VARCHAR(32) NOT NULL COMMENT '物流渠道编码',
+  `carrier_code` VARCHAR(32) NOT NULL COMMENT '承运商编码',
+  `tracking_no` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '运单号，取得面单前可空',
+  `status` VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT 'pending 待获取面单，labeled 已有面单，shipped 已交出，exception 异常，delivered 已妥投，cancelled 已取消',
+  `shipped_at` DATETIME(3) 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_shipment_no` (`tenant_code`, `shipment_no`),
+  UNIQUE KEY `uk_tenant_package` (`tenant_code`, `package_no`),
+  KEY `idx_tenant_outbound` (`tenant_code`, `outbound_no`),
+  KEY `idx_tenant_tracking` (`tenant_code`, `tracking_no`),
+  KEY `idx_tenant_status` (`tenant_code`, `status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='发货单';