优化

firstleg/src/main/resources/db/phase3-smart-loading-schema.sql

@@ -72,6 +72,11 @@ CREATE TABLE IF NOT EXISTS fl_container_booking (
   actual_port_arrival_at DATETIME(3) NULL COMMENT '实际到港时间',
   estimated_warehouse_arrival_at DATETIME(3) NULL COMMENT '预计到仓时间',
   actual_warehouse_arrival_at DATETIME(3) NULL COMMENT '实际到仓时间',
+  unloading_completed_at DATETIME(3) NULL COMMENT '海外仓卸柜完成时间（UTC）',
+  unloading_photo_uploaded_at DATETIME(3) NULL COMMENT '海外仓卸柜照片上传成功时间（UTC）',
+  estimated_empty_reported_at DATETIME(3) NULL COMMENT '预计报空时间（卸柜照片上传成功时间加两天，UTC）',
+  actual_empty_reported_at DATETIME(3) NULL COMMENT '实际报空时间（UTC）',
+  empty_report_source_version BIGINT UNSIGNED NULL COMMENT '海外货柜事件聚合版本，用于阻止乱序覆盖',
   created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
   created_by_name VARCHAR(64) NULL COMMENT '创建人名称快照',
   created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
@@ -93,6 +98,21 @@ CREATE TABLE IF NOT EXISTS fl_container_booking (
   CONSTRAINT chk_container_booking_weight CHECK (max_weight_kg IS NULL OR max_weight_kg > 0)
 ) ENGINE=InnoDB COMMENT='平台货柜预订资料；预装状态唯一来源为装柜计划';
 
+CREATE TABLE IF NOT EXISTS fl_container_event_inbox (
+  event_id VARCHAR(64) NOT NULL COMMENT '跨区事件全局唯一ID',
+  event_type VARCHAR(64) NOT NULL COMMENT '事件类型',
+  event_version INT UNSIGNED NOT NULL COMMENT '事件契约版本',
+  aggregate_id VARCHAR(64) NOT NULL COMMENT '货柜聚合ID',
+  aggregate_version BIGINT UNSIGNED NOT NULL COMMENT '货柜聚合版本',
+  payload_hash VARCHAR(80) NOT NULL COMMENT '规范化负载SHA-256摘要',
+  payload_json JSON NOT NULL COMMENT '原始事件负载',
+  status VARCHAR(16) NOT NULL COMMENT 'RECEIVED或PROCESSED',
+  received_at DATETIME(3) NOT NULL COMMENT '接收时间（UTC）',
+  processed_at DATETIME(3) NULL COMMENT '处理完成时间（UTC）',
+  PRIMARY KEY (event_id),
+  KEY idx_container_event_aggregate (aggregate_id, aggregate_version)
+) ENGINE=InnoDB COMMENT='海外货柜事件消费Inbox';
+
 DROP PROCEDURE IF EXISTS phase3_container_real_unit_columns;
 DELIMITER $$
 CREATE PROCEDURE phase3_container_real_unit_columns()
@@ -112,6 +132,31 @@ BEGIN
     ALTER TABLE fl_container_booking ADD COLUMN merged_into_container_booking_id BIGINT UNSIGNED NULL
       COMMENT '真实柜被模拟柜吸收后的目标稳定柜次ID' AFTER record_status;
   END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
+      AND table_name='fl_container_booking' AND column_name='unloading_completed_at') THEN
+    ALTER TABLE fl_container_booking ADD COLUMN unloading_completed_at DATETIME(3) NULL
+      COMMENT '海外仓卸柜完成时间（UTC）' AFTER actual_warehouse_arrival_at;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
+      AND table_name='fl_container_booking' AND column_name='unloading_photo_uploaded_at') THEN
+    ALTER TABLE fl_container_booking ADD COLUMN unloading_photo_uploaded_at DATETIME(3) NULL
+      COMMENT '海外仓卸柜照片上传成功时间（UTC）' AFTER unloading_completed_at;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
+      AND table_name='fl_container_booking' AND column_name='estimated_empty_reported_at') THEN
+    ALTER TABLE fl_container_booking ADD COLUMN estimated_empty_reported_at DATETIME(3) NULL
+      COMMENT '预计报空时间（卸柜照片上传成功时间加两天，UTC）' AFTER unloading_photo_uploaded_at;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
+      AND table_name='fl_container_booking' AND column_name='actual_empty_reported_at') THEN
+    ALTER TABLE fl_container_booking ADD COLUMN actual_empty_reported_at DATETIME(3) NULL
+      COMMENT '实际报空时间（UTC）' AFTER estimated_empty_reported_at;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
+      AND table_name='fl_container_booking' AND column_name='empty_report_source_version') THEN
+    ALTER TABLE fl_container_booking ADD COLUMN empty_report_source_version BIGINT UNSIGNED NULL
+      COMMENT '海外货柜事件聚合版本，用于阻止乱序覆盖' AFTER actual_empty_reported_at;
+  END IF;
   IF NOT EXISTS (SELECT 1 FROM information_schema.statistics WHERE table_schema=DATABASE()
       AND table_name='fl_container_booking' AND index_name='uk_container_booking_container_no') THEN
     ALTER TABLE fl_container_booking ADD UNIQUE KEY uk_container_booking_container_no (container_no);