# 发售系统手动验收

从项目根目录 D:\codex小项目\go\web3 操作。先用默认模式走通，再验收 PG/Redis/RabbitMQ。全部为本地测试资产。

## 1. 启动

安装 Go 1.26.9+、Node.js 22.22+（本轮 Node 24.11.1），第一次需要网络下载依赖。Windows 双击根目录 run-sale-windows.cmd，或者在 PowerShell 执行：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1
```

脚本在 bin/windows-sale/ 准备独立 Windows npm 依赖，编译合约、前端、后端，启动 Anvil，部署测试代币/Settlement/FlashSale，再启动两个服务；ready 后打开活动页。不会覆盖原目录的 Linux/WSL node_modules。

| 地址 | 用途 |
| --- | --- |
| http://127.0.0.1:8082/?mode=sale | 活动页 |
| http://127.0.0.1:8081/?mode=web3 | 二级交易台 |
| http://127.0.0.1:8545 | 本地 EVM RPC，chainId=31337 |
| http://127.0.0.1:9092/check | 发售只读对账，differences 应为空 |
| http://127.0.0.1:9092/metrics | 发售积压/索引指标 |
| http://127.0.0.1:8082/health/ready | HTTP 200 表示可分配新资格 |

终端会显示本轮数据目录 bin/sale-dev/<时间戳>/；latest.json 保存最近运行位置。停止使用 Ctrl+C，脚本只停止自己启动的进程。再次整体启动会新建链和数据库，旧目录保留，不能把旧资格用于新链。页面刷新恢复与“重建整条演示链”是不同操作。

## 2. 正常购买（建议首先验收）

1. 保持终端运行，打开活动页。底部默认显示 SQLite 本地演示 / 本地 outbox。
2. 在“操作钱包”选择“演示钱包 A”。不需要安装扩展，签名和转账仍连接真实 Anvil。
3. 选“限量首发”：10 份，每份 0.0001 MWETH，价格 1 MUSDT。
4. 点“连接并登录”。成功后主按钮变成“领取购买资格”。
5. 点领取。可领取从 10 变 9，待支付变 1；等待凭证签发，出现 2 分钟倒计时。
6. 点“授权支付 1 份”。等入块后按钮变“确认链上购买”。
7. 点购买。提交后显示交易 hash；等待本地出块和深度 2 确认，出现“购买成功，资产已到账”。
8. 资产余额增加 0.0001 MWETH，MUSDT 减少 1；待支付归零，已成交为 1。
9. 刷新页面，钱包、原资格与确认结果恢复。相同钱包本场不能再领一份。

钱包 A 通常地址 0x7099…79C8，钱包 B 为 0x3C44…93BC。首次余额来自 fixture 测试 mint。正常购买不通过模拟管理员 CREDIT。

## 3. 购买后进入二级市场

1. 在购买成功区域点“去交易台挂单”。链接保留 A/B 演示钱包选择。
2. 点交易台“连接钱包”，可看到刚才对应的钱包和测试资产。
3. 方向选“卖出”，价格填 10000，数量填 0.0001，点“签名限价单”；当前每 lot 1 MUSDT，因此这组输入对应单份售价 1 MUSDT。
4. 卖单出现 OPEN 且余量 0.0001。fixture 已授权 Settlement；发售授权与交易合约授权是两份独立 allowance。
5. 打开第二个标签页 http://127.0.0.1:8081/?mode=web3&demo=1 （如果卖方为 B，这里改 demo=0），连接钱包，方向买入，填写同样的价格/数量并签名。
6. 等待任务广播和链确认，两单最终成交，任务 CONFIRMED。历史区可查最终成交与链事件。

价格框表示每枚 MWETH 的 MUSDT 价格，数量框表示 MWETH 数量，和后台 tick/lot 不同。输入 1 和 1 会购买/出售 1 MWETH，不能把“1 份”直接填入这两个框。

## 4. 最后一份与重复操作

1. 回活动页，A 选“最后 1 份”，登录并领取，不购买。
2. 刷新或再点活动，仍是原资格；总量不下降第二次。
3. 切钱包 B，重新登录，选同一活动：可领取 0，待支付 1，领取按钮禁用。
4. A 的 120 秒资格过期且链核验后，B 可以再领。A 仍不能重复领取。

售罄提示表示资格暂时占满；未支付资格可能回收，不等于全部已经链上成交。

## 5. 20 秒过期回收

1. A 选“过期回收演练”，领取后不要授权或购买。
2. 倒计时结束时页面显示“有效期结束，正在核验”；不可立即认定库存已经释放。
3. 保持 Anvil 和服务运行，通常再等几个出块，显示“资格已过期”；可领取恢复 1，待支付恢复 0。
4. 切换 B、重新登录，领取同一活动成功。
5. 切回 A，原过期资格仍在，本钱包不能再领。

每钱包只能参加一次。若 A/B 都已领过该场，重新整体启动一轮演示，获得全新链和数据。不要手工删除数据库行重置资格。

## 6. 完整中间件模式（RabbitMQ）

需要运行中的 Docker Desktop，或 WSL Ubuntu 内的 Docker。默认开发密码仅用于本机；已有 PG/RabbitMQ 卷使用首次初始化的密码，改环境变量不会自动改旧卷密码。

```powershell
# Docker Desktop 可用时
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware

# 本机使用 WSL Docker 时，先在同一终端设置
$env:SALE_DOCKER_WSL='Ubuntu-22.04'
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware
```

先停止上一轮服务，释放 8545/8081/8082/9092。脚本等待 RabbitMQ 健康，创建新的 PG 数据库；WSL 模式保留自己的 Linux 保活子进程。页面底部应显示 PostgreSQL / Redis 已连接 / RabbitMQ 已连接。

重复第 2–5 节。RabbitMQ 管理台 http://127.0.0.1:15672 ，开发账户 exchange / local-web3-password；AMQP 端口 5672。Queues 中可看到 sales-<时间戳>.<dataset> 和对应 .dead 队列。正常完成后主队列 Ready/Unacked 归零；发售格式错误消息保存在 SQL 隔离表。

需要读到最终断言而不是只看绿色 UI 时，访问 /check：differences=[]，outbox_pending=0，sign_jobs_pending=0。确认活动库存等式 total=available+held+confirmed。

## 7. 常见问题

| 现象 | 检查与处理 |
| --- | --- |
| 启动端口被占用 | 停止上轮自己启动的演示；脚本拒绝借用不明已有 RPC |
| Go 下载超时 | 检查网络/工具链；脚本不修改全局代理设置 |
| Foundry 安装在 Windows 失败 | 本入口已禁用 POSIX postinstall，显式装固定 Windows Anvil 包；勿替换为普通 npm ci |
| 登录提示钱包不一致 | 选择正确 A/B 后重新登录；扩展切链/切账户也需重新登录 |
| 一直“恢复资格中” | 查看 8082 健康、刷新页面，确认不是旧数据集；不会在恢复完成前发新资格 |
| 资格到期但库存没回 | 检查确认索引与 RPC；不会用本地时钟强行释放 |
| RabbitMQ/PG 拒绝连接 | 确认 Docker/WSL 仍运行、端口映射和首次卷密码；不能默默改成本地模式 |
| Compose 提示旧 Kafka orphan | 旧卷/容器是历史数据，本入口不删除，当前服务使用 RabbitMQ |
| 页面显示暂停核查 | 深重组或索引矛盾已持久冻结；先保存证据并对账，不手工清 frozen |
| 想重新完整验收 | Ctrl+C 后再次启动；新链、新库、新 dataset，历史目录保留 |

自动验证命令、真实执行证据与尚未覆盖范围见[测试说明](sale-testing.md)。公共链、云和真实扩展钱包未作为本地验收前置。
