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