跳到主要内容

ADR 模板

ADR 代表架构决策记录,是一个迷你文档,用于捕捉不值得完整设计文档的重大架构变更。

# [已解决问题和解决方案的简短标题]

* 状态: [提议 | 拒绝 | 接受 | 废弃 | … | 被 [ADR-0005](0005-example.md) 取代] <!-- optional -->
* 决策者: [列出所有参与决策的人] <!-- optional -->
* 日期: [YYYY-MM-DD 最后更新决策的日期] <!-- optional -->

技术故事: [描述 | 票据/问题 URL] <!-- optional -->

## 背景和问题陈述

[描述背景和问题陈述,例如,使用两到三句话的自由形式。您可能想以问题的形式阐明问题。]

## 决策驱动因素 <!-- optional -->

* [驱动因素 1,例如,力量、面临的关注等]
* [驱动因素 2,例如,力量、面临的关注等]
*<!-- 驱动因素的数量可以变化 -->

## 考虑的选项

* [选项 1]
* [选项 2]
* [选项 3]
*<!-- 选项的数量可以变化 -->

## 决策结果

选择的选项: "[选项 1]",因为 [理由,例如,唯一满足关键标准的选项 | 解决了力量问题 | … | 最佳结果(见下文)]。

### 积极后果 <!-- optional -->

* [例如,质量属性满意度的提高,需要后续决策等]
*

### 消极后果 <!-- optional -->

* [例如,妥协质量属性,需要后续决策等]
*

## 选项的优缺点 <!-- optional -->

### [选项 1]

[示例 | 描述 | 更多信息的指针 | …] <!-- optional -->

* 好,因为 [论点 a]
* 好,因为 [论点 b]
* 坏,因为 [论点 c]
*<!-- 优缺点的数量可以变化 -->

### [选项 2]

[示例 | 描述 | 更多信息的指针 | …] <!-- optional -->

* 好,因为 [论点 a]
* 好,因为 [论点 b]
* 坏,因为 [论点 c]
*<!-- 优缺点的数量可以变化 -->

### [选项 3]

[示例 | 描述 | 更多信息的指针 | …] <!-- optional -->

* 好,因为 [论点 a]
* 好,因为 [论点 b]
* 坏,因为 [论点 c]
*<!-- 优缺点的数量可以变化 -->

## 链接 <!-- optional -->

* [链接类型] [链接到 ADR] <!-- 示例: 由 [ADR-0005](0005-example.md) 精炼 -->
*<!-- 链接的数量可以变化 -->