0.2 学习路线图
学习目标
完成本节后，你将能够：
- 根据自己的目标选择阅读路径。
- 知道哪些章节适合新人，哪些章节适合做二次开发前查阅。
- 用一张路线图定位当前知识缺口。
0.2.1 三种阅读路径
| 目标 | 推荐路径 |
|---|---|
| 快速理解 repo | 0 → 1.3 → 1.4 → 1.6 → 2 → 3 |
| 理解运行原理 | 3 → 4 → 5 |
| 准备改代码 | 5 → 7 → 对应源码锚点 |
| 学会做类似 infra | 1.4 → 1.6 → 3.5 → 4.4 → 4.5 → 5.3 → 5.5 → 8 |
| 做前端改动 | 6 → 5.4 → 7.2 |
| 做 ingestion / ClickHouse 改动 | 4.4 → 4.6 → 5.5 → 7.5 |
0.2.2 最小学习闭环
如果你的目标是消化 infra 设计，而不是只完成一次改代码，最小闭环应当再多一步：
第 8 篇就是这个闭环的练习区。
0.2.3 不建议的读法
| 反模式 | 为什么低效 |
|---|---|
从 utils 开始读 | 容易陷入碎片函数，没有系统边界 |
| 从所有 React 组件开始读 | UI 数量大，但运行链路不明显 |
| 只看 API route 不看 shared | 会误以为规则都在入口层 |
| 只看 ClickHouse SQL 不看 FilterState | 不知道前端筛选语义从哪里来 |