架构决策记录(ADR)

本目录用 Architecture Decision Record (ADR) 体例,记录 QuantumAtlas 项目里重要、难回退、且当下做了取舍的架构决策——重点是 why 我们选了这条而不是那条, 跟 概念 里写的 what 系统现在长这样、怎么用 互为表里。

阅读规则

  • 编号 = 发明顺序,不是优先级。0001 是最早做的决定,靠后的编号是后做的。一旦写下永不重排, 以保证跨 ADR 互引(如 见 ADR 0004)永远有效。

  • 状态约定:默认是 accepted;若被后来的 ADR 取代,原 ADR 留在原位、加一行 Superseded by ADR-NNNN,不删除。已废弃的 ADR 也是档案的一部分,记录的是"我们曾经怎么想"。

  • 格式参考 grill-with-docs / ADR-FORMAT ——大多数 ADR 是 1-3 段,覆盖背景 + 决策 + 理由;只有少数复杂场景需要 Considered Options 或 Consequences 段。

当前清单

见左侧目录树。