telegram审核功能

This commit is contained in:
lu7213 committed 2026-10-14 10:58:41 -04:00
1 parent 2d88b77325
commit 5e63bb6add
10 files changed
+571 -2

No files matched your search

+61
View File
@@ -0,0 +1,61 @@
-- 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审核消息推送任务';