# 首版开发验证记录

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

日期：2026-10-10，注释与容器复核收尾：2026-10-11。环境：Linux/WSL amd64，Go 自动工具链 1.26.0，Node 22.22.3，Vite 6.4.4，Playwright 1.64.0，Docker 29.5.0；SQLite 驱动 modernc.org/sqlite v1.60.1，SELECT sqlite_version() 实际为 3.53.4。源码工作区在 /mnt/d，崩溃/浏览器数据目录使用 /tmp。

## 已实现范围

普通用户注册/登录/退出，服务端会话/CSRF，管理员初始化、用户启用/停用、模拟资金增加与操作记录；单市场限价 GTC/IOC、市价保护 IOC、撤单、decimal 金额、红黑树/FIFO、资金冻结结算、单 goroutine 核心、外围日志批提交/投影/重放、实时共享行情快照。前端实际调用后端，没有 mock 成交。充分注释要求写入 goal.md/开发规范并补齐后端、前端、测试、脚本和部署说明，增加[代码阅读指南](../03-development/code-reading-guide.md)。

## 实际执行

| 检查 | 结果 |
| --- | --- |
| go test ./... | 通过；包含核心场景与存储/认证集成测试 |
| go test -race ./... | 通过，未报告数据竞争 |
| go vet ./... | 通过 |
| npm --prefix frontend run build | TypeScript + Vite 生产构建通过 |
| npm --prefix frontend run format:check | 通过，全部前端源码/测试/配置使用 Prettier 3.5.3 格式 |
| npm audit | 升级 Vite/Playwright 后 0 vulnerabilities |
| Playwright 真实后端联调 | 通过：两个注册用户、成交、撤余量、管理员登录/注资/停用用户、会话失效 |
| 移动端/动画 | 375px 无页面横向溢出；reduced-motion 可访问；无 pageerror；截图已检查 |
| scripts/crash_check.py | 通过：真实进程 SIGKILL/restart 后身份/会话/订单/余额/幂等保持；SIGTERM 正常退出 |
| 投影重建 | 集成测试通过：删除 views 后从 journal 重建余额/订单与去重状态 |
| 日志失败屏障 | 集成测试通过：日志不可写时核心不产生资金效果并进入失败状态 |
| 数据目录唯一写者 | 第二实例被拒绝 |
| Docker runtime 镜像 | 最新本地静态产物构建、USER 10001、只读 rootfs + 持久卷启动和健康检查通过 |
| 容器真实联调 | E2E_URL=18081 执行同一双用户/管理员浏览器场景，通过（1 test，13.3s 含启动） |
| 容器持久性 | 同卷重建容器 + docker restart；独立用户会话、单次订单、余额、幂等一致；只读 rootfs/UID/卷检查通过 |
| 未知版本启动拒绝 | 未知 engine_version 正常返回 error，两次重开均释放连接和锁，无清理 panic |
| 注释/Markdown | 15 个 Markdown 的本地链接及代码围栏配对通过；Go 类型/函数和主要 TS 组件补说明 |
| Compose 配置 | config --quiet 语法/环境校验通过 |

## 遇到的问题和修复

1. 默认 Go module proxy 超时：改用可访问镜像完成下载，未关闭 module 校验；驱动升级要求 Go 1.26，使用自动匹配工具链。服务启动读取 SQLite 版本并拒绝未包含要求 WAL 修复的版本。
2. 行情初版扫描全部活动订单：改为投影事务内维护聚合 levels，以 ticks 有序读取前 20 档；多个 WS 复用一个采样快照。
3. 核心初版幂等摘要包含 JSON 编码：将规范化摘要计算移到外围，日志保存摘要，恢复由外围兼容补齐；核心只比较摘要和更新状态。
4. Playwright 暴露 label 的单位/option 文字影响可访问名称：加入准确 aria-label 后完整联调通过。
5. npm 审计发现初选 Vite/Playwright 旧版本问题：升级固定版本后审计为零。
6. 标准多阶段 Docker 构建失败：主机配置的 docker.mirrors.ustc.edu.cn 无法解析。未修改用户 Docker daemon；提供 Dockerfile.runtime 使用已验证本地产物，单独验证容器运行。标准 Dockerfile 的在线构建尚未成功验证。
7. 注释梳理发现 OpenStore 具名返回值清理缺陷：return nil, err 令 s 变 nil，旧 defer 再访问会 panic。改为捕获已打开实例，加入真实未知版本拒绝及重复开锁验证。
8. 前端异步刷新可能发生旧身份/旧请求晚到覆盖：加入会话引用与查询 generation 校验，轮询沿用最大已知 processed_seq；初始 HTTP 行情与 WS 都只接受不倒退水位，StrictMode 启动 effect 清理旧回调。私有组件按账号 key 重建，避免待确认请求跨身份复用。
9. 核心最优价缓存替代每次树取极值；在现有每命令不变量中增加缓存与树极值一致断言。没有执行容量 benchmark，不能将算法改进称为吞吐实测。

## 复核命令与环境

```bash
go test ./...
go test -race ./...
go vet ./...
npm --prefix frontend run build
npm --prefix frontend run format:check
# 以下在 frontend 目录执行
npm audit
E2E_URL=http://127.0.0.1:18080 npm run test:e2e
E2E_URL=http://127.0.0.1:18081 npm run test:e2e
# 回到根目录
CGO_ENABLED=0 go build -trimpath -o bin/exchange ./cmd/server
python3 scripts/crash_check.py
docker build -f Dockerfile.runtime -t exchange-demo:verified .
docker compose -f deploy/compose.yaml config --quiet
```

本地浏览器使用 /tmp/web3-development-e2e；容器为 web3-exchange-validation，端口 18081，独立命名卷 web3-exchange-validation-data，明确测试管理员。两次浏览器结果均 1 passed（本地 13.8s、容器 13.3s，包含 runner 时间）；纯测试场景分别 11.3s/11.0s，不是吞吐成绩。容器重启核验由 Python CookieJar 保持同一会话，创建挂单后记录余额，重启后以原键确认同单/余额不变，并取消自己的测试挂单。资源检查用 docker inspect 与 /app/exchange health。

停止自己启动的本地测试进程及验证容器，保留 /tmp 测试数据与 Docker volume 供复查；无云资源、无 Git 提交，报告不伪造部署实例或 hash。

## 未执行与边界

未做完整容量压测/长时运行/真实断电、全部 failpoint 矩阵、云服务器实机部署、完整升级回滚演练、在线备份 CLI、生成客户端一致性。Dockerfile 基础镜像尚未锁 digest。未知请求目前仅前端组件内存保留，刷新/卸载后无法恢复；未验证数据集重置的行情 epoch。当前 INPUT/去重历史持续增长，查询列表有固定上限，只有 ETH-USDT，非生产交易系统。

截图路径（本地生成，未版本化）：playwright-results/terminal.png、admin.png、mobile.png。后续报告记录代码提交；当前目录尚未初始化 Git，不能编造提交 hash。
