⭐️ Интеграционный Use Case: разбираемся на примере интеграции с #KudaGoAPI и #DashaMailAPI ⭐️

Интеграционный Use Case отличается от обычного тем, что он содержит технические детали:
+ вызовы API,
+ сохранение данных в БД,
+ обмен данными между микросервисами через брокеры,
+ и другие.

То есть всё то, что помогает понять, как "перетекают" данные в ходе работы системы.

Разбираемся подробнее на примере для #CityGA, где у нас UI в процессе работы вообще отсутствует 😱


📌 Use Case:
+ Автоматическая рассылка событий по расписанию

👉 Приложения и системы:
+ Backend CityGA
+ Kafka Broker

👉 Внешние системы:
+ KudaGo API
+ DashaMail API

👉 Предусловия:
+ Для каждого города задан часовой пояс
+ В CityGA сохранены предпочтения пользователей по категориям и выбран город
+ В DashaMail заранее созданы адресные списки под каждую группу категорий
+ В Kafka создан топики notifications.email.events для получения сообщений о необходимости запуска рассылки


👉 Основной сценарий:

1. Для каждого поддерживаемого города в системе еженедельно, по средам, в 10:00 его часового пояса, срабатывает планировщик задач в Backend.

2. Backend рассчитывает окно предстоящей недели - с чт по ср.
Пример:
Сегодня 17 сентября 2025 (ср).
Плановое окно для выбора новых мероприятий:
18.09.2025 00:00 → .24.09.2025 23:59:59 (GMT+3).
Для KudaGo это Unix-секунды:
actual_since=1758178800,
actual_until=1758783599.


3. Выполняется первичный запрос по событиям в выбранном городе на указанный период, без фильтра по категориям, в API KudaGo:

GET /public-api/v1.4/events

+ Получаем до 10 записей за один запрос от KudaGo
+ Использовать порядок сортировки favorites_count при получении данных от KudaGo
+ Исключать события «всегда доступно»/«без времени» - фильтрация на стороне CityGA

3.1. Сформировать сообщение в топик Kafka notifications.email.events для отправки рассылки, со списком из 10 полученных событий от KudaGo и с id листа подписчиков на город, у которых не настроены фильтры по категориям.


4. Далее повторять запрос по событиям в выбранном городе на указанный период, через API KudaGo, с фильтрами по категориям.

GET /public-api/v1.4/events

Например:
+ у одной группы пользователей в избранном только бизнес-события, выполнить запрос только с фильтром по этой категории на 10 записей;
+ у другой группы пользователей в избранном бизнес-события и детские мероприятия, выполнить запрос только с фильтром по этим двум категориям на 10 записей;
и т.д.

4.1. По каждому уникальному набору фильтров формировать сообщение в топик Kafka notifications.email.events для отправки рассылки, со списком из 10 полученных событий от KudaGo и с id листа подписчиков.

Повторять 4 и 4.1 для всех уникальных наборов категорий у пользователей в городе.

-------

5. Сервис Уведомлений последовательно читает сообщения из брокера Kafka.

5.1. После считывания очередного сообщения Сервис Уведомлений формирует HTML шаблон письма для рассылки.

5.2. Сервис Уведомлений вызывает API DashaMail для создания и отправки рассылки, передавая на вход созданный HTML-шаблон, id листа контактов из DashaMail и другие параметры (см. маппинг), метод:

campaigns.create

5.3. Сервис Уведомлений логирует вызов метода внешней системы.

-------


👉 Альтернативные сценарии и дополнительные детали
Всё будет, но не сейчас.
Оформим в Confluence 😎


Это первый подход к описанию логики работы системы.
Use Case ещё будет доработан.


📌 Вопросы,которые остаются после первого подхода к написанию интеграционного Use Case:
А. Есть ли у вас предложения по улучшению логики работы (алгоритма)?
Б. Должны ли мы что-то в процессе работы сохранить в БД?
В. Дейстительно ли метод campaigns.create сразу создает и отправляет рассылку? Нужны дополнительные действия?
Г. Можем ли мы фильтровать события «всегда доступно»/«без времени» на стороне KudaGo?
Д. Откуда мы получаем комбинации категорий?

Это то, что сейчас точно упущено в Use Case.

