Этапы работы
Сначала мы оперативно изучили интеграционную документацию клиента. При проработке опирались сразу на два документа:
— со стороны клиента (руководство по разработке и отладке интеграции с коннектором);
со стороны Cainiao (документ, описывающий API-интеграцию).
В процессе изучения документации провели несколько интервью с заказчиком. На основе скрининга и обработки документации составили модель данных. Далее были подготовлены прототипы будущей интеграционной шины.
Следующими этапами стали:
описание кабинета логирования запросов. Возможность логирования — важный пункт в работе системы, так как обеспечивает клиенту безопасность и минимизирует возможную потерю данных;
подготовка дополнительного функционала;
проработка логики работы;
описание маппинга данных для корректной коммуникации систем;
разработка интеграционные схемы.
Позже проработали другие системы данных:
хранение всех пользователей;
хранение данных об отправлениях;
хранение данных о параметрах посылки;
хранение данных о доставке груза.
Подготовили user-кейсы — описали, как должны общаться между собой API Cainiao и API клиента с заданным для этого атрибутом. Интеграционная шина должна обрабатывать входящие запросы Cainiao и запрашивать данные со стороны клиента.
Данные, которые необходимо было обрабатывать:
доставка на склад продавца;
обновление данных по доставке;
отправление статуса доставки;
актуализация сроков отправления.
На этапе проектирования интеграционной шины возникали дополнительные вопросы. При этом основная сложность в работе над проектом была связана с тем, что логику работы системы необходимо было согласовывать с двумя сторонами одновременно. Например, для работы системы нужно было запросить стоимость доставки у логистического партнера, а уже после этого соотнести с данными на стороне клиента.