C4: Как объяснить IT-систему даже бабушке.

Если вы когда-нибудь пытались объяснить коллегам, как работает ваша IT-система, а в ответ видели только пустые взгляды — эта статья для вас. Нотация C4 — это «язык», который превращает сложные схемы в понятные картинки. Зачем? Чтобы бизнес и разработчики наконец-то поняли друг друга.

Что такое C4 и зачем он бизнесу?

C4 — это не очередной модный термин. Это способ визуализировать IT-систему на 4 уровнях:

1. Контекст — как система вписывается в бизнес-процессы.
2. Контейнеры — основные блоки системы (например, веб-сервер, база данных).
3. Компоненты — что внутри контейнеров.
4. Код — детали реализации (но их обычно рисуют только разработчики).

Пример из практики:

Компания «Х» не могла внедрить новый модуль в CRM. Аналитики нарисовали диаграмму C4:

• На уровне контекста показали, как модуль связан с отделами продаж и логистики.
• На уровне контейнеров — какие сервисы задействованы.
• Результат: отделы перестали «валить» друг на друга проблемы, а проект завершили за 2 недели вместо 3 месяцев.

Фото создано с помощью Fabula-ai.

Как начать использовать C4?

1. Не рисуйте всё сразу. Начните с контекста: кто взаимодействует с системой (клиенты, сотрудники, партнеры).
2. Используйте простые инструменты: draw.io, Lucidchart или даже стикеры на доске.
3. Спросите команду: «Какие детали здесь важны?» Если ответ — «никакие», переходите на уровень выше.
4. Не усложняйте. C4 — не для демонстрации экспертизы, а для устранения недопонимания.

Почему C4 полюбят даже нетехнические специалисты?

• Менеджеры увидят, как IT-решения влияют на бизнес-цели.
• Разработчики перестанут тратить время на бесконечные уточнения.
• Владельцы бизнеса смогут оценить риски и стоимость изменений.

Как экономить время на создании С4, инструменты для скриптования C4

C4-модель завоевала популярность благодаря своей гибкости и доступности для специалистов разного уровня. Она позволяет эффективно визуализировать архитектуру системы, начиная от высокоуровневого контекста до деталей реализации. Однако, как и любой инструмент, C4 имеет не только сильные стороны, но и ограничения. Разберем ключевые недостатки и способы их минимизации.

Недостатки C4-модели и пути их решения

1. Трудоемкость ручного создания диаграмм
   При увеличении количества компонентов в системе ручное проектирование диаграмм становится крайне затратным. Каждое новое подключение или объект требуют времени на корректировку, что замедляет процесс разработки документации.
   Решение: Автоматизация — использование специализированных инструментов (например, Structurizr, PlantUML) для генерации диаграмм на основе кода или конфигурационных файлов. Это сокращает время на рутинные правки и снижает риск ошибок.
2. Снижение читаемости на полномасштабных диаграммах
   При попытке отобразить всю архитектуру сервиса на одном уровне диаграмма перегружается деталями, что затрудняет восприятие. Это особенно заметно в крупных проектах с десятками микросервисов и связей.
   Решение: Строгое соблюдение уровней абстракции C4. Контекстные и компонентные диаграммы следует разделять, фокусируясь на конкретных аспектах системы. Для сложных сценариев рекомендуется создавать отдельные диаграммы для каждого слоя (контейнеры, компоненты, код).

1. PlantUML + C4-Plugin

Популярный инструмент с поддержкой C4 через плагин. Пишете текст — получаете SVG/PNG.

Пример скрипта для контекстной диаграммы:

@startuml
!include <C4/C4_Context>

Person(клиент, "Клиент", "Покупает товары через сайт")
System(сайт, "Интернет-магазин", "Онлайн-продажи")
System(склад, "Система склада", "Управление остатками")

Rel(клиент, сайт, "Делает заказ")
Rel(сайт, склад, "Запрашивает наличие товара")
@enduml

Как это работает:

1. Установите PlantUML (или используйте онлайн-редактор).
2. Добавьте C4-плагин.
3. Опишите элементы и связи в скрипте.
4. Сгенерируйте диаграмму одной кнопкой.

2. Structurizr

Специализированный инструмент для C4 с собственным DSL (языком описания).

Пример скрипта:

workspace {
model {
клиент = person "Клиент" "Покупает товары через сайт"
сайт = softwareSystem "Интернет-магазин" "Онлайн-продажи"
склад = softwareSystem "Система склада" "Управление остатками"

клиент -> сайт "Делает заказ"
сайт -> склад "Запрашивает наличие товара"
}

views {
systemContext сайт {
include *
autolayout
}
}
}

Плюсы Structurizr:

• Генерация всех уровней C4 (контекст, контейнеры, компоненты) из одного скрипта.
• Встроенная документация.
• Можно работать через веб-интерфейс или CLI.

3. Mermaid.js

Простой инструмент для диаграмм, который поддерживает C4-стиль (с недавних пор).

Пример для уровня контейнеров:

C4Container
title Система онлайн-банка

Person(клиент, "Клиент", "Пользователь мобильного приложения")
Container(мобильное_приложение, "Мобильное приложение", "iOS/Android")
ContainerDb(база_данных, "База данных", "PostgreSQL")

Rel(клиент, мобильное_приложение, "Авторизуется")
Rel(мобильное_приложение, база_данных, "Записывает транзакции")

Где использовать:

• В Markdown-документации (GitLab, GitHub, Notion).
• Для быстрых скриншотов без установки ПО.

Как внедрить скриптовые C4 в бизнес-процессы?

1. Начните с шаблонов: Возьмите примеры выше и адаптируйте под свою систему.
2. Добавьте скрипты в репозиторий: Рядом с кодом проекта — так диаграммы всегда будут актуальны.
3. Автоматизируйте генерацию:
   GitHub Actions / GitLab CI: чтобы диаграмма обновлялась при каждом коммите.
   Jenkins: для интеграции в CI/CD-пайплайны.

Совет от БизнеС++:

Попробуйте нарисовать C4-диаграмму для самого простого процесса в вашей компании (например, отправка email-рассылки). Увидите: 80% «технических конфликтов» возникают из-за того, что люди представляют систему по-разному.