feat: complete tail order controls and terminal drayage

2026-09-07 23:58:18 +08:00
parent f018ca85a9
commit e32fe65fa8
53 changed files with 2566 additions and 87 deletions
@@ -0,0 +1,63 @@
+SET NAMES utf8mb4;
+USE baiyue_firstleg;
+
+CREATE TABLE IF NOT EXISTS fl_terminal_drayage (
+  id BIGINT UNSIGNED NOT NULL COMMENT '目的港码头拖车聚合ID',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '唯一归属物理货柜ID',
+  fleet_supplier_id BIGINT UNSIGNED NOT NULL COMMENT 'Warehouse ACTIVE/TRUCKING供应商ID快照',
+  fleet_supplier_name VARCHAR(128) NOT NULL COMMENT 'Warehouse供应商名称快照',
+  pickup_appointment_at DATETIME(3) NULL COMMENT '预约提柜时间',
+  actual_pickup_at DATETIME(3) NULL COMMENT '实际提柜时间',
+  estimated_empty_return_at DATETIME(3) NULL COMMENT '服务端按卸柜完成时间加72小时计算的预计还柜时间',
+  actual_empty_return_at DATETIME(3) NULL COMMENT '实际还空柜时间',
+  version INT UNSIGNED NOT NULL DEFAULT 1 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 '创建时间',
+  updated_by BIGINT UNSIGNED NOT NULL COMMENT '最后更新人ID',
+  updated_by_name VARCHAR(64) NULL COMMENT '最后更新人名称快照',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
+  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 COMMENT '历史ID',
+  drayage_id BIGINT UNSIGNED NOT NULL COMMENT '码头拖车聚合ID',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '货柜ID快照',
+  action VARCHAR(32) NOT NULL COMMENT 'SELECT_FLEET/SCHEDULE_PICKUP/RECORD_PICKUP/RECORD_EMPTY_RETURN',
+  from_status VARCHAR(32) NOT NULL COMMENT '操作前状态',
+  to_status VARCHAR(32) NOT NULL COMMENT '操作后状态',
+  from_version INT UNSIGNED NOT NULL COMMENT '操作前版本',
+  to_version INT UNSIGNED NOT NULL COMMENT '操作后版本',
+  reason VARCHAR(500) NULL COMMENT '操作说明',
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID',
+  operator_name VARCHAR(64) NULL COMMENT '操作人名称快照',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '操作时间',
+  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 COMMENT '幂等操作ID',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '货柜ID',
+  operation VARCHAR(32) NOT NULL COMMENT '业务动作',
+  idempotency_key VARCHAR(255) NOT NULL COMMENT '客户端幂等键',
+  request_hash CHAR(64) NOT NULL COMMENT '请求载荷SHA-256',
+  result_version INT UNSIGNED NOT NULL COMMENT '成功结果版本',
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '完成时间',
+  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='目的港码头拖车成功幂等操作';