目前还缺少,套餐绑定关系的逻辑,请单独一张表,并且引导添加user\_id系统用户绑定套餐逻辑,并且在创建租赁订单,自动关联应用对应user\_id的套餐信息。 另外给我一个脚本,创建3个套餐的脚本。

This commit is contained in:
lu7213 committed 2026-10-25 11:20:45 -04:00
1 parent a83e1fef40
commit 0fd0450ddb
16 files changed
+299 -15

No files matched your search

+2 -2
View File
@@ -67,8 +67,8 @@ class RentalDesignChecks(unittest.TestCase):
self.insert(table, **values)
def test_table_and_document_coverage(self):
self.assertEqual(len(TABLES), 16)
self.assertEqual(len(re.findall(r"CREATE TABLE", DDL)), 16)
self.assertEqual(len(TABLES), 17)
self.assertEqual(len(re.findall(r"CREATE TABLE", DDL)), 17)
doc = (ROOT / "docs/rental/table-functional-flows.md").read_text("utf-8")
sections = set(re.findall(r"### 2\.\d+ (rent_\w+):", doc))
self.assertEqual(sections, set(TABLES))
+2
View File
@@ -1,5 +1,7 @@
# 租赁模块三端实现与运行说明
用户套餐绑定增量:核心表新增 rent_user_package,管理员授权具体套餐版本;应用按 user_id 选择已绑定套餐,省略 package_id 自动选择默认。部署前执行增量表SQL并配置用户绑定,见 [用户套餐绑定与脚本](user-package-bindings.md)。历史订单和在途处理不受绑定变更影响。
本文对应当前工作区的 V2.2 实现。设计依据仍为 [schema-design.md](schema-design.md) 和 [rent_init.sql](../../sql/rent_init.sql)。代码交付不等于生产迁移或真实链上验收;本次没有修改现有数据库,没有执行任何真实广播。
## 1. 三端职责
+2
View File
@@ -1,5 +1,7 @@
# 能量/带宽出租表结构与业务流程 V2.2
2026-10-25增量:新增第17张表 rent_user_package,按系统用户绑定套餐与默认项;下单从应用user_id确定授权,见 [用户套餐绑定](user-package-bindings.md)。以下16表描述为原设计基线。
状态:V2.2设计基线;当前已新增后端、Vue及本地Node.js Agent实现,运行配置、接口与验证边界见[三端实现说明](implementation.md)。未执行现有数据库迁移或真实链上广播。当前权威 DDL 为 [rent_init.sql](../../sql/rent_init.sql),共16张表;历史设计复核见[业务复核与修正说明](business-review-v2.2.md),逐表说明见[table-functional-flows.md](table-functional-flows.md)。下文“本次仅设计”描述设计审查阶段,不替代当前实现记录。
## 1. 简化范围和保留边界
+6
View File
@@ -518,6 +518,12 @@ flowchart TD
| 节点重复上报 | event(event_no),相同编号不同内容拒绝 |
| 旧连接覆盖新连接 | node.session_epoch 条件更新 |
### 2.17 rent_user_package:系统用户套餐绑定
系统用户与具体套餐版本多对多绑定。user_id 对应 sys_user,package_id 对应 rent_package;status 控制新单授权,default_slot=1 为用户默认项,其他为 NULL。每用户套餐唯一、每用户默认项唯一。created_by 记录管理员,version 和 UTC 时间用于更新与追溯。
管理员选用户→绑定已上架套餐→设置默认;应用通过 rent_app.user_id 使用绑定。新单省略套餐时选默认,显式指定时仍校验用户绑定;订单快照保存绑定编号和用户编号。停用不影响历史订单。详见 [绑定与部署说明](user-package-bindings.md)。当前核心表总计17张,前述16张为原基线。
## 6. 对账与实现注意事项
1. 每日核对账户冻结余额与 HELD 订单、待结算余额与未结净应收、余额投影与不可变流水;差异记录审计并人工处理。
+37
View File
@@ -0,0 +1,37 @@
# 用户套餐绑定与自动下单
新增独立表 `rent_user_package`,租赁核心表从16增加为17;按系统用户而非单个应用授权,多个应用共享 `rent_app.user_id` 对应的绑定。
## 部署与引导
1. 旧库执行 `sql/rent_user_package.sql`,新库使用已包含此表的 `sql/rent_init.sql`。不自动授权存量用户。
2. 执行 `sql/rent_seed_three_packages.sql` 创建三个可重复执行的 NILE 示例套餐:65000能量/3 USDT、130000能量/5 USDT、1500 bytes带宽/1 USDT,租期均1小时,冗余20%,供应商费率5%。价格仅用于演示。
3. 管理员在“租赁套餐”页下方“用户套餐绑定”搜索系统用户,再搜索已上架套餐,绑定并勾选一个默认套餐。需要 `rent:package:edit`,普通用户不能自行授权。
4. 用户应用页查看已绑定套餐;未绑定时显示联系管理员的引导。后台和外部API套餐列表均只返回本人已绑定的上架套餐。
5. 示例脚本默认只创建套餐;将开头 `@rental_user_id` 从 NULL 改成真实系统用户ID,可同时绑定三个套餐,并在尚无默认项时指定基础能量套餐。重跑不覆盖已有价格、绑定或默认项。
## 表字段与约束
`id`:主键;`user_id`:系统用户;`package_id`:具体套餐版本;`status`:ACTIVE/DISABLED;`default_slot`:默认为1,其余NULL;`created_by`:配置者;`version`:更新版本;`created_at/updated_at`:UTC。
唯一(user_id,package_id)避免重复绑定,唯一(user_id,default_slot)保证每用户最多一个默认项。停用默认项会清除默认槽,不自动切换到另一套餐,避免无意改用不同网络/价格。新价格版本必须重新绑定,不自动迁移旧版本。
## 下单规则
创建订单仍必须提供应用ID、商户单号、接收地址;`package_id` 可选。
```json
{"app_id":1,"merchant_order_no":"ORDER-001","receiver_address":"有效TRON地址"}
```
服务端从应用记录读取 user_id,省略套餐时选择该用户唯一 ACTIVE 默认项;显式指定时必须有 ACTIVE 用户绑定,且套餐上架。请求携带 network/resource_type 时必须与套餐匹配。没有默认项或绑定不可用则明确拒绝,不回退到任意公开套餐。客户端提交 user_id 不影响服务端归属。
订单保存 package_id 和完整不可变 package_snapshot,快照附加 binding_id、binding_user_id。金额、数量、网络、费率均来自服务端套餐。默认项更改或绑定停用后,同一商户订单号的幂等重试仍使用原订单版本,不重复冻结。
接口:GET /rental/package/users、GET /rental/package/options、GET /rental/package/bindings/{userId}、POST /rental/package/bind(均套餐管理权限);GET /rental/package/bindings(本人查看权限)。绑定写入启用状态及is_default布尔值,不物理删除绑定,保留审计。
## 验证
JDK8 租赁隔离测试59项通过,含默认选择、未授权套餐拒绝、绑定停用、默认切换幂等、客户端user_id不能改变归属,以及三套餐INSERT重复执行和字段有效性。离线DDL与文档测试12项通过,前端ESLint、模板编译和staging构建通过,产物在usdt-ui/dist-rental-package-binding。构建仍有其他页面的3项导出缺失及资源体积警告。
未执行实际MySQL建表、套餐/绑定写入或真实登录浏览器验收。脚本三套餐INSERT使用H2做兼容转换隔离验证,不替代实际MySQL部署验收。