В чем разница между диаграммой последовательности и BPMN?

Диаграмма последовательности vs BPMN

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

Диаграмма последовательности (Sequence Diagram)

Что это:

• Диаграмма из нотации UML (Unified Modeling Language)
• Показывает взаимодействие между объектами/компонентами во времени
• Отвечает на вопрос: "Какие сообщения передаются и в каком порядке?"
• Временная шкала направлена вниз (сверху вниз)

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

• Участники (Actors) — вертикальные линии
• Сообщения (Messages) — стрелки между участниками
• Возвращаемые значения — пунктирные стрелки
• Условия (Conditions) — alt, opt блоки
• Циклы (Loops) — loop блоки

Пример: Оформление заказа через REST API

Client           Order Service        Payment Service
  |                    |                      |
  |---POST /orders---->|                      |
  |                    |--validate order---->|
  |                    |<---validation OK----|
  |                    |--process payment--->|
  |                    |<---payment done-----|
  |<---201 Created-----|                      |
  |                    |                      |

Преимущества:

• Ясно показывает порядок взаимодействия
• Видны все обмены между компонентами
• Хорошо для документирования API интеграций
• Легко обнаружить ошибки в последовательности
• Подходит для технических команд

Недостатки:

• Не показывает параллельные потоки (только последовательность)
• Может быть сложна для многих участников
• Не показывает бизнес-логику или решения
• Сложно отражает асинхронные операции

BPMN (Business Process Model and Notation)

Что это:

• Стандартная нотация для моделирования бизнес-процессов
• Показывает "что происходит в процессе и как"
• Фокус на бизнес-логике, а не на техническом взаимодействии
• Может выполняться систематизированно (BPMN engine)

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

• Задачи (Tasks) — прямоугольники (человеческие или системные)
• Шлюзы (Gateways) — ромбы (условия XOR, AND, OR)
• События (Events) — круги (начало, конец, промежуточные)
• Потоки (Flows) — стрелки (последовательность)
• Дорожки (Lanes) — разделение по ролям/отделам

Пример: Процесс обработки заказа

┌─────────────┐
│ Клиент подал│
│  заказ      │
└──────┬──────┘
       │
       v
┌─────────────────┐      Нет
│Валидирована ли  ├──────────→ Отклонить заказ
│  информация?    │
└────────┬────────┘
         │ Да
         v
┌─────────────────┐      Нет
│Достаточно средств├──────────→ Уведомить клиента
│  на счете?      │
└────────┬────────┘
         │ Да
         v
┌─────────────────┐
│  Обработать     │
│   платеж        │
└────────┬────────┘
         │
         v
┌─────────────────┐
│ Отправить       │
│ подтверждение   │
└────────┬────────┘
         │
         v
┌─────────────────┐
│  Заказ принят   │
└─────────────────┘

Преимущества:

• Показывает бизнес-логику всего процесса
• Понятна бизнес-пользователям, не только разработчикам
• Включает параллельные и условные потоки
• Может быть автоматизирована
• Хорошо для документирования workflow-ов
• Легче увидеть весь процесс целиком

Недостатки:

• Не показывает детальное техническое взаимодействие
• Сложнее отражать обмены между системами
• Может быть громоздкой для простых процессов

Сравнительная таблица

Практические примеры использования

Когда использовать Sequence Diagram:

1. API интеграция между микросервисами

Client → API Gateway → Order Service → Payment Service → Database

1. Техническая документация взаимодействия

• Как клиент взаимодействует с сервером
• Какие вызовы в каком порядке
• Какие данные передаются туда-сюда

1. Отладка проблем интеграции

• Показывает точное место, где что-то сломалось
• Видны все переходные состояния

Когда использовать BPMN:

1. Бизнес-процессы с участием людей

Менеджер → Клиент → Бухгалтер → Архив

1. Workflow-ы, которые должны быть автоматизированы

• Approval process (согласование)
• Onboarding процесс
• Claims processing

1. Документирование для бизнеса

• Как работает процесс в реальности
• Какие решения принимаются
• Какие роли задействованы

Реальный пример: Система заказов

BPMN диаграмма (общая логика процесса):

[
Клиент] → [Создать заказ] → Проверка → [Да] → [Обработать платеж]
                               ↓                      ↓
                             [Нет] → [Отклонить] → [Конец]
                                                    ↓
                                           [Отправить товар]
                                                    ↓
                                            [Доставлено]

Sequence Diagram (техническое взаимодействие):

WebUI            API           OrderDB         PaymentGW
 |                |               |               |
 |--POST order--->|               |               |
 |                |---INSERT----->|               |
 |                |<---ID---------|               |
 |                |--chargeCard--------------->|
 |                |<---success---------------|
 |<--201 ID-------|               |               |

Как выбрать?

Используй Sequence Diagram, если:

• Нужно документировать техническое взаимодействие
• Есть несколько систем, обменивающихся сообщениями
• Важен порядок и синхронизация
• Аудитория — разработчики

Используй BPMN, если:

• Нужно документировать бизнес-процесс
• В процессе участвуют люди
• Есть условия и ветвления логики
• Нужно показать процесс бизнес-пользователям
• Процесс должен быть автоматизирован

Совет на основе опыта

В своей практике я часто использую оба инструмента вместе:

1. BPMN для показа бизнес-требований
2. Sequence Diagrams для технической реализации
3. Это помогает убедиться, что техническое решение соответствует бизнес-процессу

Корректный выбор инструмента визуализации делает документацию понятнее для всей команды.