Merge remote-tracking branch 'origin/test' into dev

# Conflicts:
#	deploy/sql/头程数据库统一增量-MySQL8.sql
#	event-bridge-service/src/main/java/com/baiyue/eventbridge/metrics/EventBridgeMetrics.java
#	firstleg/src/main/resources/db/phase3-container-customs-schema.sql
#	order/src/main/resources/db/order.sql
#	scripts/db/incremental.sql

firstleg/src/main/resources/db/phase3-smart-loading-schema.sql

@@ -344,11 +344,11 @@ CREATE TABLE IF NOT EXISTS fl_container_document (
 ) ENGINE=InnoDB COMMENT='平台货柜清关、DO与PU文件关联';
 
 CREATE TABLE IF NOT EXISTS fl_container_exception_history (
-  id BIGINT UNSIGNED NOT NULL, container_booking_id BIGINT UNSIGNED NOT NULL,
-  action VARCHAR(16) NOT NULL, reason VARCHAR(500) NOT NULL,
-  operator_id BIGINT UNSIGNED NOT NULL, operator_name VARCHAR(64) NULL,
-  operation_id VARCHAR(128) NOT NULL, request_hash CHAR(64) NOT NULL,
-  occurred_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), PRIMARY KEY(id),
+  id BIGINT UNSIGNED NOT NULL COMMENT '货柜异常历史ID', container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '物理货柜ID',
+  action VARCHAR(16) NOT NULL COMMENT '操作类型：MARK标记异常、CANCEL取消异常', reason VARCHAR(500) NOT NULL COMMENT '异常原因',
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID', operator_name VARCHAR(64) NULL COMMENT '操作人名称快照',
+  operation_id VARCHAR(128) NOT NULL COMMENT '同一操作人幂等键', request_hash CHAR(64) NOT NULL COMMENT '请求摘要',
+  occurred_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '操作发生时间', PRIMARY KEY(id),
   UNIQUE KEY uk_container_exception_operation(container_booking_id,operator_id,operation_id),
   KEY idx_container_exception_history(container_booking_id,occurred_at,id),
   CONSTRAINT fk_container_exception_booking FOREIGN KEY(container_booking_id) REFERENCES fl_container_booking(id),
@@ -587,7 +587,7 @@ CREATE TABLE IF NOT EXISTS fl_loading_completion_command (
   pick_task_id BIGINT UNSIGNED NOT NULL COMMENT 'PDA任务ID',
   operation_id VARCHAR(128) NOT NULL COMMENT '客户端全局幂等操作ID',
   request_hash CHAR(64) NOT NULL COMMENT '规范化请求摘要',
-  command_status VARCHAR(16) NOT NULL COMMENT 'PROCESSING、RETRYABLE、FAILED、COMPLETED',
+  command_status VARCHAR(16) NOT NULL COMMENT '命令状态：PROCESSING处理中、RETRYABLE可重试、FAILED失败、COMPLETED已完成',
   expected_task_version INT UNSIGNED NOT NULL COMMENT '受理时客户端任务版本',
   remark VARCHAR(500) NULL COMMENT '完成备注',
   operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID',
@@ -600,9 +600,9 @@ CREATE TABLE IF NOT EXISTS fl_loading_completion_command (
   failure_code VARCHAR(32) NULL COMMENT '下游或业务错误码',
   failure_request_id VARCHAR(64) NULL COMMENT '下游请求ID',
   failure_trace_id VARCHAR(64) NULL COMMENT '下游链路ID',
-  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),
-  completed_at DATETIME(3) NULL,
+  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 '命令更新时间',
+  completed_at DATETIME(3) NULL COMMENT '命令完成时间',
   PRIMARY KEY (id),
   UNIQUE KEY uk_loading_completion_operation (operation_id),
   KEY idx_loading_completion_dispatch (command_status,next_retry_at,lease_until),
@@ -611,13 +611,13 @@ CREATE TABLE IF NOT EXISTS fl_loading_completion_command (
 ) ENGINE=InnoDB COMMENT='PDA装柜完成可靠异步命令';
 
 CREATE TABLE IF NOT EXISTS fl_loading_completion_checkpoint (
-  command_id BIGINT UNSIGNED NOT NULL,
-  tenant_id BIGINT UNSIGNED NOT NULL,
-  inbound_id BIGINT UNSIGNED NOT NULL,
-  owner_sequence INT UNSIGNED NOT NULL,
-  checkpoint_stage VARCHAR(24) NOT NULL COMMENT 'READY、SETTLED、INBOUND_COMPLETED',
-  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),
+  command_id BIGINT UNSIGNED NOT NULL COMMENT '可靠装柜完成命令ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '入仓单客户ID',
+  inbound_id BIGINT UNSIGNED NOT NULL COMMENT '入仓单ID',
+  owner_sequence INT UNSIGNED NOT NULL COMMENT '稳定处理顺序',
+  checkpoint_stage VARCHAR(24) NOT NULL COMMENT '处理阶段：READY待处理、SETTLED资源已结算、INBOUND_COMPLETED入仓已完成',
+  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 (command_id,tenant_id,inbound_id),
   KEY idx_loading_completion_owner (command_id,owner_sequence),
   CONSTRAINT fk_loading_completion_checkpoint_command FOREIGN KEY (command_id)