feat: complete tail order controls and terminal drayage

deploy/sql/头程数据库统一增量-MySQL8.sql

@@ -18019,6 +18019,65 @@ DELIMITER ;
 CALL assert_wallet_event_schema();
 DROP PROCEDURE IF EXISTS assert_wallet_event_schema;
 
+-- 目的港码头拖车、提柜与还空闭环（模块来源：phase3-terminal-drayage-schema.sql）
+USE baiyue_firstleg;
+CREATE TABLE IF NOT EXISTS fl_terminal_drayage (
+  id BIGINT UNSIGNED NOT NULL, container_booking_id BIGINT UNSIGNED NOT NULL,
+  fleet_supplier_id BIGINT UNSIGNED NOT NULL, fleet_supplier_name VARCHAR(128) NOT NULL,
+  pickup_appointment_at DATETIME(3) NULL, actual_pickup_at DATETIME(3) NULL,
+  estimated_empty_return_at DATETIME(3) NULL, actual_empty_return_at DATETIME(3) NULL,
+  version INT UNSIGNED NOT NULL DEFAULT 1, created_by BIGINT UNSIGNED NOT NULL,
+  created_by_name VARCHAR(64) NULL, created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  updated_by BIGINT UNSIGNED NOT NULL, updated_by_name VARCHAR(64) NULL,
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+  PRIMARY KEY(id), UNIQUE KEY uk_terminal_drayage_container(container_booking_id),
+  KEY idx_terminal_drayage_warning(actual_empty_return_at,estimated_empty_return_at),
+  CONSTRAINT fk_terminal_drayage_container FOREIGN KEY(container_booking_id) REFERENCES fl_container_booking(id),
+  CONSTRAINT chk_terminal_drayage_times CHECK((actual_pickup_at IS NULL OR pickup_appointment_at IS NOT NULL)
+    AND (actual_empty_return_at IS NULL OR actual_pickup_at IS NOT NULL)
+    AND (actual_empty_return_at IS NULL OR actual_empty_return_at >= actual_pickup_at))
+) ENGINE=InnoDB COMMENT='目的港货柜级码头拖车与还空事实';
+CREATE TABLE IF NOT EXISTS fl_terminal_drayage_history (
+  id BIGINT UNSIGNED NOT NULL, drayage_id BIGINT UNSIGNED NOT NULL,
+  container_booking_id BIGINT UNSIGNED NOT NULL, action VARCHAR(32) NOT NULL,
+  from_status VARCHAR(32) NOT NULL, to_status VARCHAR(32) NOT NULL,
+  from_version INT UNSIGNED NOT NULL, to_version INT UNSIGNED NOT NULL,
+  reason VARCHAR(500) NULL, operator_id BIGINT UNSIGNED NOT NULL, operator_name VARCHAR(64) NULL,
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), PRIMARY KEY(id),
+  KEY idx_terminal_drayage_history(container_booking_id,created_at,id),
+  CONSTRAINT fk_terminal_drayage_history FOREIGN KEY(drayage_id) REFERENCES fl_terminal_drayage(id),
+  CONSTRAINT chk_terminal_drayage_history_action CHECK(action IN
+    ('SELECT_FLEET','SCHEDULE_PICKUP','RECORD_PICKUP','RECORD_EMPTY_RETURN'))
+) ENGINE=InnoDB COMMENT='目的港码头拖车不可变操作历史';
+CREATE TABLE IF NOT EXISTS fl_terminal_drayage_operation (
+  id BIGINT UNSIGNED NOT NULL, container_booking_id BIGINT UNSIGNED NOT NULL,
+  operation VARCHAR(32) NOT NULL, idempotency_key VARCHAR(255) NOT NULL,
+  request_hash CHAR(64) NOT NULL, result_version INT UNSIGNED NOT NULL,
+  operator_id BIGINT UNSIGNED NOT NULL, created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  PRIMARY KEY(id), UNIQUE KEY uk_terminal_drayage_operation(container_booking_id,idempotency_key),
+  KEY idx_terminal_drayage_operation(container_booking_id,created_at),
+  CONSTRAINT fk_terminal_drayage_operation_container FOREIGN KEY(container_booking_id) REFERENCES fl_container_booking(id)
+) ENGINE=InnoDB COMMENT='目的港码头拖车成功幂等操作';
+
+DROP PROCEDURE IF EXISTS assert_terminal_drayage_schema;
+DELIMITER $$
+CREATE PROCEDURE assert_terminal_drayage_schema()
+BEGIN
+  IF (SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='baiyue_firstleg'
+      AND TABLE_NAME IN ('fl_terminal_drayage','fl_terminal_drayage_history','fl_terminal_drayage_operation')) <> 3 THEN
+    SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT='统一迁移失败：目的港码头拖车表不完整';
+  END IF;
+  IF (SELECT COUNT(*) FROM information_schema.STATISTICS WHERE TABLE_SCHEMA='baiyue_firstleg'
+      AND TABLE_NAME='fl_terminal_drayage' AND INDEX_NAME='uk_terminal_drayage_container' AND NON_UNIQUE=0) <> 1
+     OR (SELECT COUNT(*) FROM information_schema.STATISTICS WHERE TABLE_SCHEMA='baiyue_firstleg'
+      AND TABLE_NAME='fl_terminal_drayage_operation' AND INDEX_NAME='uk_terminal_drayage_operation' AND NON_UNIQUE=0) <> 2 THEN
+    SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT='统一迁移失败：目的港码头拖车唯一约束不完整';
+  END IF;
+END$$
+DELIMITER ;
+CALL assert_terminal_drayage_schema();
+DROP PROCEDURE IF EXISTS assert_terminal_drayage_schema;
+
 CALL baiyue_firstleg.assert_unified_final_schema();
 DROP PROCEDURE IF EXISTS baiyue_firstleg.assert_unified_final_schema;
 SELECT 'PASS' AS migration_status,