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

3.2 KiB
Raw Blame History

审查发现

已确认范围

  • 当前租赁文件为未跟踪的新设计: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;未对现有数据库或链上资产执行操作。