| 要素 | 标题 / 状态 / 背景 / 决策 / 后果 |
|---|---|
| 状态 | 提议 / 接受 / 弃用 / 被取代 |
| 载体 | 与代码仓库一起的 markdown 文件 |
ADR 模板示例
ADR 模板示例
# ADR-012 采用消息队列解耦订单与库存
状态：接受（2026-09-12）
背景：峰值下单导致库存服务同步阻塞
决策：引入 Kafka，订单事件异步消费
后果：运维复杂度上升；需要监控积压架构决策记录 ADR
ADR 用轻量文档记录重要架构决策：背景、决策、后果与状态；与代码同库管理，让后来者理解为什么这样设计，避免重复争论。
易错点
- 决策不留记录：人走了决策背景也走了，反复重开讨论
- ADR 写成论文：太长没人维护，轻量才能持续
数据来源与参考
- Michael Nygard《Documenting Architecture Decisions》
- 架构文档实践