🏗️ Архитектурное моделирование: нотации и практика C4

Моделирование архитектуры: нотации и практика

Ключевые тезисы

Моделирование архитектуры нужно для общего языка между стейкхолдерами, выявления проблем, фиксации решений и упрощения восприятия сложных систем.
Архитектурные нотации предлагают разные уровни абстракции: от бизнес-контекста до деталей кода.
Нотация C4, построенная на принципе вложенности (контекст → контейнеры → компоненты → код), является популярным и практичным подходом для описания программных систем.
Процесс моделирования итеративен, а документация должна быть "живой" и обновляться вместе с системой.

Зачем моделировать архитектуру?

Общий язык: Единое понимание для бизнеса, аналитиков и разработчиков.
Выявление проблем: Наглядное представление помогает увидеть узкие места и сложности.
Фиксация знаний: Документация, к которой можно обратиться в будущем.
Стандартизация: Использование единой нотации предотвращает путаницу и упрощает поддержку.

Обзор архитектурных нотаций

AADL (Architecture Analysis & Design Language)

Очень мощный язык для анализа и проектирования архитектуры.
Особенности: Позволяет моделировать как программные, так и аппаратные компоненты. Имеет собственный текстовый и графический язык, поддерживает автоматический расчёт нагрузок и анализ надёжности.
Применение: Критичные системы (авиация, космос, автомобилестроение), например, в Airbus.
Плюсы: Автоматизация анализа, поддержка разных уровней абстракции.
Минусы: Высокий порог входа, избыточен для бизнес-логики.

SysML (Systems Modeling Language)

Язык системного моделирования, наследник UML 2.0.
Особенности: Набор диаграмм (структурные, поведенческие, параметрические) для разных проекций системы. Адаптирован для системной инженерии.
Применение: Используется, например, в SpaceX (в адаптированном виде).
Плюсы: Универсальность, более низкий порог входа, чем у AADL, много инструментов.
Минусы: Много элементов, может быть избыточным для чисто программных систем.

ArchiMate

Нотация для моделирования enterprise-архитектуры.
Особенности: Слоистое представление (бизнес-слой, слой приложений, технологический слой). Позволяет связывать диаграммы между слоями.
Применение: Крупные компании с комплексной инфраструктурой.
Плюсы: Целостный взгляд на систему, низкий порог входа, разделение представлений для разных аудиторий.
Минусы: Сложно отразить детальное поведение и динамику работы компонентов.

4+1

Шаблон представления архитектуры на основе UML.
Особенности: Распределение стандартных UML-диаграмм по пяти представлениям (логическое, процесса, разработки, физическое + сценарии использования).
Плюсы: Охват всех стейкхолдеров, структурированность, независимость от инструментов.
Минусы: Не готовая нотация, требует ручного связывания диаграмм, риск избыточной детализации.

Детальный разбор нотации C4

C4 — это иерархическая нотация, где каждый следующий уровень "приближает" взгляд на систему.

Уровни модели C4

Контекстная диаграмма (Система в окружении): Показывает систему как "чёрный ящик", людей (акторов) и внешние системы, с которыми она взаимодействует. Для бизнес-аудитории.
Диаграмма контейнеров (Внутреннее устройство): Раскрывает систему, показывая крупные исполняемые блоки (веб-приложения, мобильные apps, микросервисы, базы данных). Указываются технологии. Для архитекторов и разработчиков.
Диаграмма компонентов (Устройство контейнера): Детализирует выбранный контейнер, показывая ключевые логические компоненты внутри него (контроллеры, сервисы, репозитории). Для разработчиков и тестировщиков.
Диаграмма кода (Детали реализации): Классическая диаграмма классов UML, показывающая детали реализации компонента. Используется редко.

Практика: построение модели C4 для HR-системы (кадровое агентство)

Шаг 1: Контекстная диаграмма

Система: HR System.
Акторы: Соискатель (публикует резюме, откликается), Работодатель (публикует вакансии, получает отклики), Рекрутер/HR (управляет вакансиями и резюме).
Внешние системы: Сервис уведомлений (отправка email/SMS).
Связи: Рисуются стрелки, описывающие ключевые действия (например, "публикует резюме", "отправляет уведомление").

Шаг 2: Диаграмма контейнеров

Контейнеры внутри HR System:
- Веб-сайт (Frontend).
- Микросервисы: User Service, Resume Service, Vacancy Service, Matching Service, Notification Service.
- Базы данных: для пользователей, резюме, вакансий, уведомлений.
- Очередь (Kafka topic) для асинхронной обработки новых заявок.
Технологии: Указываются для каждого контейнера (например, React, Spring Boot, PostgreSQL).
Связи: Детализируется, как контейнеры взаимодействуют друг с другом и с внешними системами (например, Resume Service пишет в базу резюме и отправляет событие в очередь о новом резюме).

Ключевые принципы работы

Итеративность: Модель уточняется в несколько проходов.
Аудитория: Каждый уровень предназначен для своей аудитории.
Адекватная детализация: Не нужно детализировать всё до мелочей; избегайте перегруженных диаграмм.
"Живая" документация: Архитектура меняется, поэтому модель необходимо поддерживать в актуальном состоянии с помощью удобных инструментов (например, Draw.io с библиотекой C4).