# v0.6 实现与验证记录

本轮按“能够手动跑完验收”的要求实现发售业务，并根据用户中途确认把消息队列从 Kafka 改为 RabbitMQ。历史报告和证据不修改。本页对应当前源码，环境和命令见[测试说明](../04-testing/sale-testing.md)，逐步操作见[验收手册](../04-testing/sale-acceptance.md)。

## 实际完成

新增 FlashSale 合约、独立 Go saleserver/flashsale、钱包会话、SQL 库存与资格事务、outbox/inbox、签名 Worker、确认索引、安全过期回收、回环对账/指标、OpenAPI 与生成类型、活动页和本地 EIP1193 双钱包。发售复用既有 ERC20，到账后进入原二级市场，不把库存写入单写者 Engine。

RabbitMQ 适配由两个业务共享：持久 quorum 队列、persistent 消息、mandatory、publisher confirm、prefetch、SQL 后手动 ack、重连与原 ID 重投；发售坏消息进 SQL 隔离，交易永久坏消息进入 .dead。compose、入口环境变量、测试和当前文档同步，移除 Go 的 franz-go 依赖。旧 Kafka 卷/报告保留，不提供自动迁移旧 broker 未落库消息的工具。

前端使用 Carbon 纯色和直角布局：四步主操作、实时库存/余额、明确倒计时、钱包切换、刷新恢复、交易观察和失败提示、移动端先显示购买面板。余额加载前不误报不足，资格恢复完成前不发新请求，禁用浏览器存储时阻止无法恢复的操作。使用真实本地链签名和转币，不伪造成功状态。

Windows 入口独立安装 bin/windows-sale 依赖，处理 Anvil POSIX postinstall 和 PowerShell UTF8 BOM 兼容；本轮原生启动成功。早期 backend 目录同步、恢复进程死锁及静态路径回归已修复；Windows 文件级同步仍不等价于 Unix 目录 fsync。

## 本轮实际结果

- 原生 Windows 全 Go 测试和 go vet 通过。
- WSL Linux 全包 race 通过。
- SQLite 发售组件、真实响应 OpenAPI 契约、坏消息隔离通过；PG 适配同一组测试通过，SQLite 文件重开项明确跳过。
- 真实 RabbitMQ 发布确认、persistent、未 ack 重投、连接重建和死信通过。
- 合约编译通过；Settlement 和 FlashSale 两组真实 Anvil 测试通过。
- 前端 46 个单元用例、三个生成契约一致性、格式、类型与生产构建通过。
- SQLite 与 PG/Redis/RabbitMQ 两种独立链集成：真实购买、精确币差、重复/权限、硬杀恢复、链停止时拒绝新准入且不按本地时间回收、确认过期后回收、深重组持久冻结；稳定锚点对账差异为零。
- 浏览器验证桌面/390px、刷新恢复、购买成功、售罄按钮；一键完整环境进一步验证 A 发售购买后卖出、B 买入，两张二级订单 FILLED。
- 原二级市场完整 RabbitMQ/PG/Redis 模拟验证通过：pending/finalized、守恒、重试、撤单、分页/索引/对账、广播硬杀复用原 raw/hash/nonce、浅/深重组。
- npm 依赖审计初次发现问题，更新 Vite、minimatch override 和 follow-redirects；复查无已知漏洞。不是独立安全审计。

证据保存在 [evidence-sale-v0.6](evidence-sale-v0.6/)。passed 标识、日志、实际交易 hash、截图和失败 fixture 单独保存；没有新容量结论。

## 开发中发现并修复的问题

| 问题 | 修复与证明 |
| --- | --- |
| 本地 signer key 长度错误 | 使用固定公开测试字符串导出的 32 字节 key；合约/Go 跨语言签名和真实购买通过 |
| 既有资格重试绕过请求键 | 重试也走事务校验，跨活动同键返回冲突；集成保留断言 |
| 坏消息 JSON 部分解码后 dataset 正确导致永久重试 | 统一 receiveRecord 分类；永久错隔离，SQL 错重试；单测证明 |
| Expire 锚点只检查 hash | 同时验证持久块 timestamp，禁止伪造时间回收 |
| PG 测试共享游标/数据 | 每个组件用例独立随机 schema，测试后仅清自己 schema |
| Store.Open 错误路径先关 DB 后回滚 | 先 rollback 再 Close，避免等待未释放连接 |
| 重组测试回退后使用缓存高度 | 直接 eth_blockNumber 填到原确认水位；初次失败证据保留 |
| 原交易集成 Windows 启动无 exe 后缀 | 按平台构建/启动同一真实路径；完整回归通过 |
| Windows PowerShell 中文尾部乱码吞行 | 新入口保存 UTF8 BOM，原生脚本验证 |
| WSL 空闲后关闭 Docker | 本轮脚本维持自己的 WSL 保活子进程，退出只清自身 |

## 交付边界

已交付本地手动验收和可复现自动化，不宣称生产发布。公共测试网/云、真实扩展、合约审计、长期容量、硬件断电、生产多节点 RabbitMQ、自动 HA、备份整体恢复、owner 运营 UI、密钥轮换和 EIP1271 仍未覆盖。

默认演示 SQLite 与完整 PG 模式清楚区分。现有二级市场本金来自钱包，发售 seller 库存预存属于新增保管边界；每钱包不等于每人，确认深度不等于所有链的协议 finalized。历史 Kafka 成绩不重命名成 RabbitMQ 成绩。
