test(firstleg): align cabinet evidence SQL contracts

2026-08-31 18:31:39 +08:00
parent 60d45613c7
commit 838bd93bc4
4 changed files with 54 additions and 56 deletions
@@ -7636,29 +7636,29 @@ END$$
 DELIMITER ;

 CREATE TABLE IF NOT EXISTS fl_loading_cabinet_evidence (
-  id BIGINT UNSIGNED NOT NULL,
-  container_booking_id BIGINT UNSIGNED NOT NULL,
-  source_task_id BIGINT UNSIGNED NOT NULL,
-  evidence_type VARCHAR(32) NOT NULL,
-  file_id BIGINT UNSIGNED NOT NULL,
-  file_name VARCHAR(255) NOT NULL,
-  seal_no VARCHAR(64) NULL,
-  remark VARCHAR(1000) NULL,
-  status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE',
-  active_flag TINYINT UNSIGNED NULL DEFAULT 1,
-  operation_key VARCHAR(128) NOT NULL,
-  request_hash CHAR(64) NOT NULL,
-  void_reason VARCHAR(500) NULL,
-  voided_by BIGINT UNSIGNED NULL,
-  voided_by_name VARCHAR(128) NULL,
-  voided_at DATETIME(3) NULL,
-  version INT NOT NULL DEFAULT 0,
-  created_by BIGINT UNSIGNED NOT NULL,
-  created_by_name VARCHAR(128) NULL,
-  updated_by BIGINT UNSIGNED NOT NULL,
-  updated_by_name VARCHAR(128) 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',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '证据唯一归属柜次ID',
+  source_task_id BIGINT UNSIGNED NOT NULL COMMENT '上传来源PDA任务ID，仅用于审计',
+  evidence_type VARCHAR(32) NOT NULL COMMENT '四步照片或带锁码照类型',
+  file_id BIGINT UNSIGNED NOT NULL COMMENT 'File服务文件ID',
+  file_name VARCHAR(255) NOT NULL COMMENT '文件名称快照',
+  seal_no VARCHAR(64) NULL COMMENT '带锁码照对应锁码',
+  remark VARCHAR(1000) NULL COMMENT '证据备注',
+  status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE' COMMENT '证据状态：ACTIVE有效、VOID作废',
+  active_flag TINYINT UNSIGNED NULL DEFAULT 1 COMMENT '有效唯一标识；作废后置NULL',
+  operation_key VARCHAR(128) NOT NULL COMMENT '任务范围内幂等操作键',
+  request_hash CHAR(64) NOT NULL COMMENT '规范化请求SHA-256摘要',
+  void_reason VARCHAR(500) NULL COMMENT '作废原因',
+  voided_by BIGINT UNSIGNED NULL COMMENT '作废操作人ID',
+  voided_by_name VARCHAR(128) NULL COMMENT '作废操作人名称快照',
+  voided_at DATETIME(3) NULL COMMENT '作废时间',
+  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本',
+  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建操作人ID',
+  created_by_name VARCHAR(128) NULL COMMENT '创建操作人名称快照',
+  updated_by BIGINT UNSIGNED NOT NULL COMMENT '最后修改操作人ID',
+  updated_by_name VARCHAR(128) 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_cabinet_evidence_active (container_booking_id,evidence_type,active_flag),
  UNIQUE KEY uk_cabinet_evidence_operation (source_task_id,operation_key),