-- 表：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='轨迹事件';