Files
usdt/sql/telegram_audit.sql
2026-10-14 10:58:41 -04:00

62 lines
4.5 KiB
SQL
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
-- 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审核消息推送任务';