# 文档目录：按主题查阅，按时间追溯

整理日期：2026-11-02。当前交付为 **v0.6：链上限量发售 + RabbitMQ**，保留模拟 v0.3 与既有链交易能力。当前事实以[开发进度](00-overview/current-progress.md)、[发售实现](02-architecture/flash-sale-design.md)和[验收手册](04-testing/sale-acceptance.md)为准；版本变化见[时间线](00-overview/timeline.md)，实际执行结果见[报告目录](reports/README.md)。

Web3 初学者从[10 章完整入门讲解](01-beginner/README.md)开始：先认识钱包、链、代币、签名和 Gas，再运行购买，理解 Go/SQL/Redis/RabbitMQ、二级交易、源码和故障恢复。

## 文件夹分类

文档已实际移动到以下文件夹，每个文件夹都有自己的 README。根目录只保留总入口，阶段报告和原始证据继续放在 reports。

| 文件夹 | 内容 |
| --- | --- |
| [00-overview](00-overview/README.md) | 当前进度、开发过程、日期与版本时间线 |
| [01-beginner](01-beginner/README.md) | 面向 Web3 小白的 10 章项目讲解 |
| [02-architecture](02-architecture/README.md) | 模拟/发售架构、认证、Web3 方案与演进 |
| [03-development](03-development/README.md) | 开发规范、源码阅读、接口、手写教程、审计与选型 |
| [04-testing](04-testing/README.md) | 发售手动验收、测试设计/用例、各业务测试手册 |
| [05-deployment](05-deployment/README.md) | Windows、部署、数据生命周期、备份恢复与排障 |
| [06-interview](06-interview/README.md) | 面试精简稿与详细 Q&A |
| [07-history](07-history/README.md) | v0.2–v0.5 阶段设计，结合日期阅读 |
| [reports](reports/README.md) | 按日期排列的执行报告和原始证据 |

## 推荐阅读路线

| 目的 | 阅读顺序 |
| --- | --- |
| 跑起来并手动验收 | [当前进度](00-overview/current-progress.md) → [发售手动验收](04-testing/sale-acceptance.md) → [发售测试说明](04-testing/sale-testing.md) |
| 理解 Go、Web3 与秒杀的结合 | [模拟撮合架构](02-architecture/architecture.md) → [既有链交易协议](07-history/v0.5-design.md) → [发售架构](02-architecture/flash-sale-design.md) → [代码阅读指南](03-development/code-reading-guide.md) |
| Web3 从零理解 | [项目入门 10 章](01-beginner/README.md) → [手动验收](04-testing/sale-acceptance.md) → [代码阅读指南](03-development/code-reading-guide.md) |
| 从空目录练习写代码 | [23 章模拟交易教程](03-development/from-zero-tutorial.md) → [链开发手册](03-development/web3-development.md) → [发售架构](02-architecture/flash-sale-design.md) |
| 准备面试 | [实际进度与边界](00-overview/current-progress.md) → [面试精简稿](06-interview/interview-guide.md) → [详细 Q&A](06-interview/interview-qa.md) → [报告与证据](reports/README.md) |
| 回顾开发过程 | [版本时间线](00-overview/timeline.md) → [详细开发记录](00-overview/development-plan.md) → [按日期排列的报告](reports/README.md) |

## 1. 项目现状与开发过程

| 文档 | 内容与适用范围 |
| --- | --- |
| [当前开发进度](00-overview/current-progress.md) | v0.6 已实现功能、数据权威、运行架构与剩余边界 |
| [版本与文档时间线](00-overview/timeline.md) | 从 2026-10-09 需求设计到 2026-11-02 发售交付及文档整理 |
| [开发计划与过程记录](00-overview/development-plan.md) | 阶段门槛、风险、按日期排列的工作摘要 |
| [需求来源](../goal.md) | 原始需求及历次补充，保留原日期 |

## 2. 架构、协议与演进

| 文档 | 内容与适用范围 |
| --- | --- |
| [模拟交易架构](02-architecture/architecture.md) | 模拟 v0.3：单写者、日志屏障、撮合、资金与查询投影 |
| [模拟认证与权限](02-architecture/auth-design.md) | 邮箱注册、Cookie/CSRF、管理员与模拟注资；发售钱包会话见发售架构 |
| [链上限量发售架构](02-architecture/flash-sale-design.md) | v0.6：SQL 库存/资格、RabbitMQ、凭证、合约、索引及安全回收 |
| [生产架构演进](02-architecture/production-architecture.md) | 已实现阶段 A 与后续 B–D，生产高可用、容量等仍有差距 |
| [后端为主的 Web3 路线](02-architecture/backend-web3-roadmap.md) | 后端、中间件与小型合约的职责，区分已实现和后续阶段 |
| [链上交易可行性分析](02-architecture/onchain-feasibility.md) | 2026-10-12 方案比较背景；受限 B 路线随后实现 |
| [原项目审计](03-development/reference-audit.md) | 原始参考项目静态审计与问题映射，未运行原项目 |
| [开源选型](03-development/technology-selection.md) | 依赖取舍及来源，执行时以当前依赖文件为准 |

