架构文档导读（五层深入）
架构文档按「由浅入深」分五层；每层回答不同的问题， 全部结论可回溯到源码（架构证据链）。
五层视图
| 层 | 页面 | 回答的问题 | 适合读者 |
|---|---|---|---|
| L1 全局 | 全局视角 | 系统由什么组成？请求从哪进、到哪出？ | 所有人（10 分钟） |
| L2 逻辑 | 逻辑分层 · 组件清单 | 分几层？每个 crate/服务干什么？ | 开发者/架构师 |
| L3 运行时 | 运行时架构 | 进程/tokio/HTTP/gRPC/中间件怎么跑？ | 平台开发者 |
| L4 控制流 | 请求生命周期 · 启动生命周期 · 服务间通信 | 一次请求/一次启动/一次服务调用的完整时序 | 深度理解者 |
| L5 源码 | 源码地图 | crate→module→关键 struct/trait 的落点 | 读代码的人 |
两个横切主题独立成篇：
快速定位
text
我只想大概了解 → overview（一图 + 一表）
我要接入 API → overview + request-lifecycle
我要读/改代码 → components + source-map
我在排查线上问题 → request-lifecycle + 一致性语义 + 排障中心
我要评审架构决策 → 本节 + 设计决策与交付文档的关系
本节是面向长期维护的架构手册（以当前代码为准）； 逐里程碑的交付实录与设计过程在仓库 docs/design/（14 分册）与 docs/架构原理.md，两者冲突时以本站 + 代码为准（证据链 记录差异）。