127 lines
8.7 KiB
SQL
127 lines
8.7 KiB
SQL
SET NAMES utf8mb4;
|
||
USE baiyue_firstleg;
|
||
|
||
/*
|
||
* 船期日历的事实契约。
|
||
*
|
||
* 这些表不修改入库单或海运订舱聚合：入库单仍是履约主数据，订舱仍是
|
||
* RELEASED/DRAFT 聚合。船期日历只消费这里的稳定事实和审计版本。
|
||
*/
|
||
|
||
CREATE TABLE fl_sailing_receipt_batch_fact (
|
||
id BIGINT UNSIGNED NOT NULL COMMENT '稳定收货批次事实ID（receiptBatchId）',
|
||
tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离键，继承入库事实',
|
||
receipt_batch_key VARCHAR(64) NOT NULL COMMENT '同一物理收货批次的不可变业务键',
|
||
fact_version INT UNSIGNED NOT NULL DEFAULT 1 COMMENT '同一批次复测/冲正版本',
|
||
inbound_id BIGINT UNSIGNED NOT NULL COMMENT '入库单ID',
|
||
measurement_id BIGINT UNSIGNED NULL COMMENT '最终审核测量批次ID',
|
||
receiving_warehouse_id BIGINT UNSIGNED NOT NULL COMMENT '实际收货仓ID',
|
||
channel_code VARCHAR(64) NULL COMMENT '收货渠道编码快照',
|
||
channel_name VARCHAR(128) NULL COMMENT '收货渠道名称快照',
|
||
departure_port_code VARCHAR(32) NULL COMMENT '起运港编码快照',
|
||
destination_port_code VARCHAR(32) NULL COMMENT '目的港编码快照',
|
||
received_at DATETIME(3) NOT NULL COMMENT '实际收货完成时间，不使用入库单inbounded_at替代',
|
||
actual_volume_cbm DECIMAL(18,4) NOT NULL COMMENT '最终审核实测体积m3',
|
||
fact_status VARCHAR(24) NOT NULL DEFAULT 'APPROVED' COMMENT '事实状态：APPROVED/REVERSED/VOIDED/SUPERSEDED',
|
||
reversal_of_fact_id BIGINT UNSIGNED NULL COMMENT '冲正所替代的事实ID',
|
||
source_type VARCHAR(32) NOT NULL DEFAULT 'FIRSTLEG_RECEIPT' COMMENT '事实来源',
|
||
created_by BIGINT UNSIGNED NULL COMMENT '写入人或系统主体',
|
||
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),
|
||
PRIMARY KEY (id),
|
||
UNIQUE KEY uk_sailing_receipt_batch_version (tenant_id, receipt_batch_key, fact_version),
|
||
KEY idx_sailing_receipt_batch_current (tenant_id, receipt_batch_key, fact_status, fact_version),
|
||
KEY idx_sailing_receipt_match (tenant_id, receiving_warehouse_id, channel_code, received_at, id),
|
||
KEY idx_sailing_receipt_inbound (tenant_id, inbound_id, received_at, id),
|
||
CONSTRAINT chk_sailing_receipt_volume CHECK (actual_volume_cbm > 0),
|
||
CONSTRAINT chk_sailing_receipt_status CHECK (fact_status IN ('APPROVED','REVERSED','VOIDED','SUPERSEDED'))
|
||
) ENGINE=InnoDB COMMENT='船期日历稳定收货批次实测事实及版本历史';
|
||
|
||
CREATE TABLE fl_sailing_inbound_volume_forecast (
|
||
id BIGINT UNSIGNED NOT NULL COMMENT '货量预报事实ID（forecastId）',
|
||
tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离键，继承入库事实',
|
||
forecast_key VARCHAR(64) NOT NULL COMMENT '同一未收货对象的不可变业务键',
|
||
fact_version INT UNSIGNED NOT NULL DEFAULT 1 COMMENT '预报修订版本',
|
||
inbound_id BIGINT UNSIGNED NOT NULL COMMENT '入库单ID',
|
||
receiving_warehouse_id BIGINT UNSIGNED NOT NULL COMMENT '预计收货仓ID',
|
||
channel_code VARCHAR(64) NULL COMMENT '预计渠道编码快照',
|
||
channel_name VARCHAR(128) NULL COMMENT '预计渠道名称快照',
|
||
departure_port_code VARCHAR(32) NULL COMMENT '预计起运港编码快照',
|
||
destination_port_code VARCHAR(32) NULL COMMENT '预计目的港编码快照',
|
||
expected_arrival_at DATETIME(3) NOT NULL COMMENT '预计到仓时间',
|
||
forecast_volume_cbm DECIMAL(18,4) NOT NULL COMMENT '未收货预计体积m3，不得使用申报体积代替',
|
||
source_type VARCHAR(32) NOT NULL COMMENT '预报来源，例如OPERATIONS/UPSTREAM_MEASUREMENT；不得使用客户申报体积冒充预报',
|
||
fact_status VARCHAR(24) NOT NULL DEFAULT 'VALID' COMMENT '事实状态：VALID/SUPERSEDED/VOIDED/CONSUMED',
|
||
effective_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '本版本生效时间',
|
||
created_by BIGINT UNSIGNED NULL COMMENT '写入人或系统主体',
|
||
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),
|
||
PRIMARY KEY (id),
|
||
UNIQUE KEY uk_sailing_forecast_version (tenant_id, forecast_key, fact_version),
|
||
KEY idx_sailing_forecast_current (tenant_id, forecast_key, fact_status, fact_version),
|
||
KEY idx_sailing_forecast_match (tenant_id, receiving_warehouse_id, channel_code, expected_arrival_at, id),
|
||
KEY idx_sailing_forecast_inbound (tenant_id, inbound_id, expected_arrival_at, id),
|
||
CONSTRAINT chk_sailing_forecast_volume CHECK (forecast_volume_cbm > 0),
|
||
CONSTRAINT chk_sailing_forecast_status CHECK (fact_status IN ('VALID','SUPERSEDED','VOIDED','CONSUMED'))
|
||
) ENGINE=InnoDB COMMENT='船期日历未收货量预报事实及版本历史';
|
||
|
||
CREATE TABLE fl_sailing_assignment (
|
||
id BIGINT UNSIGNED NOT NULL COMMENT '归班事实ID',
|
||
tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离键',
|
||
sailing_id BIGINT UNSIGNED NULL COMMENT '船期实例ID，UNMATCHED为空',
|
||
origin_sailing_id BIGINT UNSIGNED NULL COMMENT '异常重排/取消前的原船期实例ID',
|
||
inbound_id BIGINT UNSIGNED NULL COMMENT '归班对象入库单ID',
|
||
inbound_code VARCHAR(64) NULL COMMENT '入仓码快照，仅用于展示',
|
||
receipt_batch_id BIGINT UNSIGNED NULL COMMENT '收货批次事实ID',
|
||
forecast_id BIGINT UNSIGNED NULL COMMENT '货量预报事实ID',
|
||
assignment_source VARCHAR(24) NOT NULL DEFAULT 'AUTO' COMMENT '归班来源：AUTO/MANUAL/ROLLOVER',
|
||
assignment_version INT UNSIGNED NOT NULL COMMENT '同一对象的归班版本',
|
||
match_status VARCHAR(24) NOT NULL COMMENT 'FORECAST_MATCHED/RECEIVED/LATE/UNMATCHED/SUPERSEDED',
|
||
volume_cbm DECIMAL(18,4) NULL COMMENT '已收实测体积',
|
||
forecast_volume_cbm DECIMAL(18,4) NULL COMMENT '未收有效预计体积',
|
||
route_source VARCHAR(32) NULL COMMENT '航线来源：INBOUND_FACT/FORECAST_FACT/CHANNEL_DEFAULT',
|
||
volume_source VARCHAR(32) NULL COMMENT 'MEASURED_ACTUAL或预报来源',
|
||
rule_version VARCHAR(64) NOT NULL COMMENT '自动归班规则版本',
|
||
matched_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
|
||
superseded_at DATETIME(3) NULL,
|
||
locked_at DATETIME(3) NULL COMMENT '截止/订舱/关闭后冻结时间',
|
||
lock_reason VARCHAR(32) NULL COMMENT 'CUTOFF/BOOKING_CONFIRMED/CLOSED',
|
||
operator_id BIGINT UNSIGNED NULL,
|
||
reason VARCHAR(500) NULL,
|
||
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
|
||
PRIMARY KEY (id),
|
||
KEY idx_sailing_assignment_current (tenant_id, sailing_id, match_status, matched_at, id),
|
||
KEY idx_sailing_assignment_origin (tenant_id, origin_sailing_id, match_status, id),
|
||
KEY idx_sailing_assignment_receipt (tenant_id, receipt_batch_id, assignment_version, id),
|
||
KEY idx_sailing_assignment_forecast (tenant_id, forecast_id, assignment_version, id),
|
||
KEY idx_sailing_assignment_inbound (tenant_id, inbound_id, match_status, id),
|
||
CONSTRAINT chk_sailing_assignment_status CHECK (match_status IN ('FORECAST_MATCHED','RECEIVED','LATE','UNMATCHED','SUPERSEDED')),
|
||
CONSTRAINT chk_sailing_assignment_source CHECK (assignment_source IN ('AUTO','MANUAL','ROLLOVER'))
|
||
) ENGINE=InnoDB COMMENT='船期日历自动归班事实及不可变版本历史';
|
||
|
||
CREATE TABLE fl_sailing_booking_link (
|
||
id BIGINT UNSIGNED NOT NULL COMMENT '船期-订舱关联ID',
|
||
tenant_id BIGINT UNSIGNED NOT NULL COMMENT '平台关联隔离键',
|
||
sailing_id BIGINT UNSIGNED NOT NULL COMMENT '计划船期实例ID',
|
||
ocean_booking_id BIGINT UNSIGNED NOT NULL COMMENT '海运订舱ID',
|
||
link_status VARCHAR(24) NOT NULL DEFAULT 'ACTIVE' COMMENT '关联状态：ACTIVE/REVOKED',
|
||
active_booking_guard TINYINT NULL COMMENT 'ACTIVE为1，REVOKED为空，用于唯一约束',
|
||
booking_status_snapshot VARCHAR(24) NOT NULL COMMENT '关联时订舱状态快照；只有RELEASED可建立',
|
||
warehouse_id BIGINT UNSIGNED NULL COMMENT '关联仓库快照',
|
||
channel_code VARCHAR(64) NULL COMMENT '关联渠道快照',
|
||
departure_port_code VARCHAR(32) NULL COMMENT '关联起运港快照',
|
||
destination_port_code VARCHAR(32) NULL COMMENT '关联目的港快照',
|
||
linked_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
|
||
revoked_at DATETIME(3) NULL,
|
||
operator_id BIGINT UNSIGNED NULL,
|
||
operator_name VARCHAR(64) NULL,
|
||
reason VARCHAR(500) NULL,
|
||
PRIMARY KEY (id),
|
||
UNIQUE KEY uk_sailing_booking_active (ocean_booking_id, active_booking_guard),
|
||
KEY idx_sailing_booking_link (sailing_id, link_status, ocean_booking_id),
|
||
KEY idx_sailing_booking_booking (ocean_booking_id, link_status, id),
|
||
CONSTRAINT chk_sailing_booking_link_status CHECK (link_status IN ('ACTIVE','REVOKED')),
|
||
CONSTRAINT chk_sailing_booking_link_guard CHECK ((link_status='ACTIVE' AND active_booking_guard=1) OR (link_status='REVOKED' AND active_booking_guard IS NULL)),
|
||
CONSTRAINT chk_sailing_booking_released CHECK (booking_status_snapshot='RELEASED')
|
||
) ENGINE=InnoDB COMMENT='船期计划与已放舱订舱的最小关联及历史';
|