💥 UML-Sequence: основная диаграмма для интеграций 💥

Интеграционный UseCase написан. Но иногда в нем много текста. Слишком много текста 😁 А разработчики много читать не любят.

Для быстрого понимания “о чем тут вообще” помогают картинки и схемы.
Особенно, когда речь идет о сложных интеграционных сценариях.


➡️ UML Sequence
Прекрасным дополнением к интеграционному Use Case служит UML диаграмма последовательности.

UML-Sequence

– это тип диаграммы, который показывает, как компоненты в системе взаимодействуют друг с другом в хронологическом порядке.

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

➡️ UML Activity

UML-Activity

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

Может показывать системы и роли пользователей.

Визуально похожа на блок-схему.
Помогает показывать алгоритм работы системы.
Но используется реже, чем UML Sequence.


Диаграммы могут являться как дополнением, так и заменой текстового описания.
Но текст алгоритмов всё же лучше держать рядом с диаграммами, как показазывает опыт.


Основные инструменты для построения UML-диаграмм:

Графические редакторы
🔸 Draw.io
🔸 Microsoft Visio
🔸 Lucidchart
🔸 Miro
Для создания диаграмм через код
🔸 PlantUML
🔸 MermaidChart


🖼 На картинках к посту показала обе диаграммы — UML Sequence и UML Activity.
Пример для процесса сброса пароля:
1. пользователь на переходит к экрану "Забыли пароль?",
2. вводит свой email,
3. получает письмо со ссылкой для сброса пароля на email.

👉 Обе созданы через код в PlantUML и описывают один и тот же процесс.

👉 Как читать:
+ UML Sequence: читайте строки по порядку, сверху-вниз, даже если следующая строка находится правее или левее.
+ UML Activity: двигайтесь сверху вниз, а при разветвлении (ромбы/многоугольники) сначала завершите читать одну ветку, затем другую.

#ИнтеграцииGA