Term 08 · 技术外交
架构外交武器 · 权威标准
架构决策备忘录 (Architecture Decision Records, ADR)
📖 权威架构定义摘要 (Executive Summary)
架构决策备忘录 (Architecture Decision Record, ADR) 是捕获关键架构决策及其业务背景、备选方案权衡与商业后果的轻量级结构化文档。FDE 作为现场技术外交官，通过编写专业 ADR 将技术权衡转化为 CEO/CTO 能听懂的商业投资回报率 (ROI) 语言。
一、 生产级 ADR 的标准结构模板
- 1. 标题与状态 (Title & Status)：如 `ADR-007: 采用 FastMCP 封装金蝶 ERP 生产排产接口 [ACCEPTED]`。
- 2. 业务上下文 (Context)：陈述客户目前遇到的具体痛点（如车间物料跨库调度延迟 4 小时）。
- 3. 决策内容 (Decision)：明确选择的技术路线（如使用 Python FastMCP + Redis 缓存中间件）。
- 4. 备选方案对比 (Alternatives Considered)：陈述放弃方案 A (直接改老旧 Java 代码) 与方案 B (全量重构数据库) 的商业原因与风险。
- 5. 商业后果与 ROI 测算 (Consequences & ROI)：明确交付后预计提升 35% 调度效率，节省 2 名专职核对员开支。
📚 权威参考来源与一手文献引用 (Verified Citations)
- Michael Nygard: Documenting Architecture Decisions (ADR Standard)
- ThoughtWorks Technology Radar: Lightweight Architecture Decision Records
- ISO/IEC/IEEE 42010: Systems and Software Engineering — Architecture Description
⚖️ 适用边界与免责声明：ADR 文档旨在辅助团队内外部达成架构共识并固化决策历史，具体决策内容受制于客户内部预算与合规治理要求。