📚 Мини-книга по Интеграциям: самое важное для Системных аналитиков 📚

Интеграция — это процесс объединения различных систем и приложений в единое целое, чтобы они могли работать вместе, обмениваться данными и выполнять задачи, как одна система.


👉 Пример 1
Платформа по доставке еды хочет отправлять клиенту SMS о процессе доставки.

Надо ли этой платформе:
1. Покупать оборудование для отправки SMS?
2. Заключать договоры и делать интеграции со всеми операторами сотовой связи?

Конечно, нет.
Мы подключаем готовый SMS-сервис (например, Unisender) через API — и задача по доставке SMS решена 🙌


👉 Пример 2
Тот же сервис доставки хочет принимать оплату банковскими картами.

Надо ли ему:
1. Реализовывать проверку карты?
2. Поддерживать 3-D Secure?
3. Хранить токены и проходить банковскую сертификацию PCI DSS?

Нет. Мы просто подключаем готовое решение по API, например, от ТБанка.


Главная идея интеграций:

Если не хочешь "изобретать велосипед", просто подключи (интегрируй) уже готовое решение в свою систему.

👉 Виды интеграций:

1) по окружениям:
▫️ Внешние - когда мы хотим подключить к нашей системе чужую, от других разработчиков.
▫️ Внутренние
- на проекте сервисная или микросервисная архитектура, сервисы обмениваются данными по API или через брокеры.
- мобильное приложение работает с данными благодаря интеграции с сервером по API.

2) по направлению:
▫️ Во внешние системы - когда мы используем API чужих систем.
▫️ К нашей системе - когда мы сами разрабатываем свой API, чтобы к нам подключались (например, по примеру выше, мы банк, и даем другим свой API для подключения)


👉 Способы обмена данными:
▫️ Синхронный - отправили данные и получили ответ сразу.
▫️ Асинхронный - отправили данные и продолжили работу без ожидания ответа. Обработка в фоне.


👉 Основные способы интеграции:
▫️ API
▫️ Библиотеки и SDK
▫️ Брокеры
▫️ Файлы
▫️ Общая БД



📚 Подробнее об интеграциях рассказала в мини-книге с картинками и примерами.

Файл прикреплен к посту.

Загружаем, изучаем и используем 👍

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

🌆 #CityGA - новый проект на Интеграцию с #KudaGoAPI и #DashamailAPI 🌆

Планы на выходные без бесконечного скролла — система для городов #CityGA сама найдёт события под ваши интересы и раз в неделю пришлёт подборку «куда сходить» в приложении и на почту.


🟢 Сценарий к проектированию:
1. Пользователь настраивает город, категории мероприятий и ключевые слова по ним.
2. По расписанию система собирает актуальные события из KudaGo, фильтрует и ранжирует под каждого пользователя.
3. Готовит подборку внутри приложения и отправляет на email через Dashamail.


👉 Что предстоит сделать для решения задачи на Интеграцию:
1. Выделить ключевые Use Case - сценарии работы пользователя.
2. Провести первичный анализ KudaGo API и Dahamail API: наличие нужных методов, рекомендуемый порядок интеграции.
3. Определить влияние интеграции на архитектуру системы.
4. Протестировать платёжное API Kadago и API Dashamail в Postman, чтобы понять, как они реально работают.
5. Описать интеграционные Use Cases: логику работу системы с техническими деталями.
6. Сформировать требования для интеграционных REST API-методов.
7. Дополнить требования UML-диаграммами.
8. Описать маппинги данных и доработки БД

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


✅ Результат:
Отработанный кейс интеграции от анализа до реализации.
✔️ Постановки задач на интеграцию на разработчиков в Confluence
✔️ Архитектура проекта в C4
✔️ UML-диаграмма процесса
✔️ Маппинг данных для UI+API+БД
✔️ Коллекция Postman-запросов для KudaGo API и Dahamail API


Проект #CityGA разбираем в поддержку практической программы Интеграции систем 🧩


Готовы получить новый опыт и знания?
Подписывайтесь на GetAnalyst и следите за обновлениями!

Добро пожаловать в проект! 🤝

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

📚 Виды интеграций: полный справочник 📚

1. Синхронные по API (REST, SOAP, GraphQL и другие)
2. Асинхронные по API (Webhook, Polling)
3. Режим реального времени (WebSocket, SSE и другие)
4. Брокеры и очереди сообщений
5. Общая БД
6. Обмен файлами

Полезно иметь под рукой для подготовки к собеседованиям 🤝

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