优化

firstleg/src/main/resources/db/phase3-outbound-dispatch-schema.sql

@@ -2,22 +2,22 @@
 USE baiyue_firstleg;
 
 CREATE TABLE IF NOT EXISTS fl_outbound_dispatch (
-  id BIGINT UNSIGNED NOT NULL,
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户隔离ID',
-  order_id BIGINT UNSIGNED NOT NULL COMMENT '订单引用，不复制订单主数据',
-  inbound_id BIGINT UNSIGNED NOT NULL COMMENT '入库单主对象',
-  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '柜次引用',
-  status VARCHAR(32) NOT NULL DEFAULT 'READY_FOR_DISPATCH',
-  version INT UNSIGNED NOT NULL DEFAULT 0,
-  confirmed_by BIGINT UNSIGNED NULL,
-  confirmed_by_name VARCHAR(64) NULL,
-  confirmed_at DATETIME(3) NULL,
-  reversed_by BIGINT UNSIGNED NULL,
-  reversed_by_name VARCHAR(64) NULL,
-  reversed_at DATETIME(3) NULL,
-  remark VARCHAR(500) 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),
+  id BIGINT UNSIGNED NOT NULL COMMENT '国内出仓调度记录ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT 'Order服务订单逻辑ID，不复制订单主数据',
+  inbound_id BIGINT UNSIGNED NOT NULL COMMENT '关联入库单逻辑ID',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '关联柜次逻辑ID',
+  status VARCHAR(32) NOT NULL DEFAULT 'READY_FOR_DISPATCH' COMMENT '出仓状态：READY_FOR_DISPATCH待确认出仓、WAITING_FOR_LOADING等待装柜',
+  version INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '乐观锁版本号，每次更新递增',
+  confirmed_by BIGINT UNSIGNED NULL COMMENT '确认国内出仓的操作人ID',
+  confirmed_by_name VARCHAR(64) NULL COMMENT '确认国内出仓的操作人姓名快照',
+  confirmed_at DATETIME(3) NULL COMMENT '国内出仓确认时间',
+  reversed_by BIGINT UNSIGNED NULL COMMENT '撤销国内出仓的操作人ID',
+  reversed_by_name VARCHAR(64) NULL COMMENT '撤销国内出仓的操作人姓名快照',
+  reversed_at DATETIME(3) NULL COMMENT '国内出仓撤销时间',
+  remark VARCHAR(500) NULL COMMENT '国内出仓调度备注',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '出仓调度记录创建时间',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '出仓调度记录最后更新时间',
   PRIMARY KEY (id),
   UNIQUE KEY uk_outbound_dispatch_owner (tenant_id,inbound_id,container_booking_id),
   KEY idx_outbound_dispatch_order (tenant_id,order_id,updated_at),
@@ -28,33 +28,33 @@ CREATE TABLE IF NOT EXISTS fl_outbound_dispatch (
 ) ENGINE=InnoDB COMMENT='三期国内出仓派车状态，不重复创建出仓单';
 
 CREATE TABLE IF NOT EXISTS fl_outbound_dispatch_history (
-  id BIGINT UNSIGNED NOT NULL,
-  dispatch_id BIGINT UNSIGNED NOT NULL,
-  tenant_id BIGINT UNSIGNED NOT NULL,
-  inbound_id BIGINT UNSIGNED NOT NULL,
-  container_booking_id BIGINT UNSIGNED NOT NULL,
-  action VARCHAR(32) NOT NULL,
-  from_status VARCHAR(32) NULL,
-  to_status VARCHAR(32) NOT NULL,
-  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),
+  id BIGINT UNSIGNED NOT NULL COMMENT '出仓状态历史记录ID',
+  dispatch_id BIGINT UNSIGNED NOT NULL COMMENT '关联国内出仓调度记录ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
+  inbound_id BIGINT UNSIGNED NOT NULL COMMENT '关联入库单逻辑ID快照',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '关联柜次逻辑ID快照',
+  action VARCHAR(32) NOT NULL COMMENT '出仓状态变更动作',
+  from_status VARCHAR(32) NULL COMMENT '变更前出仓状态；首次创建时为空',
+  to_status VARCHAR(32) NOT NULL COMMENT '变更后出仓状态',
+  remark 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_outbound_dispatch_history (tenant_id,inbound_id,container_booking_id,created_at,id),
   CONSTRAINT fk_outbound_dispatch_history FOREIGN KEY (dispatch_id) REFERENCES fl_outbound_dispatch(id)
 ) ENGINE=InnoDB COMMENT='国内出仓追加式审计历史';
 
 CREATE TABLE IF NOT EXISTS fl_outbound_dispatch_operation (
-  id BIGINT UNSIGNED NOT NULL,
+  id BIGINT UNSIGNED NOT NULL COMMENT '出仓幂等操作记录ID',
   dispatch_id BIGINT UNSIGNED NULL COMMENT '首次声明幂等键时允许为空',
-  operator_id BIGINT UNSIGNED NOT NULL,
-  operation VARCHAR(32) NOT NULL,
-  idempotency_key VARCHAR(128) NOT NULL,
-  request_hash CHAR(64) NOT NULL,
-  status VARCHAR(16) NOT NULL DEFAULT 'PROCESSING',
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-  completed_at DATETIME(3) NULL,
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '执行写操作的平台用户ID',
+  operation VARCHAR(32) NOT NULL COMMENT '国内出仓写操作类型',
+  idempotency_key VARCHAR(128) NOT NULL COMMENT '客户端幂等键，同一操作重试复用',
+  request_hash CHAR(64) NOT NULL COMMENT '规范化请求内容SHA-256摘要',
+  status VARCHAR(16) NOT NULL DEFAULT 'PROCESSING' COMMENT '幂等处理状态：PROCESSING处理中、SUCCESS成功',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '幂等声明创建时间',
+  completed_at DATETIME(3) NULL COMMENT '幂等操作完成时间',
   PRIMARY KEY (id),
   UNIQUE KEY uk_outbound_dispatch_operation (operator_id,operation,idempotency_key),
   KEY idx_outbound_dispatch_operation_resource (dispatch_id,created_at),