Интеграционный UseCase написан.
Но возможно в нем много текста. Слишком много текста 😁
А разработчики много читать не любят.
Для быстрого понимания “о чем тут вообще” помогают картинки и схемы. Особенно, когда речь идет о сложных интеграционных сценариях.
➡️ UML Sequence
Прекрасным дополнением к интеграционному Use Case служит UML диаграмма последовательности.
UML-Sequence
– это тип диаграммы, который показывает, как компоненты в системе взаимодействуют друг с другом в хронологическом порядке.
Диаграмма помогает быстрее разобраться не только в последовательности шагов, но и во взаимосвязях между компонентами системы, что особенно ценно при разработке и тестировании интеграций.
➡️ UML Activity
UML-Activity
помогает визуализировать последовательность действий в процессе работы системы, показывая не только шаги, но и ветвления, условия, циклы.
Может показывать системы и роли пользователей.
Визуально похожа на блок-схему.
Помогает показывать алгоритм работы системы.
Но используется реже, чем UML Sequence.
Диаграммы могут являться как дополнением, так и заменой текстового описания.
👍 Но текст алгоритмов всё же лучше держать рядом с диаграммами, как показазывает опыт.
Основные инструменты для построения UML-диаграмм:
Графические редакторы
🔸 Draw.io
🔸 Lucidchart
🔸 Miro
🔸 Microsoft Visio
Для создания диаграмм через код
🔸 PlantUML
🔸 MermaidChart
🖼 На картинках к посту показала обе диаграммы — UML Sequence и UML Activity.
Пример для процесса сброса пароля:
1. пользователь на переходит к экрану "Забыли пароль?",
2. вводит свой email,
3. получает письмо со ссылкой для сброса пароля на email.
👉 Обе созданы через код в PlantUML и описывают один и тот же процесс.
👉 Как читать:
+ UML Sequence: читайте строки по порядку, сверху-вниз, даже если следующая строка находится правее или левее.
+ UML Activity: двигайтесь сверху вниз, а при разветвлении (ромбы/многоугольники) сначала завершите читать одну ветку, затем другую.
#ИнтеграцииGA