# 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. 新增设计与取舍

新增[实际开发进度](../00-overview/current-progress.md)和[限量发售设计](../02-architecture/flash-sale-design.md)。首版采用已有 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](evidence-2026-11-02-architecture/)，结果按实际执行区分通过、失败与未执行。

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

源码摘要覆盖业务 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 报告](2026-10-12-v0.5.md)，不是本轮 Windows 实测。没有执行公共测试网、云部署或原生钱包扩展兼容测试。

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