Files
usdt/sql/rent_init.sql
T
2026-10-22 11:09:36 -04:00

463 lines
43 KiB
SQL
Raw 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.
-- 能量/带宽出租设计 V2.2;16表,Energy/Bandwidth独立套餐、USDT内部余额、人工充值/结算、幂等退款。
-- 共用sys_user、登录、Google和若依RBAC,只复用TRON只读查询;不引用支付apps/orders/wallet_address及其资金服务。
-- MySQL5.7.8+/8.0,InnoDB DYNAMIC,utf8mb4_bin;大索引前缀需启用。
-- 所有日期DATETIME(3)表示UTC,由应用显式写入,不改变支付LOCAL连接时区。
-- API/节点/任务/回调仅api_key/api_secret HMAC-SHA256,Secret AES-GCM加密保存,密钥在配置或外部管理。
-- 不存TRON私钥或助记词,签名广播只在供应商本地Agent;默认广播关闭。
-- 采用逻辑外键,应用负责父记录归属、网络、金额非负、状态机及同事务一致性;MySQL5.7不强制CHECK。
-- 钱包按ENERGY/BANDWIDTH分别维护SUN额度、保留量和预留;同类型任务预留同事务,禁止跨类型挪用。
-- resource_type无默认值且必须显式校验:ENERGY数量单位Energy、BANDWIDTH数量单位bytes;链上类型分别1和0。
-- 委托接口只提交质押等值本金SUN,不直接提交Energy/bytes;请求量加正冗余后按当前全网参数换算,TRX向上取整。
-- 不使用DROP/ALTER,不是旧版53表升级脚本;IF NOT EXISTS不能将旧表升级成V2。
-- 业务规则及流程图详见docs/rental/schema-design.md,简化范围为本版设计选择,未执行数据库变更。
-- V2.2增加地址对占位、钱包执行串行及快照屏障、付款中状态和退款单;旧库须按实际数据另写版本化迁移。
-- 首版仅非锁定Stake2.0委托,禁止直接复用写死lock=true/86400的通用广播方法;租期不等于链上锁期。
-- 租赁独立商户应用;登录及权限共用若依
CREATE TABLE IF NOT EXISTS `rent_app` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`user_id` BIGINT NOT NULL COMMENT '所有者sys_user.user_id',
`name` VARCHAR(100) NOT NULL COMMENT '应用名称',
`status` VARCHAR(32) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE启用、DISABLED禁用',
`notify_url` VARCHAR(512) NULL COMMENT '默认HTTPS回调地址,必须检查SSRF',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
KEY `idx_app_user` (`user_id`,`status`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='租赁独立商户应用;登录及权限共用若依';
-- 商户及节点统一HMAC凭证版本;不含RSA
CREATE TABLE IF NOT EXISTS `rent_credential` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`owner_type` VARCHAR(8) NOT NULL COMMENT 'APP商户、NODE节点',
`owner_id` BIGINT NOT NULL COMMENT 'APP时rent_app.id,NODE时rent_node.id',
`api_key` VARCHAR(64) NOT NULL COMMENT '永久唯一公开凭证标识',
`api_secret` TEXT NOT NULL COMMENT 'AES-GCM加密封装的API Secret,含IV和tag;禁止返回或记录明文',
`master_key_version` VARCHAR(64) NOT NULL COMMENT '外部AES主密钥版本,不存主密钥',
`status` VARCHAR(32) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE可签发新消息、VERIFY_ONLY仅验历史在途、REVOKED吊销',
`expires_at` DATETIME(3) NULL COMMENT '凭证过期时间,UTC',
`revoked_at` DATETIME(3) NULL COMMENT '吊销时间,UTC',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_credential_key` (`api_key`),
KEY `idx_credential_owner` (`owner_type`,`owner_id`,`status`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='商户及节点统一HMAC凭证版本;不含RSA';
-- HMAC请求防重放记录
CREATE TABLE IF NOT EXISTS `rent_nonce` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`api_key` VARCHAR(64) NOT NULL COMMENT 'rent_credential.api_key',
`scope` VARCHAR(16) NOT NULL COMMENT 'API、NODE、TASK、WEBHOOK,签名须覆盖该域',
`nonce` VARCHAR(64) NOT NULL COMMENT '高熵随机数',
`expires_at` DATETIME(3) NOT NULL COMMENT '可清理时间UTC,必须晚于消息有效期',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_nonce` (`api_key`,`scope`,`nonce`),
KEY `idx_nonce_expire` (`expires_at`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='HMAC请求防重放记录';
-- 供应商本地Agent节点;供应商直接关联共享用户,不另建成员表
CREATE TABLE IF NOT EXISTS `rent_node` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`user_id` BIGINT NOT NULL COMMENT '供应商sys_user.user_id',
`node_no` VARCHAR(64) NOT NULL COMMENT '节点全局编号',
`name` VARCHAR(100) NOT NULL COMMENT '节点名称',
`status` VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING审核中、ACTIVE接单、PAUSED暂停、REVOKED吊销',
`agent_version` VARCHAR(32) NOT NULL COMMENT 'Agent版本',
`heartbeat_at` DATETIME(3) NULL COMMENT '最近认证心跳时间,UTC',
`connection_status` VARCHAR(16) NOT NULL DEFAULT 'OFFLINE' COMMENT '连接状态:OFFLINE离线、SYNCING已认证恢复中、ONLINE可通信;不替代审核及接单status',
`session_id` VARCHAR(64) NULL COMMENT '云端认证成功后生成的随机WebSocket会话编号,当前会话唯一,非登录Token',
`session_epoch` BIGINT NOT NULL DEFAULT 0 COMMENT '连接代次fencing token,新认证连接原子递增;旧会话消息和断开事件不能修改新会话',
`server_instance_id` VARCHAR(64) NULL COMMENT '持有当前WebSocket连接的云端实例标识,仅路由及恢复使用,不存Socket对象',
`connected_at` DATETIME(3) NULL COMMENT '本次会话认证完成UTC时间',
`disconnected_at` DATETIME(3) NULL COMMENT '当前会话断开或超时UTC时间,仅当前session_epoch可更新',
`heartbeat_interval_seconds` INT NOT NULL DEFAULT 15 COMMENT '应用层PING周期秒,默认15,由云端协商;须大于0',
`heartbeat_timeout_seconds` INT NOT NULL DEFAULT 45 COMMENT '未收到有效认证心跳的离线阈值秒,默认45;必须大于心跳周期',
`heartbeat_expires_at` DATETIME(3) NULL COMMENT '云端按有效心跳接收时间计算的在线租约截止UTC时间,节点本地时钟不作为判定来源',
`last_client_sequence` BIGINT NOT NULL DEFAULT 0 COMMENT '当前会话已接收客户端方向认证帧序号,从1递增;只用于会话去重,不替代业务message_id',
`created_by` BIGINT NOT NULL COMMENT '注册操作者sys_user.user_id',
`approved_by` BIGINT NULL COMMENT '审核sys_user.user_id',
`approved_at` DATETIME(3) NULL COMMENT '审核时间,UTC',
`remark` VARCHAR(512) NULL COMMENT '审核或暂停原因',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_node_no` (`node_no`),
KEY `idx_node_user` (`user_id`,`status`),
KEY `idx_node_online` (`status`,`connection_status`,`heartbeat_expires_at`),
UNIQUE KEY `uk_node_session` (`session_id`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='供应商本地Agent节点;供应商直接关联共享用户,不另建成员表';
-- 供应钱包及能量/带宽独立资源池投影;首版一个钱包仅绑定一个执行节点
CREATE TABLE IF NOT EXISTS `rent_wallet` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`node_id` BIGINT NOT NULL COMMENT 'rent_node.id,供应商归属由节点user_id取得',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
`address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '资源所有者,TRON Base58Check地址',
`status` VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING待核验、ACTIVE可调度、PAUSED暂停',
`permission_id` INT NULL COMMENT 'TRON链上权限编号,与平台HMAC无关',
`ownership_method` VARCHAR(32) NULL COMMENT '钱包验证方式:TRONLINK_SIGN_MESSAGE_V2,离线消息签名,不广播交易,不使用RSA',
`ownership_challenge` VARCHAR(128) NULL COMMENT '平台生成的高熵一次性随机挑战,绑定登录用户、钱包、网络和业务域;重新签发使旧挑战失效',
`ownership_message` TEXT NULL COMMENT '平台生成并保存的完整UTF-8待签文本,含域名、用途、user_id、wallet_id、地址、网络、nonce、签发及到期时间,后端不得信任客户端重建文本',
`ownership_signature` VARCHAR(256) NULL COMMENT 'TronLink的tronWeb.trx.signMessageV2对上述原文生成的签名;非私钥,仅用于钱包验证,禁止作为交易或API签名复用',
`ownership_verified_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NULL COMMENT '后端按TRON消息签名规则恢复并验证的Base58Check地址,必须与address完全一致',
`challenge_issued_at` DATETIME(3) NULL COMMENT '挑战签发UTC时间',
`challenge_expires_at` DATETIME(3) NULL COMMENT '控制权证明挑战期限,UTC',
`challenge_consumed_at` DATETIME(3) NULL COMMENT '挑战原子消费UTC时间;非空不可再次使用,签名失败不设置',
`ownership_verified_at` DATETIME(3) NULL COMMENT '钱包离线消息签名验证通过的UTC时间,不等于供应商审核通过或交易权限已具备',
`ownership_evidence` JSON NULL COMMENT '签名版本、原文摘要、恢复地址及当前链上权限核验结果,不包含私钥或助记词;历史验证事件写rent_event',
`energy_available` BIGINT NOT NULL DEFAULT 0 COMMENT '可用能量max(0,limit-used),仅查询投影',
`bandwidth_available` BIGINT NOT NULL DEFAULT 0 COMMENT '可用质押带宽max(0,limit-used),单位bytes,不含不可出租的免费带宽',
`energy_enabled` TINYINT NOT NULL DEFAULT 0 COMMENT '是否允许出租能量:0关闭、1开启,须本地策略及审核同时允许',
`bandwidth_enabled` TINYINT NOT NULL DEFAULT 0 COMMENT '是否允许出租带宽:0关闭、1开启,须本地策略及审核同时允许',
`energy_delegatable_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '链上能量类型可委托本金SUN,不能用TRX余额或带宽本金替代',
`energy_reserved_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '待执行及未知能量任务预留本金SUN,钱包行锁原子更新',
`energy_retain_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '供应商要求保留的能量质押本金SUN',
`bandwidth_delegatable_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '链上带宽类型可委托本金SUN,不包含免费带宽或能量本金',
`bandwidth_reserved_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '待执行及未知带宽任务预留本金SUN,钱包行锁原子更新',
`bandwidth_retain_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '供应商要求保留的带宽质押本金SUN',
`total_energy_limit` BIGINT NOT NULL DEFAULT 0 COMMENT '全网能量额度,用于动态换算',
`total_energy_weight` BIGINT NOT NULL DEFAULT 0 COMMENT '全网能量权重,零时拒绝估算',
`total_bandwidth_limit` BIGINT NOT NULL DEFAULT 0 COMMENT '全网质押带宽额度bytes,不能使用免费带宽额度换算',
`total_bandwidth_weight` BIGINT NOT NULL DEFAULT 0 COMMENT '全网带宽权重,零时拒绝带宽估算',
`snapshot_at` DATETIME(3) NULL COMMENT '云端可信快照时间,UTC',
`snapshot_expires_at` DATETIME(3) NULL COMMENT '快照失效时间,UTC',
`snapshot_block_height` BIGINT NULL COMMENT '两类可信资源快照对应确认区块;不得回退,须不小于snapshot_min_block_height',
`snapshot_min_block_height` BIGINT NOT NULL DEFAULT 0 COMMENT '已确认委托或撤销要求的最低快照区块;提高时使旧快照失效',
`policy` JSON NULL COMMENT '本地额度、费用保留、允许锁定模式等非敏感策略',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_wallet_address` (`network`,`address`),
KEY `idx_wallet_node` (`node_id`,`status`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='供应钱包及能量带宽独立资源池投影;一个钱包绑定一个执行节点';
-- 固定能量或带宽套餐及价格版本;每个套餐仅一个资源类型,改价新增版本
CREATE TABLE IF NOT EXISTS `rent_package` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`package_code` VARCHAR(32) NOT NULL COMMENT '套餐代码',
`revision` INT NOT NULL COMMENT '套餐版本递增',
`name` VARCHAR(100) NOT NULL COMMENT '套餐名称',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
`resource_type` VARCHAR(16) NOT NULL COMMENT '资源类型:ENERGY能量、BANDWIDTH带宽;必须显式填写,无默认值',
`resource_quantity` BIGINT NOT NULL COMMENT '交付资源正整数数量:ENERGY单位Energy、BANDWIDTH单位bytes,不是TRX或SUN',
`redundancy_percent` DECIMAL(10,4) NOT NULL DEFAULT 20.0000 COMMENT '资源冗余百分数,20表示20%,必须大于0;目标量必须严格大于请求量,创建订单锁定',
`duration_seconds` INT NOT NULL COMMENT '业务租期秒,不代表链上自动撤销',
`sale_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '售价USDT',
`supplier_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '供应商扣平台手续费前毛收入USDT,包含约定链上操作成本,不是净结算额',
`supplier_fee_percent` DECIMAL(7,4) NOT NULL COMMENT '平台向供应商收取的手续费百分数,必须显式配置且大于0小于100,5表示5%;下单锁定',
`fee_limit_sun` BIGINT NOT NULL DEFAULT 0 COMMENT '节点单笔操作本地费用预算SUN,零不可广播;委托撤销非合约交易,不假定协议支持fee_limit硬上限',
`delegate_lock` TINYINT NOT NULL DEFAULT 0 COMMENT '首版仅允许0非锁定委托;1拒绝上架,不能把租期秒当链上锁定参数',
`status` VARCHAR(32) NOT NULL DEFAULT 'DISABLED' COMMENT 'ACTIVE上架、DISABLED下架',
`rules` JSON NULL COMMENT '委托锁定模式、允许偏差、退款及费用承担规则;启用前必须配置',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_package_revision` (`package_code`,`revision`),
KEY `idx_package_sale` (`network`,`resource_type`,`status`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='能量或带宽固定套餐及价格版本;套餐代码的资源类型不可改变';
-- 独立租赁资金账户;仅USDT,按用户和网络隔离
CREATE TABLE IF NOT EXISTS `rent_account` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`user_id` BIGINT NOT NULL COMMENT 'sys_user.user_id,同用户可同时是商户和供应商',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
`available_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '可用USDT余额,不能为负',
`frozen_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '订单冻结USDT,不能为负',
`supplier_pending_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '供应商已履约扣平台手续费后的净待结算USDT,不能为负',
`status` VARCHAR(32) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE可操作、FROZEN冻结业务',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_account_user` (`user_id`,`network`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='独立租赁资金账户;仅USDT,按用户和网络隔离';
-- 能量或带宽租赁订单;一单一个资源类型一个钱包,履约与回收分开管理
CREATE TABLE IF NOT EXISTS `rent_order` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`order_no` VARCHAR(40) NOT NULL COMMENT '平台订单编号',
`app_id` BIGINT NOT NULL COMMENT 'rent_app.id',
`merchant_order_no` VARCHAR(64) NOT NULL COMMENT '商户订单号,兼作业务幂等键',
`request_hash` VARCHAR(64) NOT NULL COMMENT '原请求规范化摘要,同编号不同内容拒绝',
`package_id` BIGINT NOT NULL COMMENT 'rent_package.id',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
`receiver_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '资源接收者,TRON Base58Check地址',
`resource_type` VARCHAR(16) NOT NULL COMMENT '套餐资源类型快照:ENERGY能量、BANDWIDTH带宽,订单创建后不可修改',
`resource_quantity` BIGINT NOT NULL COMMENT '套餐资源数量快照:ENERGY单位Energy、BANDWIDTH单位bytes,必须大于零',
`redundancy_percent` DECIMAL(10,4) NOT NULL COMMENT '订单锁定冗余百分数,必须大于0,不能被套餐后续改价或调参覆盖',
`target_resource_quantity` BIGINT NOT NULL COMMENT '含冗余最低交付目标max(请求量+1,ceil(请求量乘以(1+冗余百分数/100))),严格大于resource_quantity',
`duration_seconds` INT NOT NULL COMMENT '租期秒快照',
`sale_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT 'USDT售价快照',
`supplier_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '供应商扣费前毛收入USDT快照,不能因费率变更被覆盖',
`supplier_fee_percent` DECIMAL(7,4) NOT NULL COMMENT '订单锁定供应商手续费百分数,必须大于0小于100',
`supplier_fee_amount` DECIMAL(30,6) NOT NULL COMMENT '平台手续费USDT快照=毛收入乘费率除100,按6位小数HALF_UP;必须大于0且小于毛收入',
`supplier_net_amount` DECIMAL(30,6) NOT NULL COMMENT '供应商净应收USDT快照=供应商毛收入减平台手续费,必须大于0,结算以此为基数',
`supplier_reversed_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '已冲正供应商净应收USDT累计,不超过supplier_net_amount,按审核退款规则追加流水',
`supplier_fee_reversed_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '已退回或冲正平台手续费USDT累计,不超过supplier_fee_amount,不因退款自动推定全退',
`supplier_fee_returned_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '手续费冲正中返还供应商的累计USDT,不超过supplier_fee_reversed_amount,增加本单可结算净额',
`package_snapshot` JSON NULL COMMENT '套餐、费用预算、偏差、锁定和退款规则快照',
`status` VARCHAR(32) NOT NULL DEFAULT 'WAITING' COMMENT 'WAITING待调度、EXECUTING委托中、VERIFYING核验中、SUCCESS履约成功、FAILED明确失败、CANCELLED未执行取消、MANUAL_REVIEW人工核对',
`wallet_id` BIGINT NULL COMMENT '选定rent_wallet.id;未知执行结果时不能改派',
`supplier_user_id` BIGINT NULL COMMENT '选定供应商sys_user.user_id快照',
`supplier_account_id` BIGINT NULL COMMENT '调度时固定供应商rent_account.id,与供应商用户及订单网络一致',
`relation_slot` TINYINT NULL COMMENT '分配钱包时取1,明确未执行终结或本金回收且资源恢复后置NULL;未知保留,禁止同钱包同接收者同类型并行租赁',
`payer_account_id` BIGINT NOT NULL COMMENT '商户rent_account.id',
`fund_status` VARCHAR(16) NOT NULL COMMENT '资金:HELD冻结、CHARGED扣款、RELEASED释放',
`refunded_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '累计已退USDT,仅可按规则退租赁内部余额',
`dispatch_deadline` DATETIME(3) NOT NULL COMMENT '创建时锁定的最晚新任务执行时间UTC;WAITING超时取消,已投递不能仅凭过期判未执行',
`service_started_at` DATETIME(3) NULL COMMENT '已独立核验委托交易所在区块的UTC时间,不使用核验完成时间延长租期',
`service_expires_at` DATETIME(3) NULL COMMENT '业务租期结束,不等于自动回收,UTC',
`reclaim_status` VARCHAR(24) NOT NULL COMMENT '回收:NOT_STARTED、WAITING、RUNNING、RECOVERING、DONE、MANUAL_REVIEW',
`next_reclaim_at` DATETIME(3) NULL COMMENT '下次到期或资源恢复核对,UTC',
`notify_url` VARCHAR(512) NULL COMMENT '该单回调URL快照,允许为空',
`error_code` VARCHAR(64) NULL COMMENT '稳定错误码',
`remark` VARCHAR(1024) NULL COMMENT '脱敏结果说明',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_order_no` (`order_no`),
UNIQUE KEY `uk_merchant_order` (`app_id`,`merchant_order_no`),
UNIQUE KEY `uk_order_relation` (`wallet_id`,`receiver_address`,`resource_type`,`relation_slot`),
KEY `idx_order_schedule` (`status`,`created_at`),
KEY `idx_order_dispatch_expire` (`status`,`dispatch_deadline`),
KEY `idx_order_reclaim` (`reclaim_status`,`next_reclaim_at`),
KEY `idx_order_supplier` (`supplier_account_id`,`status`,`id`),
KEY `idx_order_app` (`app_id`,`created_at`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='能量或带宽租赁订单;一单一种资源一个钱包,履约与回收分开';
-- 委托或回收任务,兼作持久队列与资源预留明细
CREATE TABLE IF NOT EXISTS `rent_task` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`task_no` VARCHAR(64) NOT NULL COMMENT '任务编号',
`order_id` BIGINT NOT NULL COMMENT 'rent_order.id',
`wallet_id` BIGINT NOT NULL COMMENT 'rent_wallet.id',
`node_id` BIGINT NOT NULL COMMENT 'rent_node.id',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '与订单钱包及实际链上交易一致的网络,纳入HMAC',
`source_transaction_id` BIGINT NULL COMMENT 'RECLAIM必须指向原已确认DELEGATE的rent_transaction.id;DELEGATE为空,不允许回收任务引用回收交易',
`wallet_execution_slot` TINYINT NULL DEFAULT 1 COMMENT '同钱包同资源类型最多一个在途链上操作;未知保留1,终结且写入快照屏障后置NULL;与订单地址对占位独立',
`task_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM回收,不支持转账',
`resource_type` VARCHAR(16) NOT NULL COMMENT '资源类型:ENERGY或BANDWIDTH,必须与订单及链上交易一致并纳入HMAC',
`resource_quantity` BIGINT NOT NULL COMMENT '本任务资源数量快照:ENERGY单位Energy、BANDWIDTH单位bytes,不得跨类型换算',
`target_resource_quantity` BIGINT NOT NULL COMMENT '原订单含冗余目标快照;委托必须覆盖该量,回收任务仅用于追溯原委托目标',
`conversion_total_limit` BIGINT NOT NULL COMMENT '换算时该资源全网总额度:ENERGY为Energy,BANDWIDTH为质押带宽bytes,必须大于0',
`conversion_total_weight` BIGINT NOT NULL COMMENT '换算时该资源全网总权重,单位为协议TRX权重,不能当作SUN;必须大于0',
`conversion_block_height` BIGINT NOT NULL COMMENT '可信换算查询对应区块高度,结合时间检查快照有效期',
`conversion_at` DATETIME(3) NOT NULL COMMENT '本次换算参数查询UTC时间,Agent签名前必须重新检查参数及额度',
`estimated_resource_quantity` BIGINT NOT NULL COMMENT '按本次换算参数和delegate_sun向下计算的资源量,委托任务必须不小于target_resource_quantity',
`attempt_no` INT NOT NULL COMMENT '同订单同类型的尝试序号',
`active_slot` TINYINT NULL DEFAULT 1 COMMENT '有效或已成功取1,仅明确未执行失败可置NULL;UNKNOWN不得释放',
`delegate_sun` BIGINT NOT NULL COMMENT '委托本金SUN=ceil(目标资源量乘全网权重除全网额度)乘1000000,TRX向上取整;回收取原确认本金,禁止重新按资源量换算',
`fee_limit_sun` BIGINT NOT NULL COMMENT '本地操作费用预算SUN;按当前网络费用、签名权限及资源评估,不作为协议fee_limit硬上限',
`credential_id` BIGINT NOT NULL COMMENT '目标节点rent_credential.id',
`nonce` VARCHAR(64) NOT NULL COMMENT '任务防重放随机数',
`signed_at` DATETIME(3) NOT NULL COMMENT 'HMAC签发UTC时间,按Unix毫秒参与签名',
`deadline` DATETIME(3) NOT NULL COMMENT '允许新签名及新广播截止UTC时间;委托不晚于订单dispatch_deadline,回收使用独立有效期;过期仍允许原交易核对',
`intent` JSON NOT NULL COMMENT 'RENT_TASK_V2冻结意图:网络、类型、请求及目标、换算证据、精确本金SUN、owner/receiver、非锁定、预算、期限、节点、原委托来源及txId,全部纳入HMAC且与标量字段一致',
`signature` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT 'TASK域的HMAC-SHA256小写十六进制,不含自身',
`status` VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING待接单、ACCEPTED接受、BROADCASTED已广播、VERIFIED核验成功、REJECTED明确未执行拒绝、FAILED明确失败、UNKNOWN未知',
`reservation_status` VARCHAR(16) NOT NULL COMMENT '委托资源占用HELD、COMMITTED、RELEASED;未知委托保持HELD;回收任务固定NONE,不新增可委托本金预留',
`lease_owner` VARCHAR(64) NULL COMMENT '云端worker抢占标识,非节点身份',
`lease_until` DATETIME(3) NULL COMMENT 'worker租约截止,UTC',
`accepted_at` DATETIME(3) NULL COMMENT '节点接受时间,UTC',
`delivery_message_id` VARCHAR(64) NULL COMMENT '本逻辑任务推送的稳定消息编号,重发保持不变;仅新业务任务使用新编号',
`delivery_session_epoch` BIGINT NULL COMMENT '最近推送所用节点会话代次,重连重新投递时更新;不修改原任务签名意图',
`delivery_count` INT NOT NULL DEFAULT 0 COMMENT 'Socket任务发送次数,仅表示投递尝试,不是链上执行次数',
`last_sent_at` DATETIME(3) NULL COMMENT '最近一次向节点写入任务帧的UTC时间,不代表对端已持久化',
`delivery_acked_at` DATETIME(3) NULL COMMENT '节点本地持久化任务后返回接收ACK的云端UTC时间,不代表接受、广播或执行成功',
`next_check_at` DATETIME(3) NULL COMMENT '下次处理时间,UTC',
`error` VARCHAR(1024) NULL COMMENT '脱敏原因',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_task_no` (`task_no`),
UNIQUE KEY `uk_task_attempt` (`order_id`,`task_type`,`attempt_no`),
UNIQUE KEY `uk_task_active` (`order_id`,`task_type`,`active_slot`),
UNIQUE KEY `uk_task_wallet_execution` (`wallet_id`,`resource_type`,`wallet_execution_slot`),
UNIQUE KEY `uk_task_delivery` (`delivery_message_id`),
KEY `idx_task_push` (`node_id`,`status`,`deadline`),
KEY `idx_task_check` (`status`,`next_check_at`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='委托或回收任务,兼作持久队列与资源预留明细';
-- 链上委托或回收证据;一任务只能构建一笔交易
CREATE TABLE IF NOT EXISTS `rent_transaction` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`task_id` BIGINT NOT NULL COMMENT 'rent_task.id',
`network` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '网络:NILE、MAINNET,必须与所有关联对象一致',
`tx_id` VARCHAR(64) NOT NULL COMMENT '链上交易哈希',
`owner_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '实际资源owner,TRON Base58Check地址',
`receiver_address` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '实际receiver,TRON Base58Check地址',
`transaction_type` VARCHAR(16) NOT NULL COMMENT 'DELEGATE委托、RECLAIM撤销',
`resource_type` VARCHAR(16) NOT NULL COMMENT '实际链上资源类型:ENERGY对应resource_code=1、BANDWIDTH对应resource_code=0,独立核验',
`amount_sun` BIGINT NOT NULL COMMENT '链上实际本金SUN',
`verified_total_limit` BIGINT NULL COMMENT '独立核验区块该资源全网额度,确认前可空,确认委托时必须有有效正值',
`verified_total_weight` BIGINT NULL COMMENT '独立核验区块该资源全网TRX权重,确认前可空,不能与SUN混用',
`verified_resource_quantity` BIGINT NULL COMMENT '实际本金对应资源额度;不足目标仍保留真实值并确认链上事实,但订单转人工不能记履约成功;撤销不作新交付',
`baseline_sun` BIGINT NOT NULL COMMENT '执行前同owner/receiver及相同resource_type的委托本金SUN,能量带宽分别计算',
`after_sun` BIGINT NULL COMMENT '核验后同地址对及相同resource_type的本金SUN,不混入另一资源类型',
`block_height` BIGINT NULL COMMENT '确认区块高度',
`block_time` DATETIME(3) NULL COMMENT '交易所在确认区块UTC时间,独立查询,用于委托服务起点及到期判断',
`status` VARCHAR(32) NOT NULL DEFAULT 'REPORTED' COMMENT 'REPORTED已报、CONFIRMED已独立核验、FAILED已证实失败、UNKNOWN未知',
`evidence` JSON NULL COMMENT '云端回执、交易参数、前后关系及确认规则证据,不含密钥',
`expires_at` DATETIME(3) NULL COMMENT '原签名交易过期时间,UTC',
`confirmed_at` DATETIME(3) NULL COMMENT '独立确认时间,UTC',
`next_check_at` DATETIME(3) NULL COMMENT '下次链上核对,UTC',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_transaction_task` (`task_id`),
UNIQUE KEY `uk_transaction_hash` (`network`,`tx_id`),
KEY `idx_transaction_check` (`status`,`next_check_at`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='链上委托或回收证据;一任务只能构建一笔交易';
-- 不可变租赁资金流水;余额与流水同事务,冲正追加不覆盖
CREATE TABLE IF NOT EXISTS `rent_ledger` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`account_id` BIGINT NOT NULL COMMENT 'rent_account.id',
`business_key` VARCHAR(160) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '全局唯一记账键;普通业务含事件及账户,TOPUP仅按网络及链上事件唯一标识构造,不含账户以防跨用户重复充值',
`event_type` VARCHAR(24) NOT NULL COMMENT 'TOPUP充值、HOLD冻结、CHARGE扣款、RELEASE解冻、SUPPLIER_EARN毛应收、SUPPLIER_FEE供应商手续费、SETTLE净额结算、REFUND退款、REVERSAL冲正',
`delta_available` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '可用余额变化,有正负',
`delta_frozen` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '冻结余额变化,有正负',
`delta_supplier_pending` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '供应商待结算变化,有正负',
`delta_platform_fee` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '平台供应商手续费收入变动USDT;扣费为正、退费为负;退商户增加可用,退供应商增加待结算,不是用户账户余额',
`after_available` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '变更后可用USDT',
`after_frozen` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '变更后冻结USDT',
`after_supplier_pending` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '变更后待结算USDT',
`order_id` BIGINT NULL COMMENT '关联rent_order.id',
`settlement_id` BIGINT NULL COMMENT '关联rent_settlement.id',
`refund_id` BIGINT NULL COMMENT '退款或相关冲正关联rent_refund.id,每个退款内各事件使用独立business_key',
`reversal_of_id` BIGINT NULL COMMENT '冲正的rent_ledger.id',
`operator_user_id` BIGINT NOT NULL COMMENT '操作者sys_user.user_id,后台系统为0',
`evidence_ref` VARCHAR(255) NULL COMMENT '人工充值、付款或补偿审核依据编号;充值凭据必须全局防重复',
`reason` VARCHAR(512) NOT NULL COMMENT '记账或人工调整原因,必填',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_ledger_business` (`business_key`),
KEY `idx_ledger_account` (`account_id`,`id`),
KEY `idx_ledger_order` (`order_id`,`id`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='不可变租赁资金流水;余额与流水同事务,冲正追加不覆盖';
-- 供应商人工结算单;不自动链上出金
CREATE TABLE IF NOT EXISTS `rent_settlement` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`settlement_no` VARCHAR(40) NOT NULL COMMENT '结算单号',
`account_id` BIGINT NOT NULL COMMENT '供应商rent_account.id',
`amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '本次人工结算USDT总额,必须大于零',
`status` VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING待审、APPROVED待付款、PAYING已占用付款授权、PAID付款核验完成、REJECTED明确未付拒绝、UNKNOWN付款待核对',
`payout_no` VARCHAR(64) NULL COMMENT '人工付款授权唯一编号;先同事务进入PAYING并持久化该编号再付款,重试查询原付款,不重新授权',
`payment_started_at` DATETIME(3) NULL COMMENT '进入PAYING的UTC时间;PAYING或UNKNOWN不能因超时释放来源',
`payment_evidence` JSON NULL COMMENT '收款信息、唯一付款凭据和独立核对结果;没有确认不能记已付',
`payment_reference` VARCHAR(96) NULL COMMENT '唯一标准化付款凭据,例如network:txid:index,防重复登记',
`created_by` BIGINT NOT NULL COMMENT '发起sys_user.user_id',
`approved_by` BIGINT NULL COMMENT '审批sys_user.user_id,职责分离',
`paid_at` DATETIME(3) NULL COMMENT '付款核验UTC时间,UTC',
`remark` VARCHAR(512) NULL COMMENT '审核说明',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_settlement_no` (`settlement_no`),
UNIQUE KEY `uk_settlement_payment` (`payment_reference`),
UNIQUE KEY `uk_settlement_payout` (`payout_no`),
KEY `idx_settlement_account` (`account_id`,`status`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='供应商人工结算单;不自动链上出金';
-- 供应商订单应收与结算关联;首版每单全额结算一次
CREATE TABLE IF NOT EXISTS `rent_settlement_item` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`settlement_id` BIGINT NOT NULL COMMENT 'rent_settlement.id',
`order_id` BIGINT NOT NULL COMMENT '已履约rent_order.id',
`amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '本单净可结算USDT=supplier_net_amount减supplier_reversed_amount加supplier_fee_returned_amount;手续费不重复扣',
`active_slot` TINYINT NULL DEFAULT 1 COMMENT '占用或已支付为1;明确拒绝且未付款可置NULL,UNKNOWN不可释放',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_settlement_order` (`order_id`,`active_slot`),
KEY `idx_settlement_item` (`settlement_id`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='供应商订单应收与结算关联;首版每单全额结算一次';
-- 内部余额退款及供应商/手续费调整;不执行外部出金
CREATE TABLE IF NOT EXISTS `rent_refund` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`refund_no` VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '平台全局唯一退款编号',
`order_id` BIGINT NOT NULL COMMENT 'rent_order.id,仅CHARGED且已确认收入的订单可退款;HELD订单用释放流程',
`request_no` VARCHAR(64) NOT NULL COMMENT '同订单退款请求幂等编号,调用方重试保持不变',
`request_hash` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '规范化退款请求SHA256,同编号不同内容拒绝',
`refund_amount` DECIMAL(30,6) NOT NULL COMMENT '本次返还商户内部可用余额USDT,必须大于0,包含退商户的平台手续费部分',
`supplier_reverse_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '本次冲正供应商原净应收USDT,累计不能超过订单supplier_net_amount',
`platform_fee_reverse_amount` DECIMAL(30,6) NOT NULL DEFAULT 0 COMMENT '本次退回平台手续费USDT,累计不能超过订单supplier_fee_amount',
`fee_return_to` VARCHAR(16) NOT NULL DEFAULT 'NONE' COMMENT 'NONE无退费、MERCHANT已包含在refund_amount、SUPPLIER增加供应商待结算及订单返还累计;无自动推定',
`status` VARCHAR(24) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING待审核、APPLIED已同事务入账、REJECTED已拒绝;无外部退款中状态',
`created_by` BIGINT NOT NULL COMMENT '发起sys_user.user_id',
`approved_by` BIGINT NULL COMMENT '审批sys_user.user_id,必须与发起人不同',
`applied_at` DATETIME(3) NULL COMMENT '余额、流水、订单累计、回调及审计原子提交UTC时间',
`reason` VARCHAR(1024) NOT NULL COMMENT '退款及费用承担审核依据,必填',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_refund_no` (`refund_no`),
UNIQUE KEY `uk_refund_request` (`order_id`,`request_no`),
KEY `idx_refund_review` (`status`,`created_at`),
KEY `idx_refund_order` (`order_id`,`id`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='内部余额退款审批与幂等来源;部分退款逐次新增,不覆盖历史';
-- 订单回调持久队列;业务状态更新时同事务写入
CREATE TABLE IF NOT EXISTS `rent_webhook` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`event_no` VARCHAR(64) NOT NULL COMMENT '商户回调事件编号',
`order_id` BIGINT NOT NULL COMMENT 'rent_order.id',
`event_type` VARCHAR(24) NOT NULL COMMENT 'SUCCESS、FAILED、CANCELLED、REFUNDED、RECLAIMED',
`event_key` VARCHAR(160) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '全局唯一业务事件键;普通事件ORDER:id:type,退款REFUND:refund_no,每次部分退款独立',
`order_event_sequence` BIGINT NOT NULL COMMENT '锁订单行后分配的递增事件序号;商户去重并按序号识别乱序,重试不变',
`payload` JSON NOT NULL COMMENT '锁定回调业务内容,不含内部成本或Secret',
`status` VARCHAR(32) NOT NULL DEFAULT 'PENDING' COMMENT 'PENDING待发、SENDING发送、ACKED确认、DEAD重试超限',
`attempt_count` INT NOT NULL DEFAULT 0 COMMENT '重试次数,每次生成新nonce及timestamp',
`credential_id` BIGINT NULL COMMENT '最近回调使用的APP主体rent_credential.id',
`next_attempt_at` DATETIME(3) NULL COMMENT '下次重试,UTC',
`lock_owner` VARCHAR(64) NULL COMMENT 'worker租约标识',
`lock_until` DATETIME(3) NULL COMMENT 'worker租约期限,UTC',
`last_error` VARCHAR(1024) NULL COMMENT '最近脱敏错误',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_webhook_event` (`event_no`),
UNIQUE KEY `uk_webhook_business` (`event_key`),
UNIQUE KEY `uk_webhook_order_sequence` (`order_id`,`order_event_sequence`),
KEY `idx_webhook_due` (`status`,`next_attempt_at`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='订单回调持久队列;业务状态更新时同事务写入';
-- 业务操作和状态变更追加审计;关键事务同写
CREATE TABLE IF NOT EXISTS `rent_event` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '记录主键',
`event_no` VARCHAR(96) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '全局事件编号;节点按NODE:nodeId:eventId构造,限制eventId长度使总长不超过96',
`object_type` VARCHAR(24) NOT NULL COMMENT 'APP、NODE、WALLET、PACKAGE、ORDER、TASK、ACCOUNT、SETTLEMENT、REFUND',
`object_id` BIGINT NOT NULL COMMENT '对应业务表id',
`action` VARCHAR(40) NOT NULL COMMENT '状态变更或操作代码',
`actor_user_id` BIGINT NOT NULL COMMENT 'sys_user.user_id,节点或系统处理为0',
`node_id` BIGINT NULL COMMENT '节点事件来源rent_node.id',
`detail` JSON NULL COMMENT '脱敏前后状态、结果与核验证据,不含Secret',
`reason` VARCHAR(1024) NOT NULL COMMENT '操作依据或状态转换说明',
`version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0',
`created_at` DATETIME(3) NOT NULL COMMENT '创建UTC时间,应用显式写入',
`updated_at` DATETIME(3) NOT NULL COMMENT '更新UTC时间,追加记录与创建时间相同',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_event_no` (`event_no`),
KEY `idx_event_object` (`object_type`,`object_id`,`id`)
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='业务操作和状态变更追加审计;关键事务同写';