Архитектура · Средняя
Спроектировать модель ошибок
Определить типы ошибок, формат ответа и правила логирования.
Быстро понять за 2 минуты
Определить типы ошибок, формат ответа и правила логирования.
Контекст
Backend начинается с понимания домена, границ ответственности, контрактов и того, где система должна быть простой, а где масштабируемой.
Что это дает
Единая модель ошибок упрощает frontend-интеграцию, поддержку и диагностику production-инцидентов.
Как выполнить
- Разделите validation, auth, business и system errors.
- Опишите формат error response.
- Не раскрывайте чувствительные детали во внешнем ответе.
Критерии приемки
- Формат ошибок документирован.
- Коды ошибок стабильны.
- Логи содержат диагностический контекст.
Типичные ошибки
- Возвращать 500 на бизнес-ошибки.
- Показывать stack trace пользователю.
- Делать разные форматы ошибок в разных эндпоинтах.
Инструменты
Рабочий артефакт
Architecture note
Карта границ сервиса
Схема ответственности сервиса, внешних зависимостей, доменных сущностей и основных потоков данных.
- Bounded context
- Dependencies
- Domain entities
- Risk areas
Контроль качества
Карта границ сервиса
Формат ошибок документирован.
После изменения контрактов, релизов, инцидентов, роста нагрузки и пересмотра архитектурных решений.
Контракт, ограничения, сценарии отказа, метрики, владельца сервиса и критерии готовности.
Перед отметкой выполнено: Формат ошибок документирован.
Как применять
Начинайте с границ ответственности и пользовательского сценария, который обслуживает система. Затем проверьте контракт, данные, отказоустойчивость, безопасность и наблюдаемость. Хороший backend-пункт фиксирует, что именно меняется, как это проверить и какие метрики покажут стабильность решения.
Режим обучения
Прочитайте материал, прослушайте аудио и проверьте понимание по коротким вопросам. Ответ раскрывается после попытки сформулировать его самостоятельно.