💚 Маппинг - это просто 💚

Маппинг - это процесс сопоставления полей (данных) из одной системы с соответствующими полями в другой системе.
Это нужно, так как разные системы могут описывать один и тот же объект данных по-разному.

➡️ Этот процесс всегда необходим в задачах на интеграции.



Маппинг описывают в виде таблицы.
Допустимо делать и в виде структурированного списка, но по опыту - таблицы удобнее.

➡️ В таблице с маппингом делают несколько основных колонок:

- название параметра на разговорном языке;
- описание, требования к валидации, ФЛК (форматно-логический контроль) и преобразованиям, если это необходимо;
- названия параметра в API каждой системы (например, поле из JSON, поле из xml или другого формата сообщения, query из URL и др);
- название параметра в БД системы, если она есть в описании Use Case.
- типы данных в каждой системе / БД.

Допустима вариативность с колонками.
Их может быть больше, а может быть и меньше.



Если говорить про задачу на интеграцию платформы #TravelGA с ВТБ для приема платежей онлайн за экскурсии, то
👉 таблица маппинга под часть задачи "создание платежа в ВТБ методом POST /orders/{orderId}/payments"
будет содержать колонки:

➕ название поля на русском
➕ название поля в API Backend TravelGA (JSON)
➕ название поля в БД TravelGA
➕ название параметра в API системы ВТБ
➕ общее описание поля, требования к его обработке и проверкам
➕ типы данных для API Backend TravelGA, БД TravelGA и API системы ВТБ, но в данной задачи я бы от этой колонки отказалась, т.к. все типы данных очевидны и сложностей быть не должно.



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

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

Это лето как-будто решило выжать из меня максимум: задачи, проекты, встречи, учёба... 🥵🧯

Но в этом потоке есть чёткое ощущение — я двигаюсь в правильную сторону. Именно сейчас.


💡 На следующей неделе начинается учёба в Гарварде по AI.
💡 На июль и август уже запланированы конференции и встречи.

Я учусь внедрять искусственный интеллект в работу и бизнес — не ради моды, ни ради "бумажки", а потому что понимаю: это то, в чём должен разбираться каждый IT-специалист уже в ближайшем будущем.

Что мне нужно сейчас:
— Разобраться с новыми API и протоколами
— Понять, как работают интеграции с AI и для каких кейсов
— Освоить новые инструменты

Вроде всё знакомое.
Это то, что я рассказываю в GetAnalyst 😃
Но в контексте AI — это переход на новый уровень.

Так что сегодня я чувствую себя на 1000% так же, как и наши студенты — всё новое и очень интересное! 😊



💡 + за год я научилась уверенно делать презентации на английском, но мой акцент... в общем 2 раза в неделю занятия по акценту.

Уверенная речь — это тоже часть роста. Это важно в развитии карьеры. Так что продолжаю держать на этом фокус.



И вот сижу и думаю:

Лето — вроде бы пора отпусков. Но именно летом можно сделать такой шаг, который осенью станет заметен всем.

Отдых — важен. Я сама стараюсь находить на него время.
Но и расти в своём деле можно параллельно работе и отпускам — без перегруза, по чуть-чуть.
Главное — с интересом и в своём ритме.


📌 И тогда осенью ты вернёшься не просто отдохнувшим.
Ты вернёшься с новыми знаниями, уверенностью и пониманием, куда двигаться дальше.
И окажешься на шаг впереди тех, кто всё лето просто ждал сентября (а потом января, а потом мая....).



Так что если у вас тоже планы улучшать свои карьерные возможности этим летом, то я с вами на этом пути.

Буду делиться впечатлениями.

Вместе идти проще. И результаты — заметнее 🙌

🔥 Сегодня в 19Мск: онлайн-практикум по миграциям в БД 🔥


📌 Тема:
Разработка требований к миграциям в БД

👉 Записаться на онлайн-практикум


📌 Проект:
Онлайн-маркетплейс

📌 Цель:
Показать, как доработки БД могут влиять на релизы функциональности, научить выстраивать последовательность обновлений базы и показать, на что обращать внимание при переезде с одной СУБД на другую.

