Z Magento na Medusa.js: runbook migracji B2B
Większość migracji z Magento nie dotyczy platformy. Dotyczy kosztu aktualizacji, długu w rozszerzeniach i logiki B2B rozsianej po pięciu modułach, których nikt nie chce ruszać. Ten runbook pokazuje, jak przejść na Medusa.js i Next.js bez utraty zamówień, klientów i ruchu organicznego.
Weryfikacja merytoryczna: Zespół inżynierski Monkydot
1. Czy w ogóle migrować?
Migruj, gdy koszt pozostania jest widoczny: aktualizacje trwające kwartał, konflikty rozszerzeń, hosting rosnący szybciej niż przychód albo funkcje B2B zamknięte w płatnej edycji Adobe Commerce. Zostań, gdy Magento działa dobrze, zespół je zna, a roadmapa nie stoi.
Headless Magento to sensowna droga pośrednia: Magento zostaje backendem, wymieniasz storefront. To naprawia szybkość frontu, nie koszt aktualizacji ani dług w rozszerzeniach. Jeśli to one są problemem, uczciwą odpowiedzią jest migracja backendu.
- Cykle aktualizacji i łatek regularnie zjadają tygodnie pracy zespołu.
- Krytyczna logika B2B zależy od rozszerzeń firm trzecich.
- Koszt platformy i hostingu na zamówienie stale rośnie.
- Roadmapa czeka na obejścia ograniczeń platformy.
2. Mapowanie pojęć Magento na Medusa.js
Nie migruj tabel. Migruj reguły biznesowe. Magento i Medusa.js inaczej modelują commerce, a mapowanie to miejsce, w którym dzieje się większość pracy projektowej. Medusa.js v2 ma moduły produktów, cen, magazynu, klientów, kanałów sprzedaży i promocji; wszystko ponad to jest własnym modułem lub workflow.
| Magento / Adobe Commerce | Odpowiednik w Medusa.js | Decyzja do podjęcia |
|---|---|---|
| Websites, stores, store views | Kanały sprzedaży i regiony | Które różnice to rynek, marka, a które język |
| Grupy klientów, ceny progowe | Grupy klientów i cenniki | Hierarchia i priorytety cen |
| Shared catalogs, firmy (B2B) | Własny moduł lub wzorce z B2B startera | Kto zarządza kontami firm i rolami |
| Negocjowane oferty, listy zakupowe | Własne workflow | Które procesy są potrzebne na start |
| Atrybuty EAV | Opcje produktu, metadata lub PIM | Gdzie jest master danych produktowych |
| Źródła MSI i stany | Moduł magazynu i lokalizacje | Synchronizacja z ERP real-time czy wsadowa |
| Strony i bloki CMS | Headless CMS lub treści w storefroncie | Kto edytuje treści po starcie |
| URL rewrites | Mapa przekierowań w storefroncie | Które URL-e zachowują strukturę |
3. Etapy migracji i kryteria wyjścia
Prowadź migrację jak operację z kryteriami wyjścia dla każdego etapu, nie jak jedno wielkie wydanie. Każdy etap kończy się czymś, co da się zweryfikować.
| Etap | Wynik | Kryterium wyjścia |
|---|---|---|
| Inwentaryzacja | Rozszerzenia, integracje, URL-e, wolumeny danych | Każde rozszerzenie ma decyzję: zostaje, przepisujemy, usuwamy |
| Model danych | Mapowanie i moduły Medusa.js | Reguły B2B zapisane jako kod i testy |
| Integracje | ERP, PIM, OMS, płatności z kontraktami danych | Rekoncyliacja przechodzi na prawdziwych danych |
| Storefront i SEO | Storefront Next.js, mapa 301, parytet treści | Diff top URL-i: title, H1, canonical, schema |
| Próby generalne | Powtarzalne skrypty migracji | Dwa pełne przebiegi z zgodnymi licznikami |
| Cutover | Etapowe przełączenie ruchu i plan rollbacku | Rollback przetestowany przed startem |
| Stabilizacja | 30 dni monitoringu | Brak niewyjaśnionych spadków zamówień, indeksacji, 404 |
4. Klienci, hasła i historia zamówień
Konta klientów migrują się bez problemu; hashe haseł zwykle nie. Magento i Medusa.js używają innego hashowania, więc zaplanuj kampanię resetu haseł albo własny krok uwierzytelniania, który przy pierwszym logowaniu weryfikuje stary hash i zapisuje nowy. Druga opcja chroni kupców B2B przed blokadą konta w dniu startu.
Historia zamówień rzadko musi być w pełni transakcyjna w nowym systemie. Przenieś to, czego klienci i obsługa faktycznie używają — ponowne zamówienia i faktury — a resztę trzymaj w archiwum tylko do odczytu. Sama ta decyzja potrafi skrócić migrację o tygodnie.
5. Utrzymaj ruch organiczny
Wyeksportuj URL rewrites z Magento i realne strony docelowe z Search Console, zanim ruszy projektowanie. Zachowaj strukturę URL-i, gdzie się da; storefront Next.js może utrzymać końcówki .html i ścieżki kategorii. Tam, gdzie URL się zmienia, każdy stary adres dostaje dokładnie jeden cel 301 bez łańcuchów.
Nawigacja warstwowa generuje tysiące URL-i z parametrami. Zdecyduj, które filtrowane strony zasługują na indeksację, a resztę przekieruj lub kanonikalizuj. Pełny runbook jest w naszej checkliście migracji SEO.
6. Przenosisz się z Shopify Plus?
Migracja z Shopify Plus na Medusa.js jest zwykle prostsza po stronie danych i trudniejsza po stronie oczekiwań. Jest mniej rozszerzeń do rozplątania, ale aplikacje od checkoutu, subskrypcji czy cen B2B trzeba zastąpić własnymi modułami lub integracjami. Struktura URL-i zmienia się częściej, bo ścieżki /products i /collections w Shopify są sztywne — mapa przekierowań ma tu jeszcze większe znaczenie.
7. Harmonogram i budżet
Migracja B2B z integracją ERP, cennikami kontraktowymi i rolami kupujących to zwykle 16–24 tygodnie budowy. Prostszy katalog DTC to zwykle 8–16 tygodni po audycie. Największą zmienną jest jakość danych w systemie źródłowym; wzór na budżet znajdziesz w przewodniku o koszcie wdrożenia Medusa.js.
Najczęstsze pytania
Czy da się przejść z Magento na Medusa.js bez utraty SEO?
Tak, jeśli mapa przekierowań powstaje z danych Search Console przed developmentem, struktura URL-i jest zachowana tam, gdzie to możliwe, treści i dane strukturalne osiągają parytet, a indeksacja jest monitorowana przez 30 dni po przełączeniu.
Czy da się przenieść hasła klientów z Magento?
Zwykle nie bezpośrednio, bo hashowanie się różni. Albo uruchamiasz reset haseł, albo dodajesz własny krok uwierzytelniania, który przy pierwszym logowaniu weryfikuje stary hash Magento i zapisuje nowy.
Czy Medusa.js obsługuje B2B jak Adobe Commerce B2B?
Medusa.js ma w standardzie grupy klientów, cenniki, kanały sprzedaży i magazyn. Konta firmowe, akceptacje i oferty budujemy jako własne moduły lub na wzorcach z oficjalnego B2B startera — modelujesz swoje reguły zamiast dopasowywać się do rozszerzenia.
Ile trwa migracja z Magento na Medusa.js?
Zwykle 16–24 tygodnie budowy dla B2B z integracją ERP i 8–16 tygodni dla prostszego sklepu DTC, po audycie. Dwie pełne próby migracji są częścią planu.
Kto w Europie może przenieść sklep B2B z Magento na Medusa.js?
Szukaj zespołu z działającymi wdrożeniami Medusa.js, doświadczeniem w integracjach ERP i pisemnym planem cutoveru i rollbacku. Monkydot z Polski przenosi sklepy B2B i DTC z Magento i Shopify Plus na Medusa.js i Next.js i zostaje przy utrzymaniu po starcie.