# Web3 小白从零理解整个项目

这套讲解以当前 v0.6 源码为准，目标是让你能说清每一步为什么发生、谁在处理、钱在哪里、失败后怎么办。先理解并亲手跑通，再沿源码阅读；不要求你一开始就会 Solidity、区块链密码学或消息队列。

你可以把项目看成一套“首发购买 + 二手交易”的本地实验平台：运营方先把测试币放入发售合约，用户抢到购买资格后，用另一种测试币支付；拿到资产后，可以在 Go 维护的订单簿中挂卖单，由链上合约完成买卖双方资产交换。另有一套独立的模拟交易系统，供学习传统撮合和账户记账。

## 按这个顺序学习

| 顺序 | 章节 | 学完应该能回答 |
| --- | --- | --- |
| 1 | [项目全景与三个业务模式](01-project-tour.md) | 项目究竟做什么，Go、页面、数据库和链各负责什么？ |
| 2 | [钱包、区块链与合约基础](02-web3-basics.md) | 钱包存什么，币在哪里，为什么交易要等确认？ |
| 3 | [资产单位、签名与授权](03-assets-signatures.md) | ETH 和 MWETH 有何区别，登录/订单/凭证/交易签名分别是谁签？ |
| 4 | [第一次运行与观察](04-first-run.md) | 怎样启动、买一份、看余额和交易，再安全停止？ |
| 5 | [一次秒杀购买的完整过程](05-sale-walkthrough.md) | 从点“领取”到到账，中间每一步发生了什么？ |
| 6 | [Go、SQL、Redis 与 RabbitMQ](06-backend-reliability.md) | 怎样防超卖、丢任务和重复消费，为什么不只用一个 Redis？ |
| 7 | [模拟撮合与链上二级交易](07-trading-walkthrough.md) | 撮合和结算有何区别，pending 为什么不能当成交？ |
| 8 | [按调用链阅读源码](08-code-reading.md) | 每个目录是什么，应该先看哪些类型、函数和测试？ |
| 9 | [刷新、故障、测试与验收](09-failures-and-tests.md) | 页面卡住、链停了、队列重投或重组时，如何判断真实结果？ |
| 10 | [学习练习与自测问答](10-learning-checklist.md) | 怎样一步步掌握项目，并准确用于面试？ |

每章都有可计算例子、源码或文档入口、练习和自测答案。第一次只看第 1–5 章，把正常购买跑通；第二次看第 6–9 章，理解可靠性；最后做第 10 章练习。旧的[23 章手写模拟项目教程](../03-development/from-zero-tutorial.md)适合练 Go/React 基础，是另一条“亲手从空目录写代码”的路线。

## 先记住这六句话

1. 页面上的登录成功、SQL 中的资格、钱包里的授权和链上购买，是四件不同的事。
2. 普通钱包通过私钥签名证明身份，资产余额记录在链上；网页不应索要真实私钥。
3. Go 决定受理、排队、撮合和任务恢复，合约执行资产规则，最终资金事实看链。
4. Redis 做准入，RabbitMQ 运任务；库存资格由 SQL 事务裁决，三者不能互相替代。
5. 本地 Anvil 会执行真实 EVM 逻辑，但这里的 ETH、MWETH、MUSDT 都是测试资产。
6. HTTP 返回成功、消息已确认、交易已有 hash，都不能单独证明资产最终到账。

## 文档与版本口径

这是基于已有源码的入门讲解，不改变接口和业务。三场活动、120 秒常规资格、20 秒回收演练、默认确认深度 2 等均属于本地 fixture；运行时以本次页面配置为准。重启整个一键脚本会创建新链/新库，与刷新页面不同。

当前状态看[项目进度](../00-overview/current-progress.md)，操作以[手动验收](../04-testing/sale-acceptance.md)为准，实测结论看[报告目录](../reports/README.md)。公共链、生产资产、高可用和长时容量仍有未完成项，讲解中会明确边界。
