# 当前开发进度（v0.6）

Web3 初学者先读[从零理解整个项目](../01-beginner/README.md)，内容目录见[分类入口](../README.md)。本页用于核对已实现范围，不替代逐步教学。

本轮已实现独立链上限量发售，并按用户要求将交易与发售的消息队列统一改为 RabbitMQ。模拟 v0.3 与既有链交易能力继续保留。操作入口见[手动验收](../04-testing/sale-acceptance.md)，测试范围见[测试说明](../04-testing/sale-testing.md)和[本轮记录](../reports/2026-11-02-sale-v0.6.md)。历史报告保留原版本和原始成绩。

## 已实现

| 能力 | 源码与边界 |
| --- | --- |
| 模拟账户、管理员、撮合、分页、维护 | backend/；模拟资金独立 |
| EIP712 订单与链上两币交换 | chaintrade/、Settlement.sol；单写者、FULL 日志、原交易持久化、任务 CAS |
| 链交易历史、事件与对账 | 保留 v0.5 索引/分页/指标；索引不重复结算资金 |
| 固定价 ERC20 发售 | FlashSale.sol；预存库存、固定条款、钱包限购、凭证一次使用、暂停、到期提取 |
| 钱包会话与私有资格 | flashsale/auth.go、http.go；一次性签名挑战、Cookie、Origin、CSRF、数据集隔离 |
| 库存资格事务 | flashsale/store.go；PG 或显式 SQLite；库存/资格/请求键/outbox 同提交 |
| RabbitMQ 分发 | messaging/；持久 quorum 队列、persistent、mandatory、发布确认、手动 ack、断线重连 |
| 持久消费与签名 | inbox/job 先于 ack；固定正文签名，过期资格不复活 |
| 安全过期回收 | 已确认块时间达到 deadline，同块 hash 的 consumed=false；RPC 故障不按本地计时释放 |
| 前端与演示钱包 | 分步操作、余额/库存/倒计时、刷新恢复、交易哈希、真实 Anvil 交易、移动端布局 |
| OpenAPI | api/sale-openapi.json，标准生成 TS 类型，实际 handler 响应契约测试 |
| 原生 Windows 修复 | 安全静态路径、崩溃测试暂停、目录同步适配；Windows 文件 Sync 不等价于 Unix 目录 fsync |

## 当前运行架构

```mermaid
flowchart TD
    U[钱包 / 发售页] --> A[saleserver :8082]
    A --> R[Redis 准入保护]
    A --> DB[PG / 本地 SQLite：库存、资格、outbox]
    DB --> MQ[RabbitMQ 发售队列]
    MQ --> W[签名 Worker：inbox/job 后 ack]
    W --> DB
    DB --> U
    U --> C[FlashSale：验签、收款、交付]
    C --> I[独立索引 / 安全回收]
    I --> DB
    U --> T[web3server :8081]
    T --> L[FULL 日志 / 单写者 / 投影 outbox]
    L --> MQ2[RabbitMQ 结算队列]
    MQ2 --> TASK[PG / SQLite：raw/hash/nonce]
    TASK --> S[Settlement：二级市场交换]
```

两个服务共用同一链上的 MWETH/MUSDT，各自拥有数据集、状态、连接预算和索引。发售库存不进入撮合 Engine。Redis 是入口预算，RabbitMQ 是传输；均不裁决库存或资金。

一键脚本准备三场活动：10 份首发、最后 1 份、20 秒过期回收演练。每份 0.0001 MWETH，支付 1 MUSDT；钱包 A/B 有本地测试 ETH 和测试币。常规资格 120 秒，确认深度 2。默认 SQLite 模式便于验收，-Middleware 启用 PG/Redis/RabbitMQ。

## 后续边界

公共测试网、云实机、真实钱包扩展兼容、独立合约安全审计、长时间容量测试、生产 RabbitMQ 多节点、自动 HA/fencing、快照、同 nonce 替换、完整运营后台仍未完成。每钱包限购不等于每人限购。

历史 Kafka 报告、证据和数据卷不作为 RabbitMQ 成绩，也不自动删除。旧 WEB3_KAFKA_* 已退出当前入口；恢复必须先核对旧 broker 未落库消息、outbox、任务和链。没有在线自动搬运旧 broker 消息的工具。
