# v0.3 当前架构完成与验证报告

历史记录：下方结果与产物属于当时执行，不因后续源码注释/修复而自动更新。最新正确性与故障收集更正见[测试完善报告](2026-10-11-test-hardening.md)，当前文档一致性见[文档审阅报告](2026-10-11-documentation.md)。原始证据保留，不改写历史成绩。

日期：2026-10-11。用户授权连续开发直到目前架构完成，本轮以既有 P1–P7 为验收范围。单市场/单实例模拟交易，LMAX 单写者核心保持；P8 快照/Redis/分区、高可用与真实链上资产保持独立扩展。设计见[v0.3](../07-history/v0.3-design.md)，当前完成矩阵见[开发计划](../00-overview/development-plan.md)。没有 Git 仓库，不编造提交号。

后续测试更正：上一轮 `crash_windows_test.go` 的 GOOS 文件名使 Linux 未收集精确六窗口用例。本报告原先把该组当作已执行不准确；当时仅普通 crash_check SIGKILL 等已实际运行。本轮改名为 crash_recovery_test.go 后六窗口已实测通过，并修复响应/幂等记忆/投影副本问题，最新证据见[测试完善报告](2026-10-11-test-hardening.md)。下文旧容量、容器、发布包与漏洞证据均保留为上一轮历史版本，不能代替包含本轮修复的成绩。

## 1. 本版完成内容

- 完整用户/认证与资金审计分页，前端各自翻页；资金结果明确拒绝/重复确认，新增可重建 credit_audit。公共盘口与成交历史路由落地，多笔同 seq 成交分页不遗漏。
- 运行与恢复有界批投影：整批 FULL 原子事务，提交后释放额度；恢复跳过已投影前缀、补落后部分。旧 schema=0/新 schema=1 业务摘要兼容，seq/hash/未知格式拒绝启动。
- 独立回环 metrics/标准 pprof、固定标签/数量与阶段计时；核心不读时钟/IO。资源预算配置校验、外围 JSON slog、WS 主动关闭与业务排空。
- exchangectl init-admin/check/backup/restore/rebuild-views：同一目录锁，独立重放逐表对账，checkpoint/manifest/SHA256/fsync，恢复到新目录；保留坏投影，权威数据不删改。
- 精确崩溃窗口/事务回滚/过载/取消等待/守恒/权限/容量与恢复基线；verify/E2E/container/load/release 脚本、CI 文件与可校验发布包。
- 新代码充分中文注释，更新目标/架构/规范/测试/云与容器部署/过程/阅读指南/51 问 QA/精简稿。Go 生成路由与目录拆分按当前 ADR 保留手写/紧凑包，通过静态依赖和契约测试保障边界。

## 2. 验证结果与原始证据

| 检查 | 实际结果 / 证据 |
| --- | --- |
| 格式、go mod verify、vet、完整测试、race | 最终 verify 脚本通过，[原始输出](evidence-v0.3/verify-final.txt) |
| OpenAPI 真实响应 / TS 生成一致性 / build / format | 通过，含新增分页/公共路由；verify 输出可复核 |
| 精确 SIGKILL R01–R06 | 更正：上一轮 Linux 未收集，不能由 verify-final 证明；本轮改名后六窗口实际通过，见测试完善报告 |
| 事务/背压/退出 | 单条/批内第二条投影失败全回滚；容量拒绝无日志；取消等待不释放可靠额度；WS 关闭/序号耗尽受控 |
| 对账/恢复/损坏 | 本地 backup/restore 保留会话/订单/余额/原键；manifest 坏字节拒绝；权威坏库/未知 schema/hash/缺口/超前投影拒绝；坏 views 保留重建 |
| 领域/随机序列 | 固定 seed 混合命令逐步检查资金/冻结守恒，1025 match 无部分效果，2^53 后 ID 字符串 |
| 浏览器 | 最终 8 passed，20.1s，含 runner 时间非性能成绩；[输出](evidence-v0.3/browser-final.txt) |
| 最终运行镜像 | 非 root/只读/真实静态页/嵌入契约、重启、在线维护锁拒绝、停机备份恢复到新目录、会话/资金/幂等均通过；[输出](evidence-v0.3/container-final.txt)、[资源与 manifest](evidence-v0.3/container.json) |
| npm audit | 最终 0 vulnerabilities，[输出](evidence-v0.3/npm-audit-final.txt) |
| govulncheck | 可达漏洞 0、导入 package 漏洞 0；1 个 required module 漏洞无调用路径，未假称所有模块零漏洞；[输出](evidence-v0.3/govulncheck.txt) |
| 发布包 | v0.3.0 后端/工具/前端/部署/build-info/SHA256SUMS 打包成功并逐文件核验；[输出](evidence-v0.3/release-final.txt) |

