文档调整
This commit is contained in:
1 parent
2a9f1c4c7c
commit
fcff9fa48d
3 files changed
+34
-1
No files matched your search
@@ -16,6 +16,17 @@
|
|||||||
|
|
||||||
生成器的 `/system/rentXxx` 接口已由 `RentalLegacyGuard` 拒绝,包括读取、导出及写入。这样既防止任意覆盖余额/状态,也防止旧凭证导出接口泄露密文。新页面使用 `/rental`,不要再调用旧CRUD。旧Service/Mapper保留作为已生成基础代码,业务链路不调用其任意修改方法。
|
生成器的 `/system/rentXxx` 接口已由 `RentalLegacyGuard` 拒绝,包括读取、导出及写入。这样既防止任意覆盖余额/状态,也防止旧凭证导出接口泄露密文。新页面使用 `/rental`,不要再调用旧CRUD。旧Service/Mapper保留作为已生成基础代码,业务链路不调用其任意修改方法。
|
||||||
|
|
||||||
|
### 角色配置与资金账户
|
||||||
|
|
||||||
|
| 角色 | 需要配置的业务主体 | 资金账户用途 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 供应商(仅出租) | `rent_node`、节点凭证、本地 Agent 及 `rent_wallet`;无需 `rent_app` | 通过 `rent_account` 记录净待结算收入、退款冲正和结算 |
|
||||||
|
| 租赁用户(购买资源的商户) | `rent_app`;使用外部 API 时配置应用凭证 | 通过 `rent_account` 记录充值、可用余额、订单冻结和扣款 |
|
||||||
|
|
||||||
|
供应商无需手动创建或配置 `rent_account`:当前代码在调度选中供应商时,根据 `rent_node.user_id` 与订单网络自动创建或复用账户,并将其固定到订单的 `supplier_account_id`。这不意味着供应商不需要资金账户记录。
|
||||||
|
|
||||||
|
`rent_account` 是平台内部 USDT 账本账户,不是链上钱包,不需要配置私钥。每个用户在每个网络只有一个账户(`user_id + network` 唯一),不按应用或节点单独开立;同一用户可以同时出租和购买资源,共用对应网络的账户。NILE 和 MAINNET 的资金分别记账。完整角色与表关系见 [设计说明](schema-design.md)。
|
||||||
|
|
||||||
## 2. 数据库、菜单和后端配置
|
## 2. 数据库、菜单和后端配置
|
||||||
|
|
||||||
1. 新环境检查MySQL5.7.8+/8.0配置后执行 `sql/rent_init.sql`。已有旧表不能靠 `IF NOT EXISTS` 升级,必须按实际结构和在途数据编写增量迁移;本次未运行脚本。
|
1. 新环境检查MySQL5.7.8+/8.0配置后执行 `sql/rent_init.sql`。已有旧表不能靠 `IF NOT EXISTS` 升级,必须按实际结构和在途数据编写增量迁移;本次未运行脚本。
|
||||||
|
|||||||
@@ -12,6 +12,20 @@
|
|||||||
|
|
||||||
保留供应商本地密钥、默认禁止广播、链上独立核验、订单幂等、原交易恢复、未知状态隔离、资金冻结、资源预留、到期回收、回调持久队列和不可变流水。
|
保留供应商本地密钥、默认禁止广播、链上独立核验、订单幂等、原交易恢复、未知状态隔离、资金冻结、资源预留、到期回收、回调持久队列和不可变流水。
|
||||||
|
|
||||||
|
### 参与角色与应用、节点、资金账户
|
||||||
|
|
||||||
|
“租赁用户”指购买资源的商户;“供应商”指提供质押资源的一方。两种身份均依托若依 `sys_user`,同一用户可以同时承担两种角色。
|
||||||
|
|
||||||
|
| 表 | 仅出租资源的供应商 | 购买资源的租赁用户(商户) |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `rent_node` | 需要,代表供应节点并连接本地 Agent;通过 `user_id` 归属供应商 | 不需要;同时经营供应业务时才需要 |
|
||||||
|
| `rent_app` | 不需要;同时购买资源时才需要 | 需要,承载订单归属、应用 API 认证和回调 |
|
||||||
|
| `rent_account` | 需要,记录供应商待结算收入、退款冲正和结算 | 需要,记录充值余额、订单冻结和扣款 |
|
||||||
|
|
||||||
|
`rent_account` 是平台内部 USDT 账本账户,不是链上钱包,不存储私钥,也不按应用或节点分别开立。账户按 `user_id + network` 唯一;同一用户兼任商户和供应商时,共用同一网络下的账户,NILE 与 MAINNET 分开记账。
|
||||||
|
|
||||||
|
供应关系为 `sys_user → rent_node → rent_wallet`;供应钱包用于提供链上资源,本地 Agent 保管私钥。供应收入根据节点所属用户及订单网络定位 `rent_account`。当前实现在调度选中供应商时自动创建或复用该账户,因此供应商无需手动配置资金账户,但数据库仍须保留账户记录以完成收入及结算记账。不能将“不需要手动配置”理解为“不需要这张表”。
|
||||||
|
|
||||||
## 2. 16张表及职责
|
## 2. 16张表及职责
|
||||||
|
|
||||||
| 表 | 作用 |
|
| 表 | 作用 |
|
||||||
|
|||||||
@@ -8,7 +8,15 @@
|
|||||||
|
|
||||||
共享若依 `sys_user`、登录及 RBAC 权限;租赁应用、订单和资金独立,不复用支付业务的 `apps`、`orders`、`wallet_address`。平台不保存供应商私钥或助记词。
|
共享若依 `sys_user`、登录及 RBAC 权限;租赁应用、订单和资金独立,不复用支付业务的 `apps`、`orders`、`wallet_address`。平台不保存供应商私钥或助记词。
|
||||||
|
|
||||||
### 1.1 通用字段与一致性约定
|
### 1.1 供应商与租赁用户的表使用关系
|
||||||
|
|
||||||
|
租赁用户是购买资源的商户,供应商是提供资源的一方,均关联若依 `sys_user`。仅出租资源的供应商需要 `rent_node` 及其 `rent_wallet`,不需要创建 `rent_app`;购买资源的商户需要 `rent_app`,不需要供应节点。同一用户可同时承担两种角色。
|
||||||
|
|
||||||
|
两方都需要 `rent_account`,但用途不同:商户使用可用余额及订单冻结余额,供应商使用待结算收入并处理退款冲正、结算。它是内部 USDT 账本账户,不是链上钱包,不需要配置私钥。账户按 `user_id + network` 唯一,而不是按应用或节点创建;同一用户兼任两种角色时共用该网络下的账户。
|
||||||
|
|
||||||
|
当前供应商入账流程为:调度选中 `rent_wallet` → 取得所属 `rent_node.user_id` → 按供应商用户及订单网络自动创建或复用 `rent_account` → 在订单固定 `supplier_account_id` → 独立核验履约后记入供应商净待结算收入 → 通过结算流程付款。供应商无需手动配置账户,但不能省略账户及流水记录。
|
||||||
|
|
||||||
|
### 1.2 通用字段与一致性约定
|
||||||
|
|
||||||
- `id` 为表内主键;业务编号和唯一键另行承担幂等职责。
|
- `id` 为表内主键;业务编号和唯一键另行承担幂等职责。
|
||||||
- `version` 用于 CAS 乐观锁,更新时带原版本条件并递增;追加记录保持 0。
|
- `version` 用于 CAS 乐观锁,更新时带原版本条件并递增;追加记录保持 0。
|
||||||
|
|||||||
Reference in new issue
Block a user