Files
usdt/docs/rental/validation-v2.2.md
2026-10-22 11:09:36 -04:00

37 lines
2.5 KiB
Markdown
Raw Permalink 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.
# V2.2 设计验证记录
## 验证范围
本次验证针对初始化 SQL、逐表文档、唯一索引语义及精确金额算例。没有连接或修改项目现有数据库,没有进行真实链上交易。
## 检查方式
1. 使用 SQLGlot 26.33.0 的 MySQL 方言解析完整 rent_init.sql:16 条 CREATE TABLE,0 条不支持的回退命令。该依赖仅安装于临时工具目录,不加入项目依赖。
2. 运行标准库脚本 `python docs/rental/check_schema.py`:从实际 DDL 提取列名和唯一键,在 SQLite 内存库检查重复插入及 NULL 占位语义;同时核对 16 张表文档覆盖、列注释、索引字段引用、本地文档链接及无破坏性语句。
3. 使用 Decimal 核对供应商手续费返还、净额冲正与结算来源一致,以及商户退款中手续费不重复入账。
## 结果
SQLGlot 严格 MySQL 方言解析通过:16 条 CREATE TABLE,无回退命令。离线脚本 12 项检查全部通过:
- 16 表及逐表文档一一覆盖、字段注释、唯一索引字段、无破坏性语句。
- 本地 Markdown 链接存在。
- 同地址对同资源类型互斥及 NULL 释放,多接收者/不同类型可并存。
- 同钱包同类型的委托与回收共享执行互斥。
- 同订单任务尝试与有效占位去重。
- 退款请求去重,同订单多次部分退款回调可写入且业务键、序号防重复。
- 出款授权与付款凭据唯一,未付款 NULL 可并存。
- 结算来源唯一,已付来源不能再占用。
- 跨账户重复充值业务键冲突。
- 一任务一交易及同网络交易哈希去重。
- Decimal 金额例中供应商返还手续费与结算来源一致,商户退款不重复加手续费。
脚本实际总数为 12。首轮发现验证记录尚未创建,以及一个记账键长度示例断言不成立;均已修正并完整重跑通过。
## 未覆盖内容
- 当前机器 Docker Linux 引擎未启动,也未发现可直接使用的 MySQL/MariaDB 命令。因此没有声称 MySQL 5.7/8.0 真实建表、索引字节限制、事务隔离或死锁测试通过。
- SQLite 映射仅验证实际唯一键的等值冲突及 NULL 语义,未模拟 MySQL 字段类型、字符集、外键或业务状态机。
- 租赁应用服务和 Agent 尚未实现,无法验证真实并发记账、CAS、出款恢复、断线恢复、HMAC 或状态转换;验收要求见 business-review-v2.2.md 第 8 节。
- 未执行 NILE/MAINNET 委托或回收,非锁定委托条件、历史参数取证、资源使用债务及恢复判定仍需真实网络验证。