Bilingual reading edition

This entry preserves the local document as the technical source of truth. The guide below is localized for English readers; commands, paths, API names, and code stay verbatim so their technical meaning is not changed in transit.

English guide

A reusable ADR template for decisions, alternatives, and consequences.

---

ADR-XXXX: 决策标题

• 状态：提议 / 已接受 / 已废弃 / 被替代
• 日期：
• 决策人：
• 影响范围：
• 关联需求：

背景

说明需要做决策的问题，以及不决策会产生的风险。

约束

• 业务约束：
• 技术约束：
• 安全/合规约束：
• 成本/团队约束：

候选方案

方案 A

• 描述：
• 优点：
• 缺点：
• 失败模式：

方案 B

• 描述：
• 优点：
• 缺点：
• 失败模式：

决策

选择：

选择原因

说明为什么当前方案在当前阶段更合适，不要只写“最佳实践”。

后果

正向后果

负向后果

后续工作

验证方式

• 自动化测试：
• 运行检查：
• 监控/指标：
• 复盘时间：