fix(firstleg): complete coload SQL comments

firstleg/src/main/resources/db/phase3-coload-group-schema.sql

@@ -3,7 +3,7 @@ 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',
+  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 '目的类型快照',
@@ -13,17 +13,17 @@ CREATE TABLE IF NOT EXISTS fl_coload_group (
   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,
+  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 '更新时间',
+  locked_by BIGINT UNSIGNED NULL COMMENT '锁定操作人ID',
+  locked_by_name VARCHAR(64) NULL COMMENT '锁定操作人名称快照',
+  locked_at DATETIME(3) NULL COMMENT '锁定时间',
+  consumed_by BIGINT UNSIGNED NULL COMMENT '消费操作人ID',
+  consumed_by_name VARCHAR(64) NULL COMMENT '消费操作人名称快照',
+  consumed_at DATETIME(3) NULL COMMENT '消费完成时间',
+  cancelled_by BIGINT UNSIGNED NULL COMMENT '取消操作人ID',
+  cancelled_by_name VARCHAR(64) NULL COMMENT '取消操作人名称快照',
+  cancelled_at DATETIME(3) NULL COMMENT '取消时间',
   PRIMARY KEY (id),
   UNIQUE KEY uk_coload_group_no (group_no),
   KEY idx_coload_group_status (group_status,updated_at,id),
@@ -45,8 +45,8 @@ CREATE TABLE IF NOT EXISTS fl_coload_group_member (
   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,
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '成员创建时间',
+  closed_at DATETIME(3) NULL COMMENT '成员约束关闭时间',
   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),
@@ -59,16 +59,16 @@ CREATE TABLE IF NOT EXISTS fl_coload_group_member (
 
 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,
+  group_id BIGINT UNSIGNED NOT NULL COMMENT '同柜不可拆组ID',
+  action_type VARCHAR(16) NOT NULL COMMENT '操作类型：CREATE、CANCEL、LOCK、UNLOCK、CONSUME',
+  from_status VARCHAR(16) NULL COMMENT '变更前组状态',
+  to_status VARCHAR(16) NOT NULL COMMENT '变更后组状态',
+  plan_id BIGINT UNSIGNED NULL COMMENT '关联装柜计划ID',
   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),
+  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),
   UNIQUE KEY uk_coload_history_operation (group_id,action_type,operation_id),
   KEY idx_coload_history_group (group_id,created_at,id),
@@ -80,13 +80,13 @@ CREATE TABLE IF NOT EXISTS fl_coload_group_history (
 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,
+  action_type VARCHAR(16) NOT NULL COMMENT '命令动作类型',
+  idempotency_key VARCHAR(128) NOT NULL COMMENT '幂等键',
+  request_hash CHAR(64) NOT NULL COMMENT '请求摘要',
+  command_status VARCHAR(16) NOT NULL COMMENT '命令状态：PROCESSING、SUCCESS',
+  result_group_id BIGINT UNSIGNED NULL COMMENT '命令结果组ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '命令创建时间',
+  completed_at DATETIME(3) NULL COMMENT '命令完成时间',
   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),