Langfuse Repo 完全导读从读懂当前仓库到做出类似 Infra

按教程书结构组织：分篇章节、中文架构图、源码锚点、运行链路、契约抽象、实验课和附录速查。

🧭

先教拆解方法

不从目录树随机游走，而是按控制面、数据面、契约面、执行面、状态面建立阅读路线。

🏗️

将当前 repo 拆成外部入口、web、shared、worker、数据设施五层，并配套中文 draw.io XML 架构图。

🔁

逐条解释 tRPC、Public API、ingestion、worker 队列和 v4 events 查询的真实调用顺序。

📜

重点讲 Zod、FilterState、QueueJobs、QueryBuilder、Repository 等稳定边界，而不是堆文件名。

🎨

解释 Tailwind token、表格系统、Search Bar 和高密度分析型 UI 的组织方式。

🧪

把 Langfuse 的 ingestion 模式缩小成 mini event infra，帮助你学会设计类似系统。

这本书按“源码导读”的方式组织当前 Langfuse repo。它的目标不是替代官方产品文档，而是帮助工程师理解这个 monorepo：

建议按顺序读前四篇：

后续可以按任务查阅契约、前端或二次开发章节。

如果目标是“看完后能做类似 infra”，建议读完第 4 篇后直接做第 8 篇实验课，再回到第 5 篇补契约细节。