Files
usdt/docs/rental/user-package-bindings.md
T

40 lines
3.7 KiB
Markdown
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.
# 用户套餐绑定与自动下单
**当前规则已修正为一人一个当前套餐**,以下多套餐描述为上一版设计记录。页面、绑定替换规则、旧数据迁移及示例脚本当前行为,以 [单用户单套餐说明](single-user-package.md) 为准。
新增独立表 `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部署验收。