📌 План:
1. Определение понятия миграции данных. Примеры.
2. Требования к обратной совместимости данных. Распространенные ошибки.
3. Влияние нефункциональных требований на миграции в БД.
4. Практика проектирования миграций внутри одной БД.
5. Обзор проблем миграций данных между разными СУБД. Практика.
6. Обзор шаблона постановки задачи на разработчиков по миграции данных.


👉 Занятие проводится в рамках подписки на практикумы по БД и SQL. Можно записаться на одно занятие, а можно сразу на всю серию до конца года.

🎁 При подключении у вас есть доступ к дополнительному занятию по проектированию БД с нуля на 2 недели.


Вопросы? Мы на связи!
Пишите @getanalyst или info@getanalyst.ru

До встречи онлайн, в 19Мск! 🙌

📗 12 API терминов, которые должен знать каждый СА, прежде чем идти на собеседования 📗

1. API (Application Programming Interface)
2. REST API (Representational State Transfer)
3. HTTP-методы запросов
4. Эндпоинты
5. Коды ответов
6. Ограничение частоты запросов (Rate Limiting)
7. Полезная нагрузка (Payload)
8. Заголовки (Headers)
9. Аутентификация
10. Авторизация
11. Пагинация
12. Кэширование


Дополнительно:
1. OAuth
2. JWT Token
3. API Gateway
4. API Keys
5. Basic Authentication
6. Bearer Tokens
7. CORS
8. Webhooks
9. OpenAPI
10. API Versioning (Версионирование API)
11. Content Negotiation
12. Query Parameters
13. Path Parameters
14. API Documentation
15. API Monitoring
16. Throttling
17. Circuit Breaker
18. Idempotency (Идемпотентность)
19. API Proxy
20. Retry Logic (Логика ретраев / повторов)
21. Batch Processing (Пакетная обработка)
22. API Security
23. Health Checks
24. API Testing
25. Mock APIs
26. API Marketplace
27. API Schema
28. Semantic Versioning (Семантическое версионирование)
29. Hypermedia
30. API Deprecation (Устаревание API)


Вроде бы всё самое важное и нужное на месте 😎

#RestApiGA

📚 Заполненный образец постановки задачи на интеграцию с платёжной системой ВТБ 📚

В июне мы разбирали проект #TravelGA, в котором для бронирования и оплаты экскурсий нужно было подключить платёжную систему ВТБ.


👉 Что подготовили разрабочикам для её реализации:

✅ Полный интеграционный Use Case: Пользователь → Frontend → Backend → БД → ВТБ
✅ Требования к двум интеграционным REST API методам
✅ UML Sequence с исходным кодом для PlantUML
✅ Дизайн UI
✅ Маппинги данных
✅ Базовые требования к логированию и мониторингу



👉 Процесс системного анализа задачи на интеграцию:

1️⃣ Провели анализ API-документации ВТБ
Часть 1
Часть 2


2️⃣ Среди типовых Use Case к интеграции с платежной системой выделили ключевые Use Case:
+ создание транзакции
+ проверка статуса платежа
+ подтверждение оплаты через WebHook
И объединили их в единый сценарий от старта до завершения оплаты.


3️⃣ Сделали схему архитектуры проекта, чтобы понимать, как будут идти данные между компонентами системы.


4️⃣ Провели исследовательское тестирование API ВТБ, чтобы понять как он работает и осознать процесс интеграции с платежной системой на практике.
Обязательный этап перед написанием требований.


5️⃣ Разработали интеграционный Use Case.
Дополнили его UML Sequence диаграммой.


6️⃣ Познакомились с понятием маппинга, который необходим для корректной трансформации и передачи данных между системами.


7️⃣ Уточнили, что требования к авторизации запросов в ВТБ будут в отдельной статье, а не в описании интеграционного Use Case на оплату.


8️⃣ Собрали общую постановку задачи на интеграцию с платжной системой ВТБ.



👉 Выгруженный документ из Confluence прикреплён к посту.


Эта задача — пример того, как системный аналитик превращает сырую идею "нужно подключить оплату в приложение" в продуманный, проверенный и реализуемый интеграционный процесс.

Мы не просто написали "подключите ВТБ", а оформили требования так, чтобы разработчики смогли реализовать их без лишних вопросов.


Сохраняем в копилку примеров документации 🤝


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