init

docs/database/08-logistics/wms_tracking_event.sql

@@ -0,0 +1,21 @@
+-- 表：wms_tracking_event
+-- 用途：轨迹事件。运单轨迹，按时间追加。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：同步任务用承运商事件时间加事件码做幂等，重复拉取不插重复行。
+
+CREATE TABLE `wms_tracking_event` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `shipment_no` VARCHAR(64) NOT NULL COMMENT '发货单号',
+  `tracking_no` VARCHAR(64) NOT NULL COMMENT '运单号',
+  `event_time` DATETIME(3) NOT NULL COMMENT '承运商事件时间',
+  `event_code` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '承运商事件码',
+  `description` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '事件描述',
+  `event_location` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '事件地点',
+  `raw_payload` JSON 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`),
+  KEY `idx_tenant_tracking_time` (`tenant_code`, `tracking_no`, `event_time`),
+  KEY `idx_tenant_shipment` (`tenant_code`, `shipment_no`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='轨迹事件';