583 lines
51 KiB
SQL
583 lines
51 KiB
SQL
-- 能量/带宽出租设计 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',
|
||
`ip_whitelist` VARCHAR(2048) NOT NULL DEFAULT '' COMMENT 'API来源IP白名单;空拒绝,*允许全部,IPv4整段通配',
|
||
`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`),
|
||
`onchain_pending_slot` TINYINT GENERATED ALWAYS AS (CASE WHEN `order_type`='ADDRESS_ONCHAIN' AND `status` NOT IN ('SUCCESS','FAILED','CANCELLED') THEN 1 ELSE NULL END),
|
||
UNIQUE KEY `uk_order_onchain_pending` (`network`,`receiver_address`,`onchain_pending_slot`),
|
||
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手续费、INCOME_SETTLE收益入账、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 '结算单号',
|
||
`settlement_mode` VARCHAR(24) NOT NULL DEFAULT 'LEGACY_PAYOUT' COMMENT 'INTERNAL_TRANSFER收益划转;LEGACY_PAYOUT历史对外付款,新业务显式写INTERNAL_TRANSFER',
|
||
`settled_at` DATETIME(3) NULL COMMENT '收益转入可用余额完成时间;不同于历史付款paid_at',
|
||
`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待审、SETTLED内部收益结算完成、REJECTED拒绝;APPROVED/PAYING/PAID/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='提现自动扫描断点及多实例租约';
|