Architecture Decision Record Toolkit（架构决策记录工具）

知识库位置：FDE Knowledge Base/11 Tools/03-Architecture/02-ADR-Toolkit.md

When to Create ADR（何时创建 ADR）

当决策：

很难逆转
有明显 Trade-off（权衡取舍）
会影响多个团队
后续可能被质疑
成本或风险较高

应该记录。

Typical ADR Topics（典型 ADR 主题）

RAG（检索增强生成） vs Fine-tuning（微调）
Workflow（工作流） vs Agent（智能体）
Batch（批量） vs Streaming（流式）
Managed（托管） vs Self-hosted（自托管）
REST vs Event（事件）
SQL vs NoSQL

Quick ADR（快速 ADR）

Decision（决策）:
Use batch processing.（使用批处理。）

Context（背景）:
Business tolerates 30-minute freshness.（业务可容忍 30 分钟数据新鲜度。）

Alternatives（备选方案）:
Streaming.（流式处理。）

Why（原因）:
Lower operational complexity.（运维复杂度更低。）

Trade-off（权衡取舍）:
Not suitable if latency requirement drops below 5 minutes.（若延迟要求降到 5 分钟以下则不适用。）

Revisit when（重新评估时机）:
Business requires <5 minute latency.（业务要求延迟低于 5 分钟。）

ADR Principle（ADR 原则）

ADR（Architecture Decision Record，架构决策记录）记录的是：

为什么当时这么决定。

不是只记录：

最后用了什么。