## 3. 开发、代码阅读与接口

| 文档 | 内容与适用范围 |
| --- | --- |
| [开发规范](03-development/engineering-standards.md) | 精度、所有权、并发、持久化、契约和中文注释要求 |
| [代码阅读与注释指南](03-development/code-reading-guide.md) | 模拟、链交易、发售的真实调用链及源码入口 |
| [从零手写教程](03-development/from-zero-tutorial.md) | 23 章模拟系统教学，教学数据/协议与最终项目分开 |
| [链开发手册](03-development/web3-development.md) | 二级交易开发、钱包签单、授权和本地链操作 |
| [接口与联调指南](03-development/api-guide.md) | 主体为模拟接口、幂等、分页、水位和恢复；链/发售契约见各业务手册 |

## 4. 手动验收与测试

| 文档 | 内容与适用范围 |
| --- | --- |
| [发售手动验收](04-testing/sale-acceptance.md) | v0.6 首选入口：正常购买、最后一份、过期回收和购买后交易 |
| [发售测试说明](04-testing/sale-testing.md) | v0.6 测试命令、环境、实际结果及未验证项 |
| [链交易测试手册](04-testing/web3-testing.md) | 签单、结算、恢复、重组与中间件验证 |
| [通用测试手册](04-testing/testing-guide.md) | 模拟主线和通用脚本、覆盖率、CI 与失败排查 |
| [测试设计](04-testing/test-design.md) | 正确性、并发、恢复、性能与前后端矩阵，设计不等于实测 |
| [测试用例目录](04-testing/test-cases.md) | 需求、场景、预期和测试源码映射 |

## 5. 启动、部署、数据与运维

| 文档 | 内容与适用范围 |
| --- | --- |
| [Windows 本地运行](05-deployment/windows-local-run.md) | 本地入口和模式选择，发售详细操作以验收手册为准 |
| [模拟系统部署手册](05-deployment/deployment.md) | 模拟 v0.3 容器/云部署说明和维护命令 |
| [链交易部署与恢复](05-deployment/web3-deployment.md) | 链服务配置、RabbitMQ/PG/Redis、备份、升级与恢复 |
| [数据生命周期](05-deployment/data-lifecycle.md) | 日志、身份、投影、链任务及发售 SQL 的权威与重建边界 |
| [故障排查手册](05-deployment/operations-runbook.md) | 启动、权限、未知结果、投影、中间件、索引与存储排障 |

## 6. 面试材料

| 文档 | 内容与适用范围 |
| --- | --- |
| [面试精简稿](06-interview/interview-guide.md) | 项目讲述、关键取舍、追问与真实性边界 |
| [详细面试 Q&A](06-interview/interview-qa.md) | 资金、恢复、容量、Redis、分区、链交易和发售追问；模型数字与实测分开 |

## 7. 历史版本设计与报告

| 日期 | 版本资料 | 阅读定位 |
| --- | --- | --- |
| 2026-10-11 | [v0.2 设计](07-history/v0.2-design.md) | 接口契约、订单分页和原请求恢复的增量背景 |
| 2026-10-11 | [v0.3 设计](07-history/v0.3-design.md) | 模拟系统完整架构与当时交付范围 |
| 2026-10-12 | [v0.4 设计](07-history/v0.4-design.md) | 首次独立链交易协议背景，当时消息队列为 Kafka |
| 2026-10-12 | [v0.5 设计](07-history/v0.5-design.md) | 历史查询、任务 CAS、确认索引及对账；当前传输以 v0.6 RabbitMQ 为准 |
| 2026-10-10 至 2026-11-02 | [阶段报告与证据目录](reports/README.md) | 按日期及同日阶段先后顺序查找 12 份执行报告 |

## 维护与阅读约定

当前操作文档按主题查找，历史变化按时间线查找。正文中早期的“当前”“本轮”应结合所属版本和日期理解；报告只证明该次实际执行，不自动继承为新版本结果。历史 Kafka、模拟核心吞吐和早期 Windows 失败，分别结合其环境及后续报告理解。

本次将 33 份原主题文档实际移入分类文件夹，并同步相对链接、根目录路径引用、源码注释和发布脚本。迁移映射保存在[路径迁移表](00-overview/document-migration.md)。报告只调整必要的文档跳转，不更改历史事实；原始证据保留原路径和字节内容。后续文档加入对应主题，新报告采用 `YYYY-MM-DD-主题.md`，同步[报告目录](reports/README.md)和[时间线](00-overview/timeline.md)；不为旧文档补造精确时分或成绩。
