-- Telegram审核记录表:一条业务记录最多对应一个审核单。 CREATE TABLE IF NOT EXISTS telegram_audit_record ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID', audit_no VARCHAR(64) NOT NULL COMMENT '审核单号,Telegram按钮通过该值关联审核记录', business_type VARCHAR(64) NOT NULL COMMENT '业务类型,例如USDT_AGGREGATION表示USDT归集审核', business_id VARCHAR(128) NOT NULL COMMENT '业务记录ID,归集审核时为归集任务ID', title VARCHAR(255) NOT NULL COMMENT '审核标题', payload TEXT NOT NULL COMMENT '审核业务快照JSON,不保存私钥、密码等敏感信息', audit_status VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT '审核状态:PENDING待审核、APPROVED已通过、REJECTED已拒绝', telegram_chat_id VARCHAR(64) DEFAULT NULL COMMENT '审核消息所在Telegram群组或会话ID', telegram_message_id BIGINT DEFAULT NULL COMMENT 'Telegram审核消息ID,用于审核后更新原消息', reviewer_telegram_id VARCHAR(64) DEFAULT NULL COMMENT '审核人的Telegram数字用户ID;SYSTEM表示后台审核', reviewer_name VARCHAR(128) DEFAULT NULL COMMENT '审核人Telegram用户名或后台登录用户名', review_comment VARCHAR(1000) DEFAULT NULL COMMENT '审核意见或拒绝原因', reviewed_at DATETIME DEFAULT NULL COMMENT '审核完成时间', created_at DATETIME NOT NULL COMMENT '创建时间', updated_at DATETIME NOT NULL COMMENT '最后更新时间', PRIMARY KEY (id), UNIQUE KEY uk_telegram_audit_no (audit_no) COMMENT '保证审核单号唯一', UNIQUE KEY uk_telegram_audit_business (business_type, business_id) COMMENT '保证同一业务记录只生成一个审核单', KEY idx_telegram_audit_status_time (audit_status, created_at) COMMENT '待审核记录及审核时效查询索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Telegram审核记录'; -- Telegram审核操作日志:记录有效、重复、越权和无效审核操作。 CREATE TABLE IF NOT EXISTS telegram_audit_log ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID', audit_no VARCHAR(64) NOT NULL COMMENT '关联审核单号', telegram_update_id BIGINT DEFAULT NULL COMMENT 'Telegram Update唯一ID,用于Webhook请求幂等防重', telegram_callback_query_id VARCHAR(128) DEFAULT NULL COMMENT 'Telegram按钮回调查询ID,用于应答按钮操作', telegram_user_id VARCHAR(64) DEFAULT NULL COMMENT '操作人的Telegram数字用户ID', telegram_username VARCHAR(128) DEFAULT NULL COMMENT '操作人的Telegram用户名,仅用于展示和审计', action VARCHAR(32) NOT NULL COMMENT '操作结果:RECEIVED已接收、APPROVED通过、REJECTED拒绝、UNAUTHORIZED越权、NOT_FOUND不存在、DUPLICATE重复', old_status VARCHAR(32) DEFAULT NULL COMMENT '操作前审核状态', new_status VARCHAR(32) DEFAULT NULL COMMENT '操作后审核状态', comment VARCHAR(1000) DEFAULT NULL COMMENT '操作说明、拒绝原因或异常摘要', created_at DATETIME NOT NULL COMMENT '操作发生时间', PRIMARY KEY (id), UNIQUE KEY uk_telegram_update_id (telegram_update_id) COMMENT '保证同一Telegram Update只处理一次', KEY idx_telegram_audit_log_no (audit_no) COMMENT '按审核单查询操作轨迹' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Telegram审核审计日志'; -- Telegram消息可靠推送任务:持久化保存发送状态,并支持失败重试和多实例领取。 CREATE TABLE IF NOT EXISTS telegram_audit_push_task ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID', audit_no VARCHAR(64) NOT NULL COMMENT '关联审核单号', task_status VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT '推送状态:PENDING待推送、PROCESSING推送中、RETRYING等待重试、SUCCESS成功、FAILED失败', retry_count INT NOT NULL DEFAULT 0 COMMENT '已失败重试次数,达到上限后转为FAILED', next_retry_at DATETIME NOT NULL COMMENT '下次允许执行时间,用于指数退避', last_error VARCHAR(1000) DEFAULT NULL COMMENT '最近一次推送失败原因摘要,不记录Bot Token等敏感信息', created_at DATETIME NOT NULL COMMENT '创建时间', updated_at DATETIME NOT NULL COMMENT '最后更新时间,同时用于PROCESSING任务租约判断', PRIMARY KEY (id), UNIQUE KEY uk_telegram_push_audit (audit_no) COMMENT '每个审核单只创建一个消息推送任务', KEY idx_telegram_push_due (task_status, next_retry_at) COMMENT '扫描到期推送及重试任务' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Telegram审核消息推送任务';