首页/开发/系统分析与架构设计速查/架构决策记录(ADR)

架构决策记录(ADR)

用短文档记录单条架构决策:背景、决策内容、备选方案与后果;ADR 按编号归档并纳入代码库评审,让后来者理解决策的来龙去脉。

模板

模板
# ADR-0012 采用事件驱动集成

## 背景
订单域与库存域需要最终一致同步

## 决策
通过消息中间件发布领域事件

## 备选方案
- 同步 RPC 调用(拒绝:耦合可用性)

## 后果
+ 解耦伸缩   - 引入最终一致复杂度
ADR 是决策记录而非文档工程:一页说明白即可,重点是记录被拒绝的方案与原因。

易错点

  • 决策只在会议里达成,无人记录背景与理由
  • ADR 写成事无巨细的长文档,维护成本高被弃用

数据来源与参考

  • Michael Nygard:Documenting Architecture Decisions(2011)
  • adr.github.io:Architecture Decision Records
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