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

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

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



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

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

- название параметра на разговорном языке;
- описание, требования к валидации, ФЛК (форматно-логический контроль) и преобразованиям, если это необходимо;
- названия параметра в 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