优化

file/src/main/resources/db/file.sql

@@ -5,7 +5,7 @@ USE baiyue_file;
 
 CREATE TABLE IF NOT EXISTS file_object (
   id BIGINT UNSIGNED NOT NULL COMMENT '文件ID（雪花ID）',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
   business_type VARCHAR(32) NULL COMMENT '关联业务类型',
   business_id VARCHAR(64) NULL COMMENT '关联业务逻辑ID',
   original_name VARCHAR(255) NOT NULL COMMENT '原始文件名',
@@ -30,7 +30,7 @@ CREATE TABLE IF NOT EXISTS file_object (
 
 CREATE TABLE IF NOT EXISTS file_download_token (
   id BIGINT UNSIGNED NOT NULL COMMENT '下载令牌ID',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
   file_id BIGINT UNSIGNED NOT NULL COMMENT '文件逻辑ID',
   token_hash CHAR(64) NOT NULL COMMENT '下载令牌SHA-256摘要',
   expires_at DATETIME(3) NOT NULL COMMENT '过期时间',
@@ -47,7 +47,7 @@ CREATE TABLE IF NOT EXISTS file_download_token (
 
 CREATE TABLE IF NOT EXISTS file_download_log (
   id BIGINT UNSIGNED NOT NULL COMMENT '下载日志ID',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键',
   file_id BIGINT UNSIGNED NOT NULL COMMENT '文件逻辑ID',
   user_id BIGINT UNSIGNED NULL COMMENT '下载用户ID',
   request_id VARCHAR(64) NULL COMMENT '请求ID',
@@ -62,14 +62,14 @@ CREATE TABLE IF NOT EXISTS file_download_log (
 
 CREATE TABLE IF NOT EXISTS file_export_task (
   id BIGINT UNSIGNED NOT NULL COMMENT '导出任务ID（雪花ID）',
-  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '申请人所属租户ID，平台任务为0',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键；平台任务固定为0',
   app_code VARCHAR(24) NOT NULL COMMENT '申请端：PLATFORM或MERCHANT',
   task_no VARCHAR(40) NOT NULL COMMENT '导出任务编号',
   export_type VARCHAR(64) NOT NULL COMMENT '导出类型',
   format VARCHAR(16) NOT NULL DEFAULT 'XLSX' COMMENT '导出格式',
   task_name VARCHAR(128) NOT NULL COMMENT '任务名称',
   parameters_json JSON NOT NULL COMMENT '筛选条件快照',
-  status VARCHAR(24) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING/RUNNING/SUCCEEDED/FAILED/EXPIRED',
+  status VARCHAR(24) NOT NULL DEFAULT 'PENDING' COMMENT '状态：PENDING待处理、RUNNING执行中、SUCCEEDED成功、FAILED失败、EXPIRED已过期',
   total_rows BIGINT UNSIGNED NULL COMMENT '预计总行数',
   processed_rows BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '已处理行数',
   file_name VARCHAR(255) NULL COMMENT '下载文件名',
@@ -108,7 +108,7 @@ CREATE TABLE IF NOT EXISTS file_export_task (
 
 CREATE TABLE IF NOT EXISTS file_export_task_guard (
   guard_key VARCHAR(64) NOT NULL COMMENT '任务创建串行化锁键',
-  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '锁记录最后更新时间',
   PRIMARY KEY (guard_key)
 ) ENGINE=InnoDB COMMENT='导出任务创建并发保护表：低频创建入口使用单行锁保证重复提交及活动上限';
 
@@ -123,15 +123,15 @@ CREATE TABLE IF NOT EXISTS file_export_outbox (
   tag VARCHAR(64) NOT NULL COMMENT '消息Tag',
   message_key VARCHAR(64) NOT NULL COMMENT '消息Key',
   payload_json JSON NOT NULL COMMENT '命令消息体',
-  status VARCHAR(24) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING/CLAIMED/SENT/QUARANTINED',
+  status VARCHAR(24) NOT NULL DEFAULT 'PENDING' COMMENT '状态：PENDING待发送、CLAIMED已领取、SENT已发送、QUARANTINED隔离',
   attempt_count INT NOT NULL DEFAULT 0 COMMENT '累计发送尝试次数',
   next_retry_at DATETIME(3) NOT NULL COMMENT '允许发送的最早时间',
   lease_owner VARCHAR(128) NULL COMMENT '领取实例标识',
   lease_until DATETIME(3) NULL COMMENT '领取租约截止时间',
   sent_at DATETIME(3) NULL COMMENT '发送成功时间',
   last_error VARCHAR(1000) 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),
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT 'Outbox记录创建时间',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT 'Outbox记录更新时间',
   PRIMARY KEY (id),
   UNIQUE KEY uk_file_export_outbox_event (event_id),
   UNIQUE KEY uk_file_export_outbox_task_version (task_id, dispatch_version),