Архитектура, которую можно понять за 30 секунд

Делюсь шаблоном, который я использую для быстрого наброска архитектуры системы.

Не для архитектурного комитета. Не для идеальной документации. А когда нужно за короткое время понять кусок ландшафта и начать нормально его обсуждать.

Мне очень нравится здесь разделение на слои: пользователь → бизнес-логика → данные → интеграции, а инфраструктура, мониторинг и логирование вынесены отдельно.

Вроде ничего революционного. Но читать такую схему сильно проще. Обычная архитектурная диаграмма большой системы довольно быстро превращается в полотно из 50–100 квадратиков и такого же количества стрелок.

И начинается классика: — а этот сервис зачем? — а эта стрелка куда идёт? — а эта база чья? — а что из этого вообще относится к нашей задаче?

Формально схема подробная. Практически — сигнал утонул в шуме.

А здесь можно смотреть архитектуру как будто по слоям карты.

Обсуждаем клиентский сценарий — смотрим верх.

Разбираем логику обработки — смотрим сервисный слой.

Проблема с данными — базы, кеши, аналитика.

Интеграционный сбой — сразу понятно, где внешняя система и через какой контракт она подключена.

Проблемы эксплуатации — отдельно видны Kubernetes, мониторинг и логи.

То есть ты не пытаешься каждый раз понять всю систему целиком. Ты смотришь только на тот слой, который нужен для текущего решения.

Для большого корпоративного ландшафта так красиво всё разложить, конечно, получится не всегда. Границы будут пересекаться, сервисы — участвовать в нескольких сценариях, интеграции — идти поперёк слоёв.

Но сам принцип мне очень нравится: не показывать человеку сложность, которая ему сейчас не нужна.

C4, ArchiMate и другие подходы полезны, когда нужна формальная архитектурная документация, несколько уровней детализации и единый язык описания.

Но иногда перед встречей мне нужен не полный C4.

Мне нужно за 15 минут нарисовать кусок системы так, чтобы разработчик, аналитик, архитектор и PO смотрели на одну картинку и примерно одинаково её понимали. И вот для этого такой шаблон работает отлично.

Хорошая архитектурная схема — это не та, где нарисовано больше всего. А та, после которой стало меньше вопросов.