按用户“详细一下代码注释,用中文”的要求,补充 29 个源码、测试、脚本与配置文件的中文说明,并将 5 份紧凑 JavaScript 脚本重新排版。业务逻辑、接口、数据库表与依赖版本保持一致,生成类型不手工修改。阅读入口见代码阅读指南。
注释范围#
| 范围 | 本轮说明重点 |
|---|---|
| flashsale 与 saleserver | 金额单位及算例、库存守恒、SQL 锁/事务/CAS、请求去重、永久钱包限购、签名正文、登录与权限、启动及关闭顺序 |
| messaging 与两个业务的 middleware | confirm 与业务完成的区别、持久 quorum 队列、prefetch、手动 ack、重连 deliveryTag、SQL 故障重试、永久坏消息处理 |
| 链索引与 FlashSale | 确认高度公式、固定 hash 读取、严格 deadline 边界、深重组冻结、链上验签、防重放、转币失败时整体回滚 |
| SaleApp / sale-api / demo-wallet / CSS | 异步上下文与同步防重入、刷新恢复、存储预检查、交易观察与资格终态、bigint、真实钱包适配、移动端布局 |
| 测试、启动脚本、Compose | 测试隔离和断言证明点、全新链/库、子进程清理、Windows BOM、原生命令退出码、中间件职责与卷保留 |
注释按实际调用顺序解释“为什么这样处理”和失败后的恢复方式,不把倒计时、HTTP 成功或 RabbitMQ confirm 描述为最终成交证明。
本轮验证#
证据单独保存在 evidence-comments-v0.6 ↗,不覆盖上轮交易、浏览器或中间件证据。
| 检查 | 结果与证据 |
|---|---|
| 14 个 Go 文件非注释 token 序列对比 | 全部一致,结果 |
| 14 个其他文件结构/有效内容对比 | TS/JS 使用语法树对比并忽略等价括号及解析器上下文标志;Solidity 使用 token 对比,CSS/YAML 去注释后对比;全部一致,结果 |
| Windows 启动器 | PowerShell 解析通过,非注释 token 序列一致,UTF8 BOM 保留,结果 |
| Go 全包测试与 vet | go test -count=1 ./…、go vet ./… 通过,日志 |
| 前端 | 46 个单元用例、三份生成契约一致性、格式、类型及生产构建通过,日志 |
| 合约 | 编译及 FlashSale/Settlement 两组真实 Anvil 测试通过,日志 |
| Node 脚本 | 5 个修改脚本 node –check 通过;Go 格式检查通过 |
本轮聚焦注释与排版,未重新运行浏览器、外部 PG/RabbitMQ 集成、race 或容量测试;这些环境的既有结果仍以发售测试说明和对应历史证据为准。