Архитектурные схемы в большинстве компаний похожи друг на друга: прямоугольники разных цветов, стрелки без подписей, иконки облаков и баз данных, легенды нет. Автор понимает всё, остальные — ничего, а через полгода и автор тоже. Проблема не в инструментах, а в отсутствии общего языка: что означает прямоугольник, что — стрелка, на каком уровне детализации мы находимся. Модель C4 предлагает такой язык — простой, без сложной нотации, но со строгими уровнями абстракции. Разберём, как она устроена и как её применять.
Что такое C4
Модель C4 предложил британский архитектор Саймон Браун в 2010-х годах. Название — по четырём уровням диаграмм: Context, Containers, Components, Code. Идея похожа на картографию: карта страны, карта города, план района, план здания. На каждом уровне — свой масштаб и своя аудитория, и каждая следующая диаграмма раскрывает один элемент предыдущей.
C4 — не нотация в строгом смысле. Браун сознательно не задаёт формы и цвета: важны абстракции и подписи. Это делает модель простой в освоении и не привязанной к инструменту.
Абстракции
В основе C4 — небольшой набор понятий. Если команда договорилась о них, диаграммы становятся читаемыми без автора.
- Человек (person) — пользователь системы: роль или группа ролей. «Покупатель», «Оператор колл-центра».
- Программная система (software system) — то, что даёт ценность пользователям и обычно принадлежит одной команде. Ваша система или внешняя: платёжный провайдер, ЕСИА, почтовый сервис.
- Контейнер (container) — отдельно запускаемая или развёртываемая единица внутри системы: веб-приложение, мобильное приложение, бэкенд-сервис, база данных, брокер сообщений, файловое хранилище. Не путать с Docker-контейнером, хотя часто они совпадают.
- Компонент (component) — группа связанной функциональности внутри контейнера за общим интерфейсом: модуль, пакет, набор классов.
- Код — классы, интерфейсы, функции.
Отношения — стрелки с обязательной подписью: что происходит и, на уровнях ниже контекста, по какой технологии. «Отправляет заказы [JSON/HTTPS]», «Публикует события об оплате [Kafka]».
Уровень 1. Диаграмма контекста
Что показывает: вашу систему как один прямоугольник, её пользователей и внешние системы, с которыми она взаимодействует.
Для кого: все — от бизнеса до разработчиков, включая новых людей в команде.
Что не показывает: технологии, протоколы, внутреннее устройство.
Это самая полезная и самая недооценённая диаграмма. На ней сразу видно, где проходят границы ответственности, от каких внешних систем вы зависите и кто ваши пользователи. Для системного аналитика она — отправная точка любого проекта и обязательный раздел постановки.
@startuml
!include <C4/C4_Context>
Person(customer, "Покупатель", "Оформляет и отслеживает заказы")
Person(operator, "Оператор", "Обрабатывает обращения")
System(shop, "Интернет-магазин", "Каталог, корзина, заказы")
System_Ext(payments, "Платёжный провайдер", "Приём оплаты картой и по СБП")
System_Ext(delivery, "Служба доставки", "Расчёт стоимости и доставка")
System_Ext(erp, "Учётная система", "Остатки, цены, документы")
Rel(customer, shop, "Выбирает товары, оформляет заказы")
Rel(operator, shop, "Ищет заказы, меняет статусы")
Rel(shop, payments, "Создаёт платежи")
Rel(shop, delivery, "Создаёт заявки на доставку")
Rel(erp, shop, "Передаёт остатки и цены")
@enduml
Уровень 2. Диаграмма контейнеров
Что показывает: из каких контейнеров состоит система, как они взаимодействуют друг с другом и с внешним миром, на каких технологиях построены.
Для кого: архитекторы, разработчики, эксплуатация, аналитики.
Здесь появляются технологии: «Веб-приложение [Next.js]», «API [Java, Spring Boot]», «База данных [PostgreSQL]», «Брокер [Kafka]». Связи подписаны протоколами. На этом уровне принимается большинство архитектурных решений: монолит или сервисы, синхронно или асинхронно, где хранятся данные.
@startuml
!include <C4/C4_Container>
Person(customer, "Покупатель")
System_Ext(payments, "Платёжный провайдер")
System_Boundary(shop, "Интернет-магазин") {
Container(web, "Веб-приложение", "Next.js", "Каталог, корзина, личный кабинет")
Container(api, "API магазина", "Java, Spring Boot", "Заказы, корзина, пользователи")
Container(worker, "Обработчик событий", "Java", "Синхронизация остатков, уведомления")
ContainerDb(db, "База данных", "PostgreSQL", "Заказы, пользователи, каталог")
ContainerQueue(bus, "Шина событий", "Kafka")
}
Rel(customer, web, "Использует", "HTTPS")
Rel(web, api, "Вызывает", "JSON/HTTPS")
Rel(api, db, "Читает и пишет", "JDBC")
Rel(api, bus, "Публикует события заказов")
Rel(bus, worker, "Доставляет события")
Rel(api, payments, "Создаёт платежи", "REST/HTTPS")
@enduml
Если систем много и они принадлежат разным командам, диаграмма контейнеров рисуется для каждой системы отдельно, а их связи показывает диаграмма ландшафта.
Уровень 3. Диаграмма компонентов
Что показывает: внутреннее устройство одного контейнера — основные компоненты, их ответственность и связи.
Для кого: разработчики и архитекторы этого контейнера.
Например, внутри «API магазина»: контроллер заказов, сервис расчёта цены, клиент платёжного провайдера, репозиторий заказов. Эта диаграмма полезна для сложных контейнеров и при проектировании нового сервиса, но быстро устаревает. Многие команды рисуют её только для ключевых контейнеров или генерируют из кода.
Уровень 4. Код
Что показывает: классы, интерфейсы и их связи — обычно диаграммой классов UML.
Браун сам рекомендует рисовать этот уровень вручную только для самых важных или сложных фрагментов, а в остальном полагаться на IDE, которая строит такие диаграммы по коду. Для системного аналитика этот уровень, как правило, не нужен.
Дополнительные диаграммы
Помимо четырёх основных уровней, в C4 есть вспомогательные виды:
- Ландшафт систем (system landscape) — все системы организации и их связи, без фокуса на одной. Полезна для корпоративной архитектуры.
- Динамическая диаграмма (dynamic) — порядок взаимодействий для конкретного сценария: стрелки пронумерованы. Это аналог диаграммы последовательности на элементах C4.
- Диаграмма развёртывания (deployment) — как контейнеры размещены на инфраструктуре: серверы, кластеры Kubernetes, облачные сервисы, зоны доступности, окружения.
Правила хорошей C4-диаграммы
- Заголовок с типом и областью: «Диаграмма контейнеров: Интернет-магазин».
- Каждый элемент подписан: имя, тип (контейнер, система), технология, одна-две фразы об ответственности.
- Каждая стрелка подписана: что передаётся и как. Стрелка без подписи — это «как-то связаны», и её смысл каждый поймёт по-своему.
- Направление стрелки — направление зависимости или инициативы, а не потока данных; это стоит оговорить в легенде.
- Легенда: что означают цвета, формы и пунктир.
- Один уровень абстракции на диаграмме. Классы рядом с внешними системами — главный признак плохой схемы.
- Разумный размер: если элементов больше 20–25, диаграмму стоит разделить.
- Понятность без автора: человек со стороны должен прочитать схему без пояснений.
C4 и другие нотации
| Нотация | Сильная сторона | Как сочетается с C4 |
|---|---|---|
| UML | подробные модели поведения и структуры | диаграммы последовательности дополняют контейнеры, диаграммы классов — уровень кода |
| ArchiMate | корпоративная архитектура: бизнес, приложения, технологии | ArchiMate — для enterprise-уровня, C4 — для отдельных систем |
| BPMN | бизнес-процессы | процесс в BPMN, системы-участники — на диаграмме контекста |
| Схемы «на салфетке» | скорость | C4 добавляет к ним дисциплину подписей и уровней |
Архитектура как код
Диаграммы в графических редакторах быстро устаревают: их неудобно обновлять, нельзя посмотреть изменения, они лежат отдельно от проекта. Подход «диаграммы как код» решает это:
- C4-PlantUML — библиотека макросов для PlantUML (
Person,System,Container,Rel), примеры выше написаны на ней; - Structurizr DSL — язык от автора C4, где модель описывается один раз, а диаграммы разных уровней строятся из неё как представления;
- Mermaid — тоже поддерживает C4-диаграммы, хотя менее полно.
Текстовая диаграмма хранится в репозитории рядом с кодом и документацией, изменения проходят ревью, история видна в git. А согласованность между уровнями поддерживать проще, когда имена элементов — одинаковые идентификаторы, а не надписи в разных файлах графического редактора.
Какие диаграммы нужны аналитику
- Контекст — всегда. В начале проекта, в постановке на доработку, в описании интеграции. Здесь аналитик чаще всего главный автор.
- Контейнеры — для понимания, какие части системы затрагивает доработка и где будет жить новая функциональность. Обычно вместе с архитектором.
- Динамическая диаграмма или диаграмма последовательности — для описания конкретного сценария через контейнеры.
- Компоненты и код — редко, это зона разработчиков.
Типичные ошибки
- Смешение уровней — на диаграмме контекста появляются база данных и очередь.
- Стрелки без подписей или с подписью «использует» у всех стрелок подряд.
- Технологии на контексте — бизнесу неважно, что платёжный шлюз вызывается по REST.
- Контейнер = микросервис — а база данных и брокер забыты, хотя они тоже контейнеры.
- Попытка нарисовать всё — диаграмма компонентов для каждого из сорока сервисов, устаревшая через месяц.
- Нет легенды — красный цвет у одних означает «внешнее», у других «устаревшее».
Итог
Модель C4 — это не набор значков, а договорённость о четырёх уровнях абстракции: контекст, контейнеры, компоненты, код. Каждый уровень отвечает на свой вопрос и предназначен своей аудитории. Самая ценная для аналитика — диаграмма контекста: она фиксирует границы системы и все внешние зависимости. Диаграммы стоит хранить как код, подписывать каждую стрелку и не смешивать уровни.
C4-диаграммы можно писать текстом в редакторе PlantUML — макросы C4 подключены, пошаговая инструкция в гайде «C4-диаграммы в PlantUML». Сценарии взаимодействия контейнеров удобно дополнять диаграммами последовательности. Карта контекстов DDD естественно ложится на диаграмму контекста C4 — подробнее в статье «DDD на практике».
