baiyue-firstleg/firstleg/src/main/resources/db/phase3-terminal-drayage-schema.sql

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 NULL COMMENT 'Warehouse ACTIVE/TRUCKING供应商ID快照',
  fleet_supplier_name VARCHAR(128) 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 NULL OR actual_empty_return_at >= actual_pickup_at))
) ENGINE=InnoDB COMMENT='目的港货柜级码头拖车与还空事实';

CREATE TABLE IF NOT EXISTS fl_terminal_drayage_mail (
  id BIGINT UNSIGNED NOT NULL,
  container_booking_id BIGINT UNSIGNED NOT NULL,
  fleet_supplier_id BIGINT UNSIGNED NOT NULL,
  fleet_name VARCHAR(128) NOT NULL,
  recipient VARCHAR(254) NOT NULL,
  kind VARCHAR(32) NOT NULL,
  subject VARCHAR(255) NOT NULL,
  body TEXT NOT NULL,
  status VARCHAR(16) NOT NULL DEFAULT 'PENDING',
  attempts INT NOT NULL DEFAULT 0,
  failure_reason VARCHAR(500) NULL,
  created_by BIGINT UNSIGNED NOT NULL,
  updated_by BIGINT UNSIGNED NOT NULL,
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
  sent_at DATETIME(3) NULL,
  PRIMARY KEY(id),
  KEY idx_terminal_mail_dispatch(status,id),
  KEY idx_terminal_mail_container(container_booking_id,id,status),
  CONSTRAINT fk_terminal_mail_container FOREIGN KEY(container_booking_id) REFERENCES fl_container_booking(id),
  CONSTRAINT chk_terminal_mail_kind CHECK(kind IN ('REQUEST_PICKUP','CANCEL_PICKUP')),
  CONSTRAINT chk_terminal_mail_status CHECK(status IN ('PENDING','SENDING','SENT','FAILED'))
) 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='目的港码头拖车成功幂等操作';