feat(firstleg): add indivisible coload groups

2026-08-29 10:51:50 +08:00
parent e6ee9cb442
commit ac6d3289a6
13 changed files with 1494 additions and 0 deletions
@@ -0,0 +1,94 @@
+USE baiyue_firstleg;
+
+CREATE TABLE IF NOT EXISTS fl_coload_group (
+  id BIGINT UNSIGNED NOT NULL COMMENT '同柜不可拆组ID',
+  group_no VARCHAR(40) NOT NULL COMMENT '稳定组号CLG-{id}',
+  group_status VARCHAR(16) NOT NULL COMMENT 'ACTIVE、LOCKED、CONSUMED、CANCELLED',
+  warehouse_id BIGINT UNSIGNED NOT NULL COMMENT '国内收货仓ID快照',
+  channel_code VARCHAR(64) NOT NULL COMMENT '物流渠道编码快照',
+  destination_type VARCHAR(32) NOT NULL COMMENT '目的类型快照',
+  destination_warehouse_id BIGINT UNSIGNED NULL COMMENT '目的仓ID快照',
+  destination_code VARCHAR(64) NULL COMMENT '目的仓或目的港编码快照',
+  locked_plan_id BIGINT UNSIGNED NULL COMMENT 'LOCKED/CONSUMED绑定装柜计划ID',
+  version INT UNSIGNED NOT NULL DEFAULT 0 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),
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+  locked_by BIGINT UNSIGNED NULL,
+  locked_by_name VARCHAR(64) NULL,
+  locked_at DATETIME(3) NULL,
+  consumed_by BIGINT UNSIGNED NULL,
+  consumed_by_name VARCHAR(64) NULL,
+  consumed_at DATETIME(3) NULL,
+  cancelled_by BIGINT UNSIGNED NULL,
+  cancelled_by_name VARCHAR(64) NULL,
+  cancelled_at DATETIME(3) NULL,
+  PRIMARY KEY (id),
+  UNIQUE KEY uk_coload_group_no (group_no),
+  KEY idx_coload_group_status (group_status,updated_at,id),
+  KEY idx_coload_group_plan (locked_plan_id,group_status),
+  CONSTRAINT fk_coload_group_plan FOREIGN KEY (locked_plan_id) REFERENCES fl_loading_plan(id),
+  CONSTRAINT chk_coload_group_status CHECK (group_status IN ('ACTIVE','LOCKED','CONSUMED','CANCELLED')),
+  CONSTRAINT chk_coload_group_destination CHECK (
+    destination_warehouse_id IS NOT NULL OR destination_code IS NOT NULL),
+  CONSTRAINT chk_coload_group_lock CHECK (
+    (group_status IN ('ACTIVE','CANCELLED') AND locked_plan_id IS NULL)
+    OR (group_status IN ('LOCKED','CONSUMED') AND locked_plan_id IS NOT NULL))
+) ENGINE=InnoDB COMMENT='同柜且不可拆业务组聚合根';
+
+CREATE TABLE IF NOT EXISTS fl_coload_group_member (
+  id BIGINT UNSIGNED NOT NULL COMMENT '组成员ID',
+  group_id BIGINT UNSIGNED NOT NULL COMMENT '同柜不可拆组ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '成员客户ID；允许跨客户成组',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT '订单ID',
+  inbound_id BIGINT UNSIGNED NOT NULL COMMENT '创建时权威入库单ID',
+  full_package_count INT UNSIGNED NOT NULL COMMENT '必须整组分配的满箱数快照',
+  active_flag TINYINT UNSIGNED NULL DEFAULT 1 COMMENT '当前约束唯一标识；取消或消费后置NULL',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  closed_at DATETIME(3) NULL,
+  PRIMARY KEY (id),
+  UNIQUE KEY uk_coload_group_member (group_id,inbound_id),
+  UNIQUE KEY uk_coload_active_inbound (tenant_id,inbound_id,active_flag),
+  KEY idx_coload_member_order (order_id,created_at,group_id),
+  CONSTRAINT fk_coload_member_group FOREIGN KEY (group_id) REFERENCES fl_coload_group(id),
+  CONSTRAINT fk_coload_member_inbound FOREIGN KEY (inbound_id) REFERENCES fl_inbound_order(id),
+  CONSTRAINT chk_coload_member_packages CHECK (full_package_count > 0),
+  CONSTRAINT chk_coload_member_active CHECK (active_flag IS NULL OR active_flag = 1)
+) ENGINE=InnoDB COMMENT='同柜不可拆组成员与满箱数快照';
+
+CREATE TABLE IF NOT EXISTS fl_coload_group_history (
+  id BIGINT UNSIGNED NOT NULL COMMENT '状态历史ID',
+  group_id BIGINT UNSIGNED NOT NULL,
+  action_type VARCHAR(16) NOT NULL COMMENT 'CREATE、CANCEL、LOCK、UNLOCK、CONSUME',
+  from_status VARCHAR(16) NULL,
+  to_status VARCHAR(16) NOT NULL,
+  plan_id BIGINT UNSIGNED NULL,
+  operation_id VARCHAR(128) NOT NULL COMMENT '稳定幂等操作ID',
+  remark 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),
+  UNIQUE KEY uk_coload_history_operation (group_id,action_type,operation_id),
+  KEY idx_coload_history_group (group_id,created_at,id),
+  CONSTRAINT fk_coload_history_group FOREIGN KEY (group_id) REFERENCES fl_coload_group(id),
+  CONSTRAINT chk_coload_history_action CHECK (
+    action_type IN ('CREATE','CANCEL','LOCK','UNLOCK','CONSUME'))
+) ENGINE=InnoDB COMMENT='同柜不可拆组不可变状态历史';
+
+CREATE TABLE IF NOT EXISTS fl_coload_command (
+  id BIGINT UNSIGNED NOT NULL COMMENT '幂等命令ID',
+  actor_id BIGINT UNSIGNED NOT NULL COMMENT '平台或内部操作人ID',
+  action_type VARCHAR(16) NOT NULL,
+  idempotency_key VARCHAR(128) NOT NULL,
+  request_hash CHAR(64) NOT NULL,
+  command_status VARCHAR(16) NOT NULL COMMENT 'PROCESSING、SUCCESS',
+  result_group_id BIGINT UNSIGNED NULL,
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  completed_at DATETIME(3) NULL,
+  PRIMARY KEY (id),
+  UNIQUE KEY uk_coload_command (actor_id,action_type,idempotency_key),
+  CONSTRAINT fk_coload_command_group FOREIGN KEY (result_group_id) REFERENCES fl_coload_group(id),
+  CONSTRAINT chk_coload_command_status CHECK (command_status IN ('PROCESSING','SUCCESS'))
+) ENGINE=InnoDB COMMENT='同柜不可拆组幂等写命令';