整理日期:2026-11-02。当前交付为 v0.6:链上限量发售 + RabbitMQ,保留模拟 v0.3 与既有链交易能力。当前事实以开发进度、发售实现和验收手册为准;版本变化见时间线,实际执行结果见报告目录。
Web3 初学者从10 章完整入门讲解开始:先认识钱包、链、代币、签名和 Gas,再运行购买,理解 Go/SQL/Redis/RabbitMQ、二级交易、源码和故障恢复。
文件夹分类#
文档已实际移动到以下文件夹,每个文件夹都有自己的 README。根目录只保留总入口,阶段报告和原始证据继续放在 reports。
| 文件夹 | 内容 |
|---|---|
| 00-overview | 当前进度、开发过程、日期与版本时间线 |
| 01-beginner | 面向 Web3 小白的 10 章项目讲解 |
| 02-architecture | 模拟/发售架构、认证、Web3 方案与演进 |
| 03-development | 开发规范、源码阅读、接口、手写教程、审计与选型 |
| 04-testing | 发售手动验收、测试设计/用例、各业务测试手册 |
| 05-deployment | Windows、部署、数据生命周期、备份恢复与排障 |
| 06-interview | 面试精简稿与详细 Q&A |
| 07-history | v0.2–v0.5 阶段设计,结合日期阅读 |
| reports | 按日期排列的执行报告和原始证据 |
推荐阅读路线#
| 目的 | 阅读顺序 |
|---|---|
| 跑起来并手动验收 | 当前进度 → 发售手动验收 → 发售测试说明 |
| 理解 Go、Web3 与秒杀的结合 | 模拟撮合架构 → 既有链交易协议 → 发售架构 → 代码阅读指南 |
| Web3 从零理解 | 项目入门 10 章 → 手动验收 → 代码阅读指南 |
| 从空目录练习写代码 | 23 章模拟交易教程 → 链开发手册 → 发售架构 |
| 准备面试 | 实际进度与边界 → 面试精简稿 → 详细 Q&A → 报告与证据 |
| 回顾开发过程 | 版本时间线 → 详细开发记录 → 按日期排列的报告 |
1. 项目现状与开发过程#
| 文档 | 内容与适用范围 |
|---|---|
| 当前开发进度 | v0.6 已实现功能、数据权威、运行架构与剩余边界 |
| 版本与文档时间线 | 从 2026-10-09 需求设计到 2026-11-02 发售交付及文档整理 |
| 开发计划与过程记录 | 阶段门槛、风险、按日期排列的工作摘要 |
| 需求来源 ↗ | 原始需求及历次补充,保留原日期 |
2. 架构、协议与演进#
| 文档 | 内容与适用范围 |
|---|---|
| 模拟交易架构 | 模拟 v0.3:单写者、日志屏障、撮合、资金与查询投影 |
| 模拟认证与权限 | 邮箱注册、Cookie/CSRF、管理员与模拟注资;发售钱包会话见发售架构 |
| 链上限量发售架构 | v0.6:SQL 库存/资格、RabbitMQ、凭证、合约、索引及安全回收 |
| 生产架构演进 | 已实现阶段 A 与后续 B–D,生产高可用、容量等仍有差距 |
| 后端为主的 Web3 路线 | 后端、中间件与小型合约的职责,区分已实现和后续阶段 |
| 链上交易可行性分析 | 2026-10-12 方案比较背景;受限 B 路线随后实现 |
| 原项目审计 | 原始参考项目静态审计与问题映射,未运行原项目 |
| 开源选型 | 依赖取舍及来源,执行时以当前依赖文件为准 |
3. 开发、代码阅读与接口#
| 文档 | 内容与适用范围 |
|---|---|
| 开发规范 | 精度、所有权、并发、持久化、契约和中文注释要求 |
| 代码阅读与注释指南 | 模拟、链交易、发售的真实调用链及源码入口 |
| 从零手写教程 | 23 章模拟系统教学,教学数据/协议与最终项目分开 |
| 链开发手册 | 二级交易开发、钱包签单、授权和本地链操作 |
| 接口与联调指南 | 主体为模拟接口、幂等、分页、水位和恢复;链/发售契约见各业务手册 |
4. 手动验收与测试#
| 文档 | 内容与适用范围 |
|---|---|
| 发售手动验收 | v0.6 首选入口:正常购买、最后一份、过期回收和购买后交易 |
| 发售测试说明 | v0.6 测试命令、环境、实际结果及未验证项 |
| 链交易测试手册 | 签单、结算、恢复、重组与中间件验证 |
| 通用测试手册 | 模拟主线和通用脚本、覆盖率、CI 与失败排查 |
| 测试设计 | 正确性、并发、恢复、性能与前后端矩阵,设计不等于实测 |
| 测试用例目录 | 需求、场景、预期和测试源码映射 |
5. 启动、部署、数据与运维#
| 文档 | 内容与适用范围 |
|---|---|
| Windows 本地运行 | 本地入口和模式选择,发售详细操作以验收手册为准 |
| 模拟系统部署手册 | 模拟 v0.3 容器/云部署说明和维护命令 |
| 链交易部署与恢复 | 链服务配置、RabbitMQ/PG/Redis、备份、升级与恢复 |
| 数据生命周期 | 日志、身份、投影、链任务及发售 SQL 的权威与重建边界 |
| 故障排查手册 | 启动、权限、未知结果、投影、中间件、索引与存储排障 |
6. 面试材料#
7. 历史版本设计与报告#
| 日期 | 版本资料 | 阅读定位 |
|---|---|---|
| 2026-10-11 | v0.2 设计 | 接口契约、订单分页和原请求恢复的增量背景 |
| 2026-10-11 | v0.3 设计 | 模拟系统完整架构与当时交付范围 |
| 2026-10-12 | v0.4 设计 | 首次独立链交易协议背景,当时消息队列为 Kafka |
| 2026-10-12 | v0.5 设计 | 历史查询、任务 CAS、确认索引及对账;当前传输以 v0.6 RabbitMQ 为准 |
| 2026-10-10 至 2026-11-02 | 阶段报告与证据目录 | 按日期及同日阶段先后顺序查找 12 份执行报告 |
维护与阅读约定#
当前操作文档按主题查找,历史变化按时间线查找。正文中早期的“当前”“本轮”应结合所属版本和日期理解;报告只证明该次实际执行,不自动继承为新版本结果。历史 Kafka、模拟核心吞吐和早期 Windows 失败,分别结合其环境及后续报告理解。
本次将 33 份原主题文档实际移入分类文件夹,并同步相对链接、根目录路径引用、源码注释和发布脚本。迁移映射保存在路径迁移表。报告只调整必要的文档跳转,不更改历史事实;原始证据保留原路径和字节内容。后续文档加入对应主题,新报告采用 YYYY-MM-DD-主题.md,同步报告目录和时间线;不为旧文档补造精确时分或成绩。