-- 能量/带宽出租设计 V2.2 + 用户套餐绑定;17表,Energy/Bandwidth独立套餐、USDT内部余额、人工充值/结算、幂等退款。 -- 共用sys_user、登录、Google和若依RBAC,只复用TRON只读查询;不引用支付apps/orders/wallet_address及其资金服务。 -- MySQL5.7.8+/8.0,InnoDB DYNAMIC,utf8mb4_bin;大索引前缀需启用。 -- 所有日期DATETIME(3)表示服务器本地,由应用显式写入,不改变支付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。 -- 地址上链扩展:order_type=ADDRESS_ONCHAIN,任务TRANSFER_TRX,分类TRX,不走资源换算或回收。 -- 地址上链固定1TRX,USDT本金折价及服务费按网络配置并锁定快照;旧库执行rent_address_onchain_migration.sql。 -- 委托接口只提交质押等值本金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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '凭证过期时间,服务器本地', `revoked_at` DATETIME(3) NULL COMMENT '吊销时间,服务器本地', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '可清理时间服务器本地,必须晚于消息有效期', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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` ( `transfer_enabled` TINYINT NOT NULL DEFAULT 0 COMMENT '认证Agent同步的固定1TRX转账能力及本地授权;旧Agent默认为关闭', `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 '最近认证心跳时间,服务器本地', `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 '本次会话认证完成服务器本地时间', `disconnected_at` DATETIME(3) NULL COMMENT '当前会话断开或超时服务器本地时间,仅当前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 '云端按有效心跳接收时间计算的在线租约截止服务器本地时间,节点本地时钟不作为判定来源', `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 '审核时间,服务器本地', `remark` VARCHAR(512) NULL COMMENT '审核或暂停原因', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '挑战签发服务器本地时间', `challenge_expires_at` DATETIME(3) NULL COMMENT '控制权证明挑战期限,服务器本地', `challenge_consumed_at` DATETIME(3) NULL COMMENT '挑战原子消费服务器本地时间;非空不可再次使用,签名失败不设置', `ownership_verified_at` DATETIME(3) NULL COMMENT '钱包离线消息签名验证通过的服务器本地时间,不等于供应商审核通过或交易权限已具备', `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 '云端可信快照时间,服务器本地', `snapshot_expires_at` DATETIME(3) NULL COMMENT '快照失效时间,服务器本地', `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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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', `billing_mode` VARCHAR(16) NOT NULL DEFAULT 'DURATION' COMMENT '计费模式:DURATION按时长,PER_ORDER按订单次数', `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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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='能量或带宽固定套餐及价格版本;套餐代码的资源类型不可改变'; -- 系统用户与套餐版本绑定:每用户+网络+资源类型一个当前套餐,历史绑定停用保留。 CREATE TABLE IF NOT EXISTS `rent_user_package` ( `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '绑定记录ID', `user_id` BIGINT NOT NULL COMMENT 'sys_user.user_id,应用按所属用户共用绑定', `package_id` BIGINT NOT NULL COMMENT 'rent_package.id,绑定具体不可变版本', `status` VARCHAR(32) NOT NULL DEFAULT 'ACTIVE' COMMENT 'ACTIVE可下单、DISABLED停用', `network` VARCHAR(16) NOT NULL COMMENT '套餐网络NILE/MAINNET', `resource_type` VARCHAR(16) NOT NULL COMMENT '套餐资源ENERGY/BANDWIDTH', `default_slot` TINYINT NULL COMMENT '当前分类套餐取1,历史绑定NULL', `created_by` BIGINT NOT NULL COMMENT '配置管理员sys_user.user_id', `version` BIGINT NOT NULL DEFAULT 0 COMMENT '乐观锁版本', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_user_package` (`user_id`,`package_id`), UNIQUE KEY `uk_user_scope_default` (`user_id`,`network`,`resource_type`,`default_slot`), KEY `idx_user_package_active` (`user_id`,`status`), KEY `idx_package_binding` (`package_id`,`status`) ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='系统用户与租赁套餐绑定;默认取1,其余NULL'; -- 独立租赁资金账户;仅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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 NULL COMMENT '资源订单关联rent_package.id;地址上链为空', `order_type` VARCHAR(24) NOT NULL DEFAULT 'RESOURCE_RENTAL' COMMENT 'RESOURCE_RENTAL资源租赁、ADDRESS_ONCHAIN固定1TRX转账', `transfer_sun` BIGINT NULL COMMENT '地址上链固定1000000 SUN;资源租赁为空', `trx_price_usdt` DECIMAL(30,12) NULL COMMENT '1TRX兑换USDT的配置汇率快照', `principal_usdt` DECIMAL(30,6) NULL COMMENT 'TRX本金折价USDT,向上取6位', `service_fee_usdt` DECIMAL(30,6) NULL COMMENT '当前网络固定服务费USDT快照', `billing_mode` VARCHAR(16) NOT NULL DEFAULT 'DURATION' COMMENT '计费模式快照:DURATION或PER_ORDER', `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带宽;地址上链分类TRX,创建后不可修改', `resource_quantity` BIGINT NOT NULL COMMENT '资源订单数量必须大于零;地址上链为0,转账金额见transfer_sun', `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 '资源租期秒快照;地址上链为0无租期', `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位;地址上链以service_fee_usdt为基数,本金不分成', `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;地址上链NOT_REQUIRED', `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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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_supplier_dashboard` (`supplier_user_id`,`network`,`created_at`), 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回收、TRANSFER_TRX固定1TRX转账', `resource_type` VARCHAR(16) NOT NULL COMMENT 'ENERGY或BANDWIDTH;TRANSFER_TRX为TRX,必须与订单及链上交易一致并纳入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 '资源换算全网总额度必须大于0;TRANSFER_TRX为0,不进行资源换算', `conversion_total_weight` BIGINT NOT NULL COMMENT '资源换算全网TRX权重必须大于0;TRANSFER_TRX为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;委托按目标资源换算、回收取原确认本金;TRANSFER_TRX固定1000000', `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撤销、TRANSFER_TRX原生固定1TRX转账', `resource_type` VARCHAR(16) NOT NULL COMMENT 'ENERGY对应resource_code=1、BANDWIDTH对应resource_code=0;原生转账分类TRX无资源码', `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 '交易所在确认区块服务器本地时间,独立查询,用于委托服务起点及到期判断', `status` VARCHAR(32) NOT NULL DEFAULT 'REPORTED' COMMENT 'REPORTED已报、CONFIRMED已独立核验、FAILED已证实失败、UNKNOWN未知', `evidence` JSON NULL COMMENT '云端回执、交易参数、前后关系及确认规则证据,不含密钥', `expires_at` DATETIME(3) NULL COMMENT '原签名交易过期时间,服务器本地', `confirmed_at` DATETIME(3) NULL COMMENT '独立确认时间,服务器本地', `next_check_at` DATETIME(3) NULL COMMENT '下次链上核对,服务器本地', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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', `withdraw_id` BIGINT NULL COMMENT '关联租赁提现单;冻结、释放、完成各自唯一流水', `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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', PRIMARY KEY (`id`), UNIQUE KEY `uk_ledger_business` (`business_key`), KEY `idx_ledger_account` (`account_id`,`id`), KEY `idx_ledger_dashboard` (`account_id`,`created_at`), 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的服务器本地时间;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 '付款核验服务器本地时间,服务器本地', `remark` VARCHAR(512) NULL COMMENT '审核说明', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '余额、流水、订单累计、回调及审计原子提交服务器本地时间', `reason` VARCHAR(1024) NOT NULL COMMENT '退款及费用承担审核依据,必填', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间', 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 '下次重试,服务器本地', `lock_owner` VARCHAR(64) NULL COMMENT 'worker租约标识', `lock_until` DATETIME(3) NULL COMMENT 'worker租约期限,服务器本地', `last_error` VARCHAR(1024) NULL COMMENT '最近脱敏错误', `version` BIGINT NOT NULL DEFAULT 0 COMMENT 'CAS乐观锁版本,更新须条件递增;追加记录保持0', `created_at` DATETIME(3) NOT NULL COMMENT '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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 '创建服务器本地时间,应用显式写入', `updated_at` DATETIME(3) NOT NULL COMMENT '更新服务器本地时间,追加记录与创建时间相同', 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='业务操作和状态变更追加审计;关键事务同写'; -- 租赁提现新增表。重复执行不覆盖历史数据;先部署这些表,再开启提现配置。 CREATE TABLE IF NOT EXISTS rent_withdraw_order ( id BIGINT NOT NULL AUTO_INCREMENT, withdraw_no VARCHAR(40) NOT NULL COMMENT '系统提现编号', user_id BIGINT NOT NULL, account_id BIGINT NOT NULL, network VARCHAR(16) NOT NULL, client_request_no VARCHAR(64) NOT NULL, request_hash VARCHAR(64) NOT NULL, receiver_address VARCHAR(64) NOT NULL, amount DECIMAL(30,6) NOT NULL, frozen_amount DECIMAL(30,6) NOT NULL, status VARCHAR(24) NOT NULL COMMENT 'PENDING_REVIEW、EXECUTING、VERIFYING、MANUAL_REVIEW、REJECTED、COMPLETED', active_user_id BIGINT NULL COMMENT '全网络同用户仅允许一笔在途,终结置NULL', payout_sender_snapshot TEXT NULL COMMENT '审核时允许付款地址JSON快照,不含私钥', review_channel VARCHAR(16) NULL, reviewer_user_id BIGINT NULL, reviewer_telegram_id VARCHAR(64) NULL, review_reason VARCHAR(512) NULL, approved_at DATETIME(3) NULL, reviewed_at DATETIME(3) NULL, arrival_mode VARCHAR(16) NULL COMMENT 'MANUAL或AUTO,最终完成时锁定', arrival_transaction_id BIGINT NULL, arrival_operator_id BIGINT NULL, arrival_remark VARCHAR(512) NULL, completed_at DATETIME(3) NULL, remark VARCHAR(512) NOT NULL DEFAULT '', last_check_at DATETIME(3) NULL, last_error VARCHAR(512) NULL COMMENT '固定脱敏提示,不保存异常原文', version BIGINT NOT NULL DEFAULT 0, created_at DATETIME(3) NOT NULL, updated_at DATETIME(3) NOT NULL, PRIMARY KEY(id), UNIQUE KEY uk_withdraw_no(withdraw_no), UNIQUE KEY uk_withdraw_request(user_id,client_request_no), UNIQUE KEY uk_withdraw_active_user(active_user_id), KEY idx_withdraw_user(user_id,network,id), KEY idx_withdraw_pending(status,network,id) ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='租赁可用余额提现审核单'; CREATE TABLE IF NOT EXISTS rent_withdraw_transaction ( id BIGINT NOT NULL AUTO_INCREMENT, network VARCHAR(16) NOT NULL, transaction_id VARCHAR(64) NOT NULL, log_index INT NOT NULL, token_contract VARCHAR(64) NOT NULL, from_address VARCHAR(64) NOT NULL, to_address VARCHAR(64) NOT NULL, amount_units DECIMAL(65,0) NOT NULL, amount_usdt DECIMAL(65,6) NOT NULL, block_number BIGINT NOT NULL, block_hash VARCHAR(64) NULL, block_time DATETIME(3) NOT NULL, discovery_source VARCHAR(24) NOT NULL, verify_status VARCHAR(24) NOT NULL, match_status VARCHAR(24) NOT NULL, withdraw_id BIGINT NULL COMMENT '唯一认领的提现单', evidence TEXT NOT NULL COMMENT '筛选后的证据摘要,不存完整交易或认证数据', last_checked_at DATETIME(3) NOT NULL, version BIGINT NOT NULL DEFAULT 0, created_at DATETIME(3) NOT NULL, updated_at DATETIME(3) NOT NULL, PRIMARY KEY(id), UNIQUE KEY uk_withdraw_chain_event(network,transaction_id,log_index), UNIQUE KEY uk_withdraw_claim(withdraw_id), KEY idx_withdraw_tx_match(network,to_address,match_status,block_time) ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='手动提交及自动监听的已确认USDT事件'; CREATE TABLE IF NOT EXISTS rent_withdraw_scan_cursor ( id BIGINT NOT NULL AUTO_INCREMENT, network VARCHAR(16) NOT NULL, last_block BIGINT NOT NULL, lock_owner VARCHAR(64) NULL, lock_until DATETIME(3) NULL, last_error VARCHAR(512) NULL, version BIGINT NOT NULL DEFAULT 0, created_at DATETIME(3) NOT NULL, updated_at DATETIME(3) NOT NULL, PRIMARY KEY(id), UNIQUE KEY uk_withdraw_scan_network(network) ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='提现自动扫描断点及多实例租约';