Архитектура · Средняя
Зафиксировать архитектурное решение
Описать важный технический выбор в ADR: контекст, варианты, решение и последствия.
Быстро понять за 2 минуты
Описать важный технический выбор в ADR: контекст, варианты, решение и последствия. На выходе: aDR опубликован.
Контекст
Пункт относится к этапу «Архитектура». Его задача — определить границы решения и избежать случайного усложнения системы. Он нужен до передачи результата разработчикам, QA и команде эксплуатации: иначе команда рискует писать ADR задним числом без альтернатив.
Что это дает
ADR сохраняет инженерный контекст и помогает будущей команде понимать, почему выбран именно этот путь. Это помогает связать работу с общей целью: надежная, безопасная и поддерживаемая система. Практический эффект виден, когда aDR опубликован.
Как выполнить
- Опишите проблему и ограничения.
- Сравните 2-3 варианта.
- Зафиксируйте выбранное решение и последствия.
Критерии приемки
- ADR опубликован.
- Решение связано с задачей.
- Последствия и trade-off описаны.
Типичные ошибки
- Писать ADR задним числом без альтернатив.
- Фиксировать мелочи как архитектурные решения.
- Не обновлять статус ADR.
Инструменты
Рабочий артефакт
Architecture note
Архитектура: документ с выводом, доказательствами, ответственным и следующим действием
Пример для разработки сервиса заказов: специалист начинает с действия «Опишите проблему и ограничения». Результат прикладывают к рабочей задаче и передают следующему участнику. Пункт закрывают не по факту обсуждения, а когда выполнено условие: «ADR опубликован».
- Bounded context
- Dependencies
- Domain entities
- Risk areas
Контроль качества
Карта границ сервиса
ADR опубликован.
После изменения контрактов, релизов, инцидентов, роста нагрузки и пересмотра архитектурных решений.
Контракт, ограничения, сценарии отказа, метрики, владельца сервиса и критерии готовности.
Перед отметкой выполнено: ADR опубликован.
Как применять
Начинайте с границ ответственности и пользовательского сценария, который обслуживает система. Затем проверьте контракт, данные, отказоустойчивость, безопасность и наблюдаемость. Хороший backend-пункт фиксирует, что именно меняется, как это проверить и какие метрики покажут стабильность решения.
Режим обучения
Тест по теме
Проверка понимания
Ответьте на вопросы по материалу и получите итоговый отчет: что понято хорошо, а что стоит перечитать.