Рассуждайте, пробуйте отвечать на мои вопросы и задавайте свои в комментариях 🙌 Будем улучшать его вместе!


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

💥💥💥 Интеграции по REST, GraphQL и WebSocket 💥💥💥

REST API давно стал стандартом интеграции систем и частым вопросом на собеседованиях. Но сейчас всё чаще в проектах используются и другие виды API — они дают больше гибкости и возможностей.

И если вы пока не чувствуете себя уверенно с REST, то разобраться в более сложных API будет ещё труднее.

На открытом уроке мы поделимся с вами реальным опытом работы с различными API для интеграции систем:


🟠 Интеграции по REST, GraphQL и WebSocket
🗓 Доступ : 27–30 сентября [сб-вт]

🔗 Зарегистрироваться

Пройдём шаги от тестирования внешних API в Postman до требований в Confluence.


В результате:
🟢 Освоите порядок работы с интеграциями и научитесь быстро разбираться в любом API
🟢 Попрактикуетесь в Postman: отправите запросы, проанализируете ответы и составите сценарии тестирования
🟢 Познакомитесь с особенностями GraphQL и WebSocket
🟢 Поймёте, какие диаграммы нужны при проектировании интеграций
🟢 Получите шаблон постановки задачи в Confluence и разберёте типичные ошибки


Регистрируйтесь сейчас, чтобы получить новый опыт и структурировать имеющиеся знания! 🙌🎓

📝 Пример использования AI для создания UML Sequence за 3 минуты 📝

В прошлом посте рассказала про наш бесплатный AI инструмент для создания UML Sequence за 3 минуты.


Теперь показываю, как он работает, на примере по проекту с интеграциями #CityGA 👇

1. Взяла Use Case
Автоматическая рассылка событий по расписанию

2. Запустила AI инструмент для UML Sequence

3. Запросила шаблон Use Case, нажав на кнопку "Use Case - Template Empty"

4. Вставила описание Use Case и сразу, без лишней воды, которую обычно выдают нейросети, получила код для копирования в PlantUML.

5. Проверила полученную диаграмму. Всё отлично!

6. В посте с Use Case писала, что описанный алгоритм можно было бы улучшить, убрав разделение:
+ сделать запрос без фильтров по категориям
+ сделать запрос с фильтрами

7. Запросила у AI сделать это без моего участия:

"Оптимизируй алгоритм. т.к. по сути с фильтрами и без фильтров работает одинаково. Дай сразу готовый код plantUML"

Никаких лишних деталей в промпте.

8. Получила идеальную UML-диаграмму 🤩
Даже ничего исправлять за AI не пришлось.

👉🔗 Результат работы в AI-инструменте по этой ссылке (в РФ под VPN)


Как обычно косячит AI с UML:
❌ Теряет бары активации
❌ Алгоритм из Use Case, который надо показать, искажен, и надо выверять каждый шаг в UML-диаграмме
❌ Не учитывает все компоненты процесса
❌ Не на все запросы есть ответы, т.е. запрос в систему ушел (обычно стрелка вправо), а ответ (пунктирная стрелка влево) не получен, хотя запрос синхронный
❌ Слишком длинные и не единообразные подписи стрелок
❌ Потеряны API-методы, которые рекомендуется указывать на стрелках
❌ Самовызовы показаны некорректно, без их баров активации, либо вообще отсутствуют
▫️ БД и брокер не выделены графически
▫️ Куча лишнего текста ни о чем и "вода"

Исследовано опытным путём и огромным количеством практики. В AI инструменте от GetAnalyst сделали так, что нейросеть не косячит 🤝

-----
Дополнительно:
Если интересуетесь AI для работы, слушайте подкаст:
🎧 Полный гид по AI для СА
-----

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

⚪🔮 [Только 27-30 сентября] Интеграции по REST, GraphQL и WebSocket ⚪🔮

Хотите быть на шаг впереди своих коллег и разбираться в нестандартных API?
Планируйте время на обучение в эти выходные!

👉 Бесплатный практикум:

🔮 Интеграции по REST, GraphQL и WebSocket
🗓 Доступ : 27–30 сентября [сб-вт]
🔗 Зарегистрироваться

