第 0 篇 · 0.1 这本书怎么读
学习目标
完成本节后，你将能够：
- 明白这本书为什么按“入口 → 边界 → 契约 → 链路 → 数据层”的顺序讲。
- 区分产品文档、README 和源码导读的不同目的。
- 知道如何在本地启动在线阅读站点。
- 建立后续章节的心理地图。
0.1.1 核心论点：先建立系统地图，再读具体文件
读 Langfuse 这种大型 monorepo，最常见的低效方式是从 web/src 随机点文件。你会很快看到大量 router、component、service、repository、queue processor，但不知道谁是入口，谁是契约，谁只是实现细节。
本书采用五个问题拆解：
| 问题 | 作用 | Langfuse 对应物 |
|---|---|---|
| 请求从哪里进来 | 找入口 | tRPC、Public API、ingestion、worker queue |
| 谁拥有边界 | 找 package 责任 | web、worker、packages/shared |
| 规则在哪里定义 | 找稳定契约 | Zod schema、QueueJobs、FilterState、QueryBuilder |
| 运行时怎么流动 | 找调用顺序 | HTTP → shared → Redis/S3 → worker → ClickHouse |
| 数据最终在哪里 | 找持久化模型 | Postgres、ClickHouse、Redis、S3 |
这套方法比“背目录”更可靠，因为目录会增长，运行边界通常更稳定。
0.1.2 与单篇导读的关系
仓库中仍保留一页版导读：
本书站点是它的分篇版和教学增强版：
- 每篇有独立学习目标；
- 每节给源码锚点；
- 用图表讲运行机制；
- 附录提供速查、术语和源码索引；
- 可以用 VitePress 在线阅读。
0.1.3 本书结构
这套结构借鉴教程书的组织方式，但目标更具体：不是泛泛介绍 Langfuse，而是让你能把“外部入口、shared 契约、worker 执行、状态设施、查询投影”这套 infra 模式迁移到自己的系统里。
本节小结
- 本书按“源码阅读路径”组织，而不是按产品功能宣传组织。
- 先读架构，再读链路，最后读具体 feature，效率最高。
- 下一节看 学习路线图。