Files
usdt/.planning/rental-v22-review/findings.md
T
2026-10-22 19:58:57 -04:00

47 lines
3.2 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.
# 审查发现
## 已确认范围
- 当前租赁文件为未跟踪的新设计:sql/rent_init.sql、docs/rental/schema-design.md、docs/rental/table-functional-flows.md。
- 未检索到租赁 Java 服务,当前修改应保持为设计文件,不宣称修复运行时行为。
- 15 表 V2.1 使用逻辑外键,MySQL 5.7 不执行 CHECK。
## 待修正缺口
1. 部分退款被 webhook(order_id,event_type) 唯一键阻止;退款缺少独立持久业务编号及审批/幂等对象。
2. 结算没有付款中状态,人工付款与数据库确认间可能被拒绝并释放来源。
3. 原文允许手续费返还供应商,但净应收/结算来源公式没有增加返还额,造成账单无法结算该金额。
4. 钱包预留释放和异步快照刷新缺少区块及版本屏障,可能用旧快照重新出租已委托本金。
5. 同地址对同资源多单仅描述应用串行,缺少可持久的互斥来源,原始关系增量和回收归属难以证明。
6. 服务起点使用核验完成时间,核验延迟会推迟租期并使经济事实不一致。
7. 无持久下单等待截止,回收任务未显式关联原委托交易;任务无 network 字段,跨表核验靠 JSON。
8. ITronService已有getCanDelegatedMaxSize只读查询;NILE/MAINNET通用delegateResourceV2写死lock=true、86400,与任意租期不兼容,租赁不可直接复用。
## V2.2决策
- 增加rent_refund至16表,部分退款使用独立幂等编号,回调按业务事件键和订单序号去重。
- 订单地址对占位持续至本金回收且资源恢复;任务按钱包及资源类型串行,未知不释放。
- 钱包确认区块下界、快照CAS及失效屏障共同防旧查询覆盖。
- 首版仅非锁定委托,避免不同业务租期被链上锁定合并;多单同地址对排队或另选钱包。
- 结算PAYING在人工付款前持久化,付款未知保留原授权编号与来源。
## 资源
## 后续生成代码审查
- 用户已新增16模块Controller/Domain/Mapper/Service/XML;之前未实现状态仅属于设计复核时点。
- 只有RentApp、RentNode、RentAccount实体直接有userId,其余13模块模板错误生成相同用户过滤/赋值/检查方法。
- 无userId模块的/user路由不能简单移除过滤后保留,应删除错误路由及无效isUser参数,保留后台PreAuthorize权限。
- 多个Controller和Service还引用不存在的getName;下拉显示使用真实业务编号或钱包地址。
- sql/rent_init.sql
- docs/rental/schema-design.md
- docs/rental/table-functional-flows.md
## 三端实现结论(2026-10-22)
- 当前工作区已实现后端、Vue及本地Node Agent,不再仅为设计文档。完整运行与接口说明见docs/rental/implementation.md。
- 普通TRON RPC不能提供任意确认区块的历史资源状态,自动交付核验依赖独立历史证明服务;缺失时必须人工隔离,不能以当前资源比率假装历史交付成功。
- 原交易未知时保留资金与SUN占位,恢复仅查询或重播原签名交易,不能创建替代交易。
- 本地验证结果与外部验收边界见docs/rental/validation-implementation.md;未对现有数据库或链上资产执行操作。