金额 fuzz 以 2 workers 实际运行 3s，24754 次执行通过，另见 [fuzz](evidence-v0.3/fuzz.txt)；不以 fuzz 目标文件存在当成绩。最终 19 份 Markdown 本地链接/代码围栏、26 个 Go 文件格式及 shell/Python 语法检查通过；Compose config 解析和发布包 SHA256SUMS 全部通过。断电、真实磁盘满/fsync 硬件故障、云实机和远程 GitHub CI 未执行，不能由模拟错误/SIGKILL 或 workflow 文件存在替代。

## 3. 环境与实验方法

环境为 Linux WSL2 6.6.87.2 amd64、AMD Ryzen AI 7 H 350，16 逻辑 CPU、约 15GiB WSL 可见内存。源代码 /mnt/d，性能数据目录 Linux /tmp（ext4 虚拟盘）；不是裸机 SSD。默认 GOMAXPROCS=16，当前 Go 1.26.9、Node 22.22.3、SQLite driver v1.60.1（运行内嵌 3.53.4）、decimal1.4.0/GoDS1.18.1。环境原始信息见[environment](evidence-v0.3/environment.json)。

最终核心/日志/恢复实验顺序执行；Go 1.26.0 初轮探索输出与补丁升级后的最终输出分开。最终数据引用 bench-final-* 和 load-go.json，不混用探索阶段数字。短时实验不设不稳定墙钟阈值作为所有 CI 测试门槛。

## 4. 分层性能

### 4.1 核心与日志

最终 [核心/日志原始输出](evidence-v0.3/bench-final-core.txt)，300ms 每个子基准：

| 基准 | 实际耗时 | 分配 | 定义/边界 |
| --- | --- | --- | --- |
| CoreDedupe | 76.95ns/op | 31B / 2 alloc | 既有键确认，无 JSON/hash/网络/存储 |
| CorePlaceCancel | 3977ns/op | 4511B / 135 alloc | 一次下单+一次撤单；每 256 对重置核心，输入预置 |
| CoreMatchPair | 9398ns/op | 10080B / 302 alloc | maker 下单+taker 完整成交，不是单命令 TPS |
| Journal FULL batch1 | 2.581ms/批 | 978B / 15 alloc | 已编码输入，仅 SQLite commit |
| Journal FULL batch16 | 2.721ms/批 | 3688B / 148 alloc | 没有额外 1ms 聚批等待 |
| Journal FULL batch64 | 2.891ms/批 | 13701B / 580 alloc | 不含核心/投影/HTTP，不能直接视为完整吞吐 |

纯核心耗时不是可靠 HTTP 容量。decimal/对象副本分配明显，先记录证据，不未经需要替换金额模型或加入对象池。日志批提交摊销同步写但没有取消耐久屏障。

### 4.2 开放到达率真实 HTTP

Go net/http 固定 128 工作者、客户端积压最多 256，延迟从计划到达至响应结束，含客户端排队；每档 5 秒。90% 新 LIMIT GTC 小额不交叉买挂单（0.01×0.0001）、10% 同一已成功键确认。低价减少前序成交干扰，**该负载不是多笔跨档撮合/真实生产混合业务**。发生器和服务同机、同一持续增长历史，未同时跑其他压力实验。

| 计划请求/秒 | 实际完成 2xx/秒 | p50 ms | p95 ms | p99 ms | 客户端丢弃 | 服务拒绝/网络失败 |
| --- | --- | --- | --- | --- | --- | --- |
| 100 | 100.09 | 5.14 | 5.91 | 6.55 | 0 | 0 |
| 500 | 499.23 | 8.61 | 11.88 | 16.12 | 0 | 0 |
| 1000 | 998.94 | 8.54 | 12.20 | 16.56 | 0 | 0 |
| 2000 | 1996.35 | 8.98 | 13.74 | 17.15 | 0 | 0 |
| 4000 | 3991.72 | 10.08 | 16.96 | 29.18 | 0 | 0 |
| 8000 | 7545.48 | 43.68 | 55.10 | 59.64 | 1914 | 0 |

100–4000 档无丢弃/拒绝，4000 档约 3992 完成请求/秒，其中 90% 为新挂单，不能把所有请求叫新订单/成交。8000 档 1914/40000 计划请求因客户端积压被丢弃；约 7545 完成/秒不满足全接收条件，也不是最大服务容量证明。客户端丢弃请求没有网络/服务处理，不把这部分遗漏当作低延迟成功。

最终累计创建 68475 单，冻结 USDT 精确 0.068475，available+frozen 保持 100000；全部订单遍历无重复，投影追上水位、服务 SIGTERM 退出 0。最大采样堆约 154MB（HeapAlloc 采样，不是进程 RSS/峰值保证），活动订单/去重随历史增长。完整各档状态、计数/水位/堆与对账见[load-go.json](evidence-v0.3/load-go.json)。

Python 初轮 100–1000 档通过，高档发生器大量丢弃，说明工具也是瓶颈；原始 [load.json](evidence-v0.3/load.json)、[stress](evidence-v0.3/load-stress.json)保留，但不用 Python 高档推断服务上限。Go 发生器替代后保留同一计划至完成统计和有界预算，未偷偷扩大成无限客户端队列。

### 4.3 恢复

最终 [恢复原始输出](evidence-v0.3/bench-final-replay.txt) 每个样本 1 次：

| 历史 | 时间 | 分配总字节（非峰值） | 条件 |
| --- | --- | --- | --- |
| 10000 同键 CREDIT 确认 | 48.62ms | 16.38MB | 既有完整投影，核心从头重建，热 OS 缓存 |
| 100000 同键 CREDIT 确认 | 307.20ms | 154.74MB | 业务/去重状态固定，不代表10万新单 |
| 100000 交易命令 | 1125.33ms | 737.45MB | 2 次资金命令+49999 maker/taker 对，真实成交/终态/去重增长；已有完整投影，热 OS 缓存 |

本版选定的 10万命令热缓存恢复目标 <30s 通过；这不包括冷 OS 缓存、启动 quick_check、缺失投影全量重建及所有负载，也不是“任何10万命令都1秒”。可复现重建 CLI 验证正确性，但没有把其全量成本混成已投影恢复数据。

## 5. 发现的问题与修复