План:
1. Интеграции: порядок работы над задачами
2. Знакомство с задачей и анализ API-документации
3. Практика в Postman: REST API, GraphQL, WebSocket
4. Разработка интеграционного Use Case
5. UML-диаграммы и архитектурные схемы
6. Формирование постановки задачи в Confluence


------------------------
Подготовка:
+ Должен быть аккаунт в Postman.
+ Лучше скачать Desktop версию
+ Если работаете через браузерную версию, то перед началом практики установите и запустите фоновую программу Postman Agent (синий Postman)
+ Если ни разу не работали с Postman, попробуйте выполнить шаги по созданию Workspace и коллекции по этой инструкции для API ВТБ
------------------------


Регистрируйтесь, чтобы не пропустить возможность погрузиться в сложные темы на реальной практике! 🙌

🔖 Чек-лист требований к обработке ошибок в Интеграциях 📚

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

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

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

😄👉 Я абсолютно уверена, что работа аналитика - победить тестировщика,
то есть первым найти все потенциальные ошибки и сбои, которые может создать пользователь. Поэтому круто, когда в Системный Анализ переходят Тестировщики.

🔖 При работе с интеграциями я использую стандартный чек-лист, по которому можно написать требования к обработке ошибок:

1. Аутентификация
2. Доступ
3. Тайм-аут
4. Ошибки по документации внешней системы
5. Неизвестные ошибки, которых не было в документации и не планировалось их обрабатывать (новые коды, неизвестные форматы тела ответа)
6. Новые статусы или значения справочников, которые не совпадают с нашими перекодировочными таблицами, описанными в маппинге данных

Подробности в мини-книге к посту 📚

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

🎆 С днём системного аналитика! 🎆

Многие из нас ошибочно представляют себе системных аналитиков как специалистов, работающих исключительно в техническом направлении.

Но на деле их деятельность гораздо шире и охватывает не только техническую, но и организационную часть IT.

Итог их труда - это качественное техническое задание и аналитические отчеты, адаптированные под требования и интересы заказчика. 📑


✨ 24 сентября мы отмечаем День системного аналитика! Праздник празднуют не только аналитики, но и системные администраторы, специалисты IT, технические директора и многие другие!

🔍 Немного истории: 20 сентября 2000 года в пригороде Чикаго на пикнике Т. Кекатос предложил отмечать этот день в знак благодарности системным аналитикам за их вклад. Россия поддержала эту традицию, признав день профессиональным праздником!

🧠 Системный аналитик – это человек, способный творить, созидать и преобразовывать идеи в реальные проекты. Успешный аналитик должен быть грамотным, профессиональным и всегда быть на шаг впереди!

🎉 Интересный факт: в 2009 году было выявлено, что профессия системного аналитика относится к числу наименее стрессовых, разделяя места с диетологами, астрономами и инженерами-программистами.

Команда GetAnalyst и я, Екатерина Ананьева, подздравляем вас с профессиональным праздником! Пусть работа приносит удовлетворение, карьера растет, а проекты будут интересными и успешными! 💼🎉🥂

💥 Открыта запись на практическую программу для БА и СА:

💥 Интеграции систем
🗓 Старт: 8 октября 2025
🗓 Окончание: 17 декабря 2025

👉 Подробности и регистрация


Ключевые темы и навыки к освоению:
🔸 определение точек интеграций в сложной системе,
🔸 REST API, GraphQL, SOAP API и другие способы интеграции систем,
🔸 работа в Postman,
🔸 архитектура систем, нотация C4,
🔸 интеграционные Use Case,
🔸 нотация UML,
🔸 маппинг данных,
🔸 основы проектирования REST API методов,
🔸 основы работы с брокерами RabbitMQ и Kafka,
🔹 ведение документации в Confluence,
🔹 создание и распределение задач на разработчиков.


------------------------

Бесплатный вводный урок к программе

🟢 Интеграции по REST, GraphQL и WebSocket: от Postman до требований в Confluence
🔗 Зарегистрироваться

будет доступен 27–30 сентября [сб-вт].

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

------------------------


Получайте новый опыт сейчас, чтобы уже в конце 2025 или в начале 2026 году открывать для себя новые возможности! 🙌


Вопросы?
Пишите @getanalyst или на почту info@getanalyst.ru
Поможем оценить текущие навыки и ответим на вопросы 🤝