Записи архитектурных решений (ADR)
Что такое ADR
ADR (Architecture Decision Record) — документ, фиксирующий значимое архитектурное решение, его контекст и последствия.
Каталог ADR
| # | Название | Статус | Дата |
|---|---|---|---|
| ADR-001 | Шаблон | Template | — |
ADR-001: Шаблон
Статус
Template
Контекст
Опиши проблему, которую решаем. Какие требования и ограничения? Какой текущий контекст?
Решение
Что решили сделать. Обоснуй выбор.
Альтернативы
| Вариант | Плюсы | Минусы |
|---|---|---|
| Вариант A | ... | ... |
| Вариант B | ... | ... |
| Выбранный | ... | ... |
Последствия
- Что меняется в системе?
- Какие trade-offs принимаем?
- Какие риски?
- Что нужно сделать для реализации?
Как добавить новый ADR
- Скопируй шаблон ADR-001
- Присвой следующий номер
- Заполни все секции
- Создай PR, добавь в таблицу каталога
- Пройди процесс согласования