Przegląd
Prywatny plugin rozdzielający domenę commerce od szczegółów Base Shops API. Zapewnia konfigurowalną warstwę do mapowania danych i uruchamiania synchronizacji w workflow Medusa.
Problem
Bez wydzielonej warstwy integracyjnej mapowanie zamówień, produktów i statusów szybko przenika do logiki sklepu, utrudnia obsługę błędów, ponowienia i rozwój po obu stronach.
Rozwiązanie
Architektura capability/handler izoluje funkcje API i transformacje danych. Konfiguracja, workflow oraz jawne granice synchronizacji pozwalają dopasować wdrożenie bez kopiowania integracji do kodu sklepu.
Moja rola
Zaprojektowałem plugin, kontrakty handlerów, mapowanie danych commerce, konfigurację, workflow synchronizacji oraz strategię obsługi błędów i bezpiecznych ponowień tam, gdzie wspiera je zaimplementowany przepływ.
Architektura
Oficjalny model pluginu Medusa 2 otacza klienta Base Shops API adapterami możliwości. Handlery przekładają dane domenowe, a workflow koordynują kierunek i moment synchronizacji z kontrolowanym raportowaniem błędów.
Wyzwania inżynieryjne
Kluczowe decyzje dotyczą granic odpowiedzialności, stabilnego mapowania identyfikatorów, częściowych awarii API i idempotentnych ponowień. Testy obejmują warstwy możliwe do zweryfikowania bez ujawniania prywatnej konfiguracji.
Rezultaty i obecny status
Powstała reużywalna baza komercyjnych wdrożeń Medusa 2 ↔ Base, oddzielona od historycznego kodu konkretnego sklepu. Zakres końcowy jest konfigurowany do procesu klienta; kod pozostaje prywatny.