# 04｜第一次把项目跑起来

前一站：[资产和签名](03-assets-signatures.md) · 下一站：[一次购买的内部过程](05-sale-walkthrough.md)

## 1. 今天先达到一个小目标

先使用默认 SQLite 本地模式：A 买到一份、余额按预期变化、刷新后还能看到结果。第二轮再加入 PG/Redis/RabbitMQ。两种模式都运行真实本地 EVM，区别在链下存储与任务运输，不是一个真买一个假买。

详细操作和最终预期以[发售手动验收](../04-testing/sale-acceptance.md)为准。本章是解释版入口，所有命令都在项目根目录运行，不在本章所在的 docs 文件夹运行。

## 2. 准备工具

需要 Windows、PowerShell、Go 1.26.9+、Node.js 22.22+、npm 和浏览器，首次启动需要网络下载依赖。先在终端检查：

```powershell
Set-Location -LiteralPath 'D:\codex小项目\go\web3'
go version
node --version
npm.cmd --version
```

项目依赖以 `go.mod`、两份 `package-lock.json` 和启动器固定配置为准。不要为了跟教程逐字相同而把依赖手动换成网上最新版本；也不要直接改全局 Go/npm 设置来掩盖单次网络问题。

## 3. 启动默认模式

双击根目录 `run-sale-windows.cmd`，或者：

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

看到下载、编译或安装日志是正常的。启动器会准备独立 Windows npm 目录、编译前后端和合约、启动 Anvil、部署代币与两个业务合约、准备活动、启动 Go 服务，等就绪后打开浏览器。首次启动比后续构建慢。

不要在启动中关闭终端。终端是本次演示的控制台，Ctrl+C 用来停止本次脚本创建的进程。脚本不按端口强杀别人已有的服务。

| 地址 | 你可以观察什么 |
| --- | --- |
| `http://127.0.0.1:8082/?mode=sale` | 活动、钱包、资格和购买 |
| `http://127.0.0.1:8081/?mode=web3` | 同链二级市场 |
| `http://127.0.0.1:8545` | JSON-RPC，不是普通网页 |
| `http://127.0.0.1:8082/health/ready` | 新资格准入是否就绪 |
| `http://127.0.0.1:9092/check` | 发售只读对账 |

## 4. 用 A 完成一份购买

1. 选演示钱包 A，选择“限量首发”，先确认页面连接的是本轮本地配置。
2. 点“连接并登录”：钱包签登录文本，网站创建会话，余额还不会因登录改变。
3. 点“领取购买资格”：可领取从 10 变 9，待支付变 1，等待签名凭证就绪。
4. 点“授权支付 1 份”：给 FlashSale 使用 MUSDT 的额度，等待授权交易入块。
5. 点“确认链上购买”：钱包发送 purchase，页面显示交易 hash 并继续等待。
6. 看到确认成功后核对：MWETH 增 0.0001，MUSDT 减 1，测试 ETH 另有 Gas 消耗；待支付归零，已成交为 1。
7. 刷新当前页面，应恢复钱包/原资格/结果，而不是给同钱包再发一份。

如果余额原来是 X MWETH 和 Y MUSDT，则成功后是 X+0.0001 和 Y−1。测试 fixture 初始余额不是你投入了真钱，不需要买主网币来完成本实验。

## 5. 看一次 JSON-RPC 查询

不需要先安装新工具。另开 PowerShell，在服务仍运行时：

```powershell
$rpcBody = '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:8545' -ContentType 'application/json' -Body $rpcBody
Invoke-RestMethod -Uri 'http://127.0.0.1:9092/check'
```

`eth_chainId` 返回十六进制 `0x7a69`，对应十进制 31337。`/check` 的稳定结果应没有 differences；刚广播时可能仍有异步滞后，先等待服务追上，不要为了看到空数组而删数据。

也可以打开浏览器开发者工具的 Network，观察 `/api/web3/` 请求：登录、资格查询、交易 hash 上报是不同接口。只观察，不在控制台粘贴未知脚本。

## 6. 再体验二级市场

A 购买成功后点“去交易台挂单”。卖出价格填 10000、数量填 0.0001，签名限价卖单。再开 B 的交易标签，输入同价同量买单，等待结算任务与链确认。

两边最终看到 FILLED，任务 CONFIRMED，说明购买得到的测试资产已经通过二级市场再次交换。这个环节包含订单签名、Go 撮合和 relayer 结算，和发售购买的直接调用路径不同。完整步骤见验收手册第 3 节。

## 7. 再切到完整中间件模式

先 Ctrl+C 停止上一轮，再启动 Docker Desktop 或可用的 WSL Docker：

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

如果 Docker 在 WSL Ubuntu 内，先按自己的实际发行版设置：

```powershell
$env:SALE_DOCKER_WSL='Ubuntu-22.04'
powershell -ExecutionPolicy Bypass -File .\scripts\run-sale-windows.ps1 -Middleware
```

页面底部应明确显示 PostgreSQL、Redis、RabbitMQ。运行前确认自己有该 WSL 发行版；不要原样假定每台机器都叫 Ubuntu-22.04。完整模式配置失败会报错，不会悄悄回退成本地模式。

## 8. 刷新和重启是两件事

刷新页面只是重新读取同一轮状态。完整重启脚本会创建新 Anvil、新数据库和新 dataset。终端显示本轮 `bin/sale-dev/<时间戳>/`，最近一轮位置记录在 `bin/sale-dev/latest.json`；旧目录保留用于排查，不能用旧凭证连接新链。

## 9. 完成本章的验收标准

你能亲眼核对 A 的购买前后币差、SQL 库存等式、刷新恢复和只读对账；也能说出授权交易与购买交易的区别。此时再读下一章，就能把页面动作对应到后端和合约。