1. Go 1.26.0 标准库扫描有 30 个可达漏洞（[升级前](evidence-v0.3/govulncheck-before.txt)），最高修复版本 1.26.9。升级工具链、Docker/CI、x/crypto0.58.0/sys0.49.0 后回归通过。扫描工具旧版构建工具链选择错误/依赖变更中途缺 sum，修正使用明确 Go1.26.9 和固定 x/vuln1.9.0，依赖变更结束后重跑；最新结果上述可复核。
2. 启动重放旧实现只按 payload，未检查表 seq/摘要/未知 schema；补检查与受控错误恢复，坏 journal 保留不跳过。新 schema 不改变业务摘要，旧键升级重试不冲突。
3. 逐条投影事务和恢复对已投影前缀做 SQL 会放大成本；有界批事务、前缀跳过、迁移成功标记，测试整批失败回滚，FULL 不变。
4. 管理页分页后管理员可在历史页，注资恢复测试原先假设首屏有管理员。改为真实翻用户页，再选择目标；页面仍允许确认已保存的原内容。
5. 首轮分页测试以 innerText 与 textContent 空白差异错误比较；改比单个邮箱单元格。Chromium offline 开关没有实际关闭已有 WS，改捕获/关闭真实 socket 并核对新 socket 数量与连接状态，不冒称全网断网。
6. 首轮容器用了自动 HostPort，Docker restart 重新分配端口导致客户端继续访问旧地址；改随机选择后固定映射端口，再验证完整恢复通过。原失败不是应用耐久丢失。
7. 发布脚本 `go list -m all` 为不参与构建的测试工具依赖请求默认代理超时；改用 `go version -m` 记录实际构建依赖，staging 完成后才发布，保留首轮未完成目录、不覆盖用户产物。
8. 收尾 Compose config 检查发现编辑替换误改了环境变量插值，修正为合法单一 CookieSecure 配置。重新解析通过；release 在构建前增加 Compose 校验，重新打包并核验 SHA256SUMS，旧未修正包保留但不作为交付包。
9. HTTP Shutdown 不关闭已升级 socket，补显式 WS 生命周期关闭/额度回收测试；先停止业务受理并排空，再结束 HTTP，避免退出期间持续新业务。

## 6. 发布与复现

发布包：[exchange-v0.3.0.tar.gz](../../bin/releases/exchange-v0.3.0.tar.gz)，build-info 的 git_commit 为 null，未伪造提交。SHA256SUMS 覆盖后端/离线工具/前端/部署/构建元信息，验证通过。临时服务/测试目录由脚本清理；容器/命名卷保留为已停止资源供复查。

最终容器 `web3-v03-1791708380693051394`，卷 `web3-v03-data-1791708380693051394`，镜像 `exchange-demo:v0.3-verified`（image ID `sha256:be5abaffbae97c280fede9585d215844990dbbf143634702dd27ddbd0a9d63da`）；根目录和恢复目录都保留在该验证卷。未修改其他容器/用户 Docker daemon。

```bash
bash scripts/verify.sh
GOTOOLCHAIN=go1.26.9 go run golang.org/x/vuln/cmd/govulncheck@v1.9.0 ./...
npm --prefix frontend audit --audit-level=high
python3 scripts/e2e_check.py
python3 scripts/container_check.py
go test -run '^$' -bench 'BenchmarkCore|BenchmarkJournal' -benchmem -benchtime=300ms ./backend
go test -run '^$' -bench 'BenchmarkReplay' -benchmem -benchtime=1x ./backend
CGO_ENABLED=0 go build -trimpath -o bin/loadcheck ./cmd/loadcheck
python3 scripts/load_check.py --driver go --rates 100,500,1000,2000,4000,8000 --seconds 5 --output /tmp/exchange-load.json
bash scripts/release.sh
```

release 拒绝覆盖既有版本目录，重跑先选择新的独立产物目录或保留前次版本。维护操作/云主机/容器步骤见[部署手册](../05-deployment/deployment.md)。

## 7. 完成边界

当前模拟单市场架构 P1–P7 实现、本地正确性/故障/性能/浏览器/运行镜像与离线运维已完成。标准 Dockerfile 在线构建仍因用户配置镜像源 `docker.mirrors.ustc.edu.cn` DNS 失败，[输出](evidence-v0.3/docker-online.txt)；未改 daemon 或将此失败算通过。真实云服务器/域名/安全组/证书未提供，未执行云部署；GitHub workflow 尚未远程执行。

真实断电、磁盘满/fsync硬件失败、长时间生产混合压力/冷缓存恢复、邮箱验证/密码找回/MFA、真实资金/多市场、高可用/防双主、在线一致备份、日志截断/有界去重未实现或验证。P8 快照/Redis/分区仍是依据需求和 profiling 决定的下一阶段，不属于本轮已实现宣称。sessionStorage 仍只保证同标签刷新，完整备份恢复 ID 不能补回备份后历史。
