Что такое sequence diagram?

Sequence diagram (диаграмма последовательности) — один из видов UML-диаграмм взаимодействия. Она описывает, как несколько объектов или компонентов обмениваются сообщениями в рамках одного сценария, и делает акцент на временном порядке этих сообщений. Это ключевой инструмент для проектирования и документирования поведения системы.

Основные элементы

• Lifeline (линия жизни) — вертикальная линия, обозначающая участника (объект, сервис, актор).
• Activation bar — прямоугольник на линии жизни, показывающий, что участник в этот момент выполняет операцию.
• Message — стрелка между линиями жизни: синхронный вызов, асинхронное сообщение или ответ (return).
• Fragment — блок с условием (alt, opt, loop), позволяющий описать ветвления и циклы.

Пример сценария

Рассмотрим простой сценарий: клиент отправляет запрос на сервер, сервер обращается к базе данных и возвращает результат.

Client        Server         Database
  |              |               |
  |-- request -->|               |
  |              |-- query ----->|
  |              |<-- result ----|
  |<-- response -|               |

Здесь видно, что сервер сначала получает запрос, затем синхронно обращается к базе и только после получения данных отвечает клиенту. Если бы запрос к БД был асинхронным, стрелка была бы открытой, а клиент мог бы получить ответ раньше.

Где применяется

• Проектирование API и микросервисных взаимодействий.
• Документирование бизнес-процессов и пользовательских сценариев.
• Анализ производительности: видно, где возникают блокировки и лишние вызовы.
• Обсуждение архитектуры с командой и заказчиком.

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