# 发售测试与验收说明

手动步骤见[验收手册](sale-acceptance.md)，设计见[架构](../02-architecture/flash-sale-design.md)。本轮证据统一写入项目根目录下的 [docs/reports/evidence-sale-v0.6](../reports/evidence-sale-v0.6/)；历史 evidence-v0.5 和架构审阅报告不覆盖。

## 环境和层次

本轮使用原生 Windows Go 1.26.9、Node 24.11.1、Anvil 1.4.4、Solidity 0.8.37、Edge headless；race 使用 WSL Ubuntu Go 1.26.9。PG/Redis/RabbitMQ 通过 WSL Docker 启动，AMQP 使用 5672，管理台 15672。不是公共测试网，也不是 MetaMask 扩展兼容测试。

| 层次 | 入口与断言 |
| --- | --- |
| SQL 组件 | flashsale/store_test.go：40 钱包争 5 份、重复请求、正文冲突、库存守恒、事件回滚/游标、签名、过期/重开 |
| 权限 | 一次性登录/重放、Origin/CSRF、Cookie、钱包私有资格 |
| 契约 | contract_test.go：真实 handler 响应按 OpenAPI 校验，未领取 null、签发正文与 hash 上报 |
| 坏消息 | 格式错误即使 dataset 正确也持久隔离，不永久阻塞队列 |
| AMQP | messaging/rabbitmq_test.go：persistent/confirm、未 ack 重投、同适配器重连、Nack 死信 |
| 合约 | contracts/tests/flashsale.test.mjs：真实 EVM 验签/错误域、金额/买方、授权失败原子回滚、暂停、重放、钱包限购、deadline、提取 |
| 集成 | sale-check.mjs：登录 → SQL → outbox → 签名 → 真实 approve/purchase → 确认索引 → 精确资产差值 |
| 故障 | 硬杀重启、链不出块跨 deadline 不回收、恢复出块后安全回收、已确认深重组冻结 |
| 前端纯函数 | 46 个总用例，其中 2 个新增发售状态/错误用例 |
| 前端 E2E | 禁用存储仍可读且阻止写；桌面购买/刷新恢复、390px 无横向溢出、售罄按钮、截图 |
| 跨业务 UI | sale-trade.spec.ts：一键演示环境从购买跳转、A 卖出、B 买入、两单 FILLED |
| 既有链模式回归 | web3_check.mjs：RabbitMQ/PG/Redis 下成交/金额守恒、撤单、重复、恢复、历史/索引/对账、raw/hash/nonce 与重组 |

## 快速执行

已安装依赖后，从项目根目录运行：

```powershell
go test -count=1 ./...
go vet ./...
npm.cmd --prefix contracts run compile
npm.cmd --prefix contracts test
npm.cmd --prefix frontend run test:unit
npm.cmd --prefix frontend run sale:check
npm.cmd --prefix frontend run api:check
npm.cmd --prefix frontend run web3:check
npm.cmd --prefix frontend run format:check
npm.cmd --prefix frontend run build
# 独立随机端口、全新 Anvil 和 SQLite；包含真实浏览器
node scripts/sale-check.mjs --ui
```

Windows 浏览器测试默认使用已安装的 Edge。Linux/CI 设置 SALE_BROWSER_CHANNEL=chromium 并预先安装 Playwright Chromium。sale.spec.ts 需要 SALE_E2E=1；推荐通过 sale-check 自动建立独立服务，禁止指向现有用户数据直接消耗资格。

```powershell
# 完整中间件（WSL Docker 示例；Docker Desktop 不设置 SALE_DOCKER_WSL）
$env:SALE_DOCKER_WSL='Ubuntu-22.04'
node scripts/sale-middleware.mjs --up
node scripts/sale-check.mjs --middleware --ui

# PG 实现同一组真实事务用例：每用例建独立随机 schema，结束仅清本用例 schema
$env:SALE_TEST_POSTGRES_DSN='postgres://exchange:local-web3-password@127.0.0.1:15432/exchange?sslmode=disable'
go test -v -count=1 ./flashsale
Remove-Item Env:SALE_TEST_POSTGRES_DSN

# 真实 RabbitMQ 传输
$env:RABBITMQ_TEST_URL='amqp://exchange:local-web3-password@127.0.0.1:5672/'
go test -v -count=1 ./messaging

# Linux race（WSL 的 Go 需已安装依赖）
wsl -d Ubuntu-22.04 -- /usr/local/go/bin/go test -race ./...
```

PG suite 有一个明确跳过项：SQLite 文件重开 fixture；该项在默认 SQLite suite 执行。AMQP 和 chaintrade 真实中间件测试在没有环境变量时明确 Skip，不代表已执行。Go 常规测试不自动启动 Docker。

二级市场完整中间件回归：

```powershell
$env:WEB3_CHECK_POSTGRES_DSN = node --input-type=module -e "import {middlewareDatabase} from './scripts/sale-middleware.mjs'; console.log(await middlewareDatabase('trade_check'));"
$env:WEB3_CHECK_MIDDLEWARE='1'
$env:WEB3_CHECK_EVIDENCE_DIR='docs/reports/evidence-sale-v0.6/trade'
node scripts/web3_check.mjs
```

一键启动后，在本轮新建演示库验收购买后再交易：

```powershell
$env:SALE_LAUNCHER_E2E='1'
$env:SALE_EVIDENCE=(Join-Path $PWD 'docs/reports/evidence-sale-v0.6')
npm.cmd --prefix frontend run test:e2e -- sale-trade.spec.ts
```

该用例会使用演示钱包 A 的首发资格，完成后手动验收请重新整体启动一轮。全局浏览器 E2E 默认会 Skip 发售专项，避免意外操作其他测试环境。

## 结果判定与证据

| 证据 | 应看到 |
| --- | --- |
| go-windows-final.txt | 所有 Go 包通过；外部环境用例按配置 Skip |
| go-postgres-final.txt | PG 事务/权限/契约/隔离通过，SQLite 重开明确 Skip |
| go-race-linux.txt | 全包 race 通过 |
| rabbitmq-transport.txt | 真实 AMQP 传输测试通过 |
| chaintrade-middleware-final.txt | 二级交易真实 PG/Redis/RabbitMQ 的任务持久化、重试与去重通过 |
| contracts-final.txt / frontend-final.txt | 最终合约编译/测试、前端单元/契约/格式/构建日志 |
| windows-launcher-check.json | 一键完整模式两服务 ready=200、只读对账差异为空 |
| sale-local.json / sale-middleware.json | passed=true，所有检查与真实交易 hash；对账 differences=[] |
| sale-local-final.txt / sale-middleware-final.txt | 独立链、浏览器用例与集成结果 |
| sale-desktop.png / sale-mobile.png | 实际页面截图，不是设计稿 |
| sale-to-trade.png | 实际二级市场最终成交 |
| sale-to-trade-final.txt | 最终 Windows 一键完整环境跨业务 UI 用例通过 |
| trade/simulation-middleware-log.txt | 二级市场真实服务日志 |
| npm-audit-frontend.json / npm-audit-contracts.json | 本次查询时零已知漏洞；不保证未来或已做安全审计 |

集成脚本会新建随机端口和临时数据目录，日志保存 data_dir。完整模式新建独立 PG 数据库和数据集队列，测试结束只停自己的服务/链，不删除历史数据/队列/卷。长期运行前人工清理自己确认无须保留的测试数据库和空队列。

曾失败的重组 fixture 记录为 sale-local-initial-reorg-fixture-failure.json：原因是测试使用 ethers 缓存块高，回退链后未填到原游标；改为原始 eth_blockNumber 后验证持久冻结。初次 Windows 问题见 windows-regression.txt；最新状态看 final 文件。

## 尚未证明的内容

没有本轮长期容量/TPS/SLA、真实断电、公共链/云、生产 RabbitMQ 多节点故障、真实扩展钱包、备份整体恢复、安全审计成绩。Go race 常规执行不自动启用外部中间件；真实中间件另外跑功能集成。

Windows 目录同步适配只核验目录，文件仍各自 Sync，不能冒充 Unix 目录 fsync 的断电保证。符号链接测试 fixture 需要 Windows 开发者权限；无权限只完成其余 manifest 断言，Linux suite 覆盖符号链接拒绝。

npm 本轮修复 Vite 6.4.4（升级到 6.4.5）、minimatch（构建工具 override 11.0.1）和合约工具 follow-redirects 的审计问题，并重跑类型生成/编译/测试。具体锁文件是复现依据，不沿用历史“零漏洞”结论。
