Web3 交易系统
报告与验证记录

2026-11-02:开发进度复核与限量发售架构更新

本轮按用户要求分析当前目录中的 Web3 开发进度与文档,并根据已有实现继续丰富架构。交付为文档和核验记录,运行基线仍是模拟 v0.3 / 链模式 v0.5;没有实现秒杀业务、修改合约、发布镜像或进行公共链部署。

1. 核对范围与主要结论#

阅读 backend、chaintrade、cmd/web3server、Settlement、前端入口/钱包/历史模块、OpenAPI、依赖配置以及 v0.5 设计和历史报告。当前目录不是 Git 仓库,因此不编造 commit 或 diff;使用源码摘要比较记录本轮业务源码是否变化。

已实现的主线包括钱包 EIP-712 限价订单、单写者订单簿、FULL 输入日志、投影/outbox、可选 Redis/Kafka/PG、原签交易持久化、合约原子结算、任务迁移/CAS、完整历史、已确认事件索引、只读对账和基础观测。当前没有发售业务包、资格库存 API、购买凭证、FlashSale 或活动页面。

发现并修正文档问题:

  • 生产架构第 2 节仍把历史分页、任务版本/迁移、事件索引与对账列为未完成,已改为当前状态和剩余差距。
  • 根 README 将 Redis 统称为后续扩展,已区分模拟模式未接入与链模式已实现。
  • 文档入口优先展示旧模拟进度,已补当前进度、运行架构、新设计与本轮报告入口。
  • 模拟架构的文档修订号 0.6 容易被看成新业务版本,已明确与应用版本区分。
  • “钱包连接/订单签名”和钱包登录会话不同;当前无 SIWE 绑定能力,发售设计将其列为前置。
  • 当前索引器固定服务 Settlement;将来发售事件需要独立域与游标,不能直接宣称已有通用多合约索引。

2. 新增设计与取舍#

新增实际开发进度和限量发售设计。首版采用已有 MockWETH/MockUSDT 固定价限量购买,收取资产后进入二级市场;保留现有撮合日志和非预存钱包交易模型。

发售采用 Redis 准入、PG 库存资格/outbox 同事务、Kafka 与幂等签名任务、EIP-712 固定购买凭证、独立合约收款交付、发售索引与安全回收。不再额外引入 Redis Stream 或 MySQL。运营方预存库存、买方不预存平台余额的资产边界已明确。

设计覆盖钱包身份、活动/资格/凭证/交易观察状态、库存公式、唯一键/CAS、链上签名防重放、deadline 临界值、索引连续性、超时不得盲目释放、故障矩阵、接口/表草案、负载隔离与 S0–S4 验收。用户自行发送交易,因此首版不依赖平台代付或 Tx Manager 的 nonce 并发增强。

同步范围:根 README、goal、文档入口、总体架构、v0.5 设计、生产演进、后端 Web3 路线、开发记录、链开发/测试说明、Windows 与测试手册和面试短稿。历史 reports/evidence 保留原内容与日期;新增业务明确标为待实现。

3. 本轮实际检查#

证据位于独立目录 evidence-2026-11-02-architecture ↗,结果按实际执行区分通过、失败与未执行。

项目 本轮结果与证据
环境 Windows amd64;Go 1.26.9、Node v24.11.1、npm 11.6.2;未更改全局工具配置
前端已有单元测试 44/44 通过,见 frontend-unit.txt
Web3 类型契约一致性 通过,临时重生成与现有 TS 一致,见 web3-contract-check.txt
Go 首次完整命令 执行 go test -json -count=1 ./…,长时间停留在缺失依赖下载;停止本轮启动的 Go 子进程,未进入测试,见 下载记录
Go 离线检查 当前命令进程设置 GOPROXY=off,执行 go test -json -count=1 -timeout 120s ./…;顶层用例 70 通过、6 失败、1 helper 跳过;chaintrade/web3server setup 因缺依赖失败,见 原始记录与汇总
Windows 失败定向复跑 6 个顶层用例均重现失败,见 focused;不是新增发售用例
文档链接/围栏与业务源码摘要 当前文档检查通过,123 个业务/配置文件摘要一致,见 document-check.json、检查脚本

源码摘要覆盖业务 Go、API、前端源码/测试/配置、合约源码/脚本/测试、部署和项目工具等明确列举的文件;不包含 node_modules、运行数据或旧发布产物。它用于核对本轮改动范围,不能证明新架构已经实现或任何未运行测试已通过。

4. 本轮发现的现有问题#

场景与现象 证据入口 处理建议与结论边界
备份/重建目录同步返回 Access is denied TestRestoreRejectsMalformedManifestAndCleansDestination、TestOfflineBackupRestore、TestRebuildCorruptViews、CLIInitCheckBackupRestoreThroughPublicEntry backend/maintenance.go 的 syncDirectory 直接打开目录并 Sync,注释目标为 Linux;需明确 Windows 的实现与持久性协议,不能简单吞错误冒充同等保证
恢复中杀子进程返回 TerminateProcess: Access is denied TestCrashRecoveryWindows/during-recovery;父用例也失败 子进程精确窗口与 Windows 终止/退出行为需排查,不能据该错误认定资金恢复失败或窗口验证通过
缺失静态 JS 返回 HTML 200;路径含 ../ 返回 400,测试期待 404 TestStaticFilesAndSPAFallback 的两个子用例 核对 URL 与 filepath 的跨平台处理、ServeFile 行为和状态码约定;本轮未观察到读取 secret 内容,不能夸大为已确认文件泄漏
链包缺少 go-eth-kzg、otel、x/text、compress、lz4 等缓存依赖 go-offline.jsonl 的 build-output / build-fail 完成依赖下载后再跑链包;setup 未通过不等于链业务断言失败

共 6 个顶层失败来自 4 个备份/CLI 用例、1 个恢复窗口父用例、1 个静态资源父用例,不能把父子失败累加为 9 个独立缺陷。定向复跑采用相同 Go 工具链、GOPROXY=off、-count=1,仅选择这些用例,原始事件均保留。

上述问题在未改变业务源码的条件下暴露,本轮只记录、分析并更新进度,不将文档任务扩大为维护实现变更。建议作为后续代码修复的优先项,在新发售模块前先恢复清晰的平台回归基线。

5. 没有执行的内容#

本轮未重跑真实 Anvil / Redis / PG / Kafka / 浏览器 / 容器闭环,未重新测覆盖率、容量或漏洞,未验证新发售设计。既有这些结果引用 2026-10-12 v0.5 报告,不是本轮 Windows 实测。没有执行公共测试网、云部署或原生钱包扩展兼容测试。

下一步实施从 S0 冻结契约和钱包身份开始,按 S1 资格、S2 购买、S3 故障恢复、S4 性能与外部环境逐步留证。交易主线的 attempts/提价、坏消息治理和 HA 仍保留各自边界。

— 本篇阅读完毕 —
来源:Web3 交易系统 / docs / reports/2026-11-02-architecture-review.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