Migracja Next.js / Astro w Szczecinie

Prowadzisz w Szczecinie firmę, której strona stoi na WordPressie, Joomli, Drupalu albo frameworku sprzed dekady, i każda aktualizacja to ryzyko? Przenoszę takie serwisy na Astro lub Next.js tak, żeby adresy, pozycje w Google i formularze przetrwały zmianę. Pracuję sam, więc plan, mapę przekierowań i decyzje po starcie omawiasz bezpośrednio ze mną.

#Czy moja strona naprawdę potrzebuje migracji?

Nie zawsze. Jeśli strona jest wolna przez kilkanaście zbędnych wtyczek, brak cache i nieskompresowane zdjęcia, taniej jest uporządkować obecną instalację. Migrację proponuję, gdy problem siedzi w samym systemie: motyw, którego nikt już nie rozwija, wersja PHP, na której hosting przestaje działać, CMS bez łatek bezpieczeństwa albo redakcja, która przy każdej publikacji walczy z panelem.

Zanim cokolwiek wycenię, mierzę stan wyjściowy: Core Web Vitals z danych terenowych w Search Console, czas odpowiedzi serwera, listę wtyczek i rozszerzeń z datą ostatniej aktualizacji oraz to, kto i jak często edytuje treści. Ten pomiar wraca po migracji jako punkt odniesienia.

Astro wybieram, gdy strona to głównie treść, bo domyślnie wysyła gotowy HTML bez zbędnego JavaScriptu. Next.js, gdy potrzebny jest panel klienta, logowanie albo dane odświeżane na bieżąco.

#Jak przenoszę stronę, żeby nie stracić ruchu z Google?

Każdy etap kończy się sprawdzeniem, które da się powtórzyć:

1. Pełna lista adresów. Łączę mapę witryny, crawl, logi serwera i eksport z Search Console. Stare adresy z linkami zewnętrznymi często nie występują w mapie witryny, a to one niosą najwięcej wartości.
2. Mapa przekierowań. Każdy adres dostaje jedną z trzech decyzji: zostaje bez zmian, dostaje 301 na nowy odpowiednik albo świadomie znika z kodem 410. Na kopii testowej skrypt sprawdza, czy nie powstały łańcuchy ani pętle przekierowań.
3. Model treści. Wpisy, strony, kategorie, pola niestandardowe i autorów przenoszę do typowanych kolekcji. Schemat odrzuca rekord bez tytułu, opisu albo daty, zanim trafi na produkcję. Shortcody i widżety starego CMS-a wyszukuję w eksporcie i dla każdego typu ustalam, jak wygląda po zmianie.
4. Meta i dane strukturalne. Tytuły, opisy, canonical, Open Graph i JSON-LD porównuję automatycznie, stary i nowy adres obok siebie.
5. Formularze i integracje. Formularz kontaktowy, płatności, newsletter i CRM testuję osobno, bo właśnie one najczęściej psują się po cichu.
6. Przełączenie. Małą stronę przełączam jednego dnia. Większą sekcja po sekcji, z reverse proxy albo regułami na brzegu sieci, dzięki czemu stara wersja obsługuje resztę ruchu, dopóki nowa nie przejdzie testów.
7. Po starcie. Zgłaszam nową mapę witryny, przeglądam raport indeksowania w Search Console, wyłapuję 404 z logów i porównuję kliknięcia najważniejszych podstron z okresem sprzed zmiany.

#Co najczęściej psuje się po migracji?

Cztery rzeczy powtarzają się najczęściej: adres bez przekierowania, canonical wskazujący stary adres, zgubione dane strukturalne i znacznik noindex zostawiony po testach. Wszystkie wykrywa porównanie dwóch crawli: kopii testowej przed przełączeniem i produkcji zaraz po nim. Sprawdzam kody odpowiedzi, canonical, meta robots, nagłówki H1 i linki wewnętrzne.

Spadek widoczności w pierwszych tygodniach bywa normalny, bo Google przelicza adresy od nowa. Dlatego oceniam wynik po porównaniu okresów, a nie po jednym dniu.

#Co jest inne w migracji strony firmy ze Szczecina?

Szczecin to stolica i największe miasto województwa zachodniopomorskiego, według danych z 31 grudnia 2025 r. liczy 383 786 mieszkańców. Granica polsko-niemiecka jest 5 km od granicy miasta. W mieście działa port morski, stocznie remontowe i jachtowe, a ruch lotniczy obsługuje Port Lotniczy Szczecin-Goleniów, około 47 km od centrum. Działa tu pięć uczelni publicznych, w tym Uniwersytet Szczeciński, Zachodniopomorski Uniwersytet Technologiczny i Politechnika Morska.

Z tego wynikają trzy sytuacje, które przy migracji traktuję osobno:

• Strona w dwóch językach. Bliskość Niemiec sprawia, że część firm prowadzi wersję niemiecką obok polskiej. Przy migracji to najdelikatniejszy element: każda para musi mieć wzajemne tagi hreflang, a adresy obu wersji muszą przetrwać zmianę. Wzajemność sprawdzam skryptem, bo tagi, które wskazują tylko w jedną stronę, Google ignoruje. Strona tylko po polsku hreflangu nie potrzebuje.
• Firmy z branży morskiej i portowej. Ich strony to zwykle katalog usług, karty techniczne w PDF i formularz zapytania. Pliki PDF mają często linki z zewnątrz, więc zachowuję ich adresy albo dodaję dla nich przekierowania. Dla takiego serwisu Astro jest naturalnym wyborem.
• Jednostki publiczne. Serwisy jednostek sektora finansów publicznych i innych podmiotów wymienionych w ustawie z 4 kwietnia 2019 r. o dostępności cyfrowej stron internetowych i aplikacji mobilnych podmiotów publicznych muszą spełniać jej wymagania, więc dostępność jest wymaganiem projektu od pierwszego dnia, a nie poprawką po starcie.

#Port, stocznie i strony firm morskich

Według Wikipedii w gospodarce morskiej Szczecina pracuje 13 279 osób, port jest portem macierzystym Polskiej Żeglugi Morskiej i Euroafrica, a działają tu stocznie remontowe: Szczecińska Stocznia Remontowa Gryfia, Stocznia Pomerania, Grupa Stoczni Odra i Stocznia Wulkan. To wiedza z publicznych opisów miasta, a nie lista klientów. Pokazuje, jaki typ stron pojawia się w regionie: serwis firmy usługowej, która sprzedaje kompetencje, certyfikaty i dostępność.

Taka strona ma cztery cechy wspólne. Odbiorcą jest często zagraniczny armator, agent albo dział zakupów, więc wersja angielska nie jest dodatkiem. Treść opiera się na dokumentach: certyfikatach, kartach technicznych, referencjach i opisach zakresu usług. Pliki PDF bywają linkowane z maili, ofert i katalogów branżowych, więc ich adresy muszą przetrwać zmianę systemu. Formularz zapytania ma być prosty i dawać jasną odpowiedź, kto i kiedy się odezwie.

Na tym tle migracja do Astro ma trzy konkretne zadania:

1. Zachowanie adresów dokumentów. Spis plików bibliotece mediów łączę z logami serwera i raportem linków zewnętrznych. Plik, do którego ktoś linkuje, zostaje pod tym samym adresem albo dostaje 301 na nową wersję. Nie zmieniam nazw plików tylko dlatego, że nowy system ma inną konwencję.
2. Parytet językowy. Każda strona w wersji polskiej ma odpowiednik angielski albo świadomą decyzję, że go nie ma. Kolekcje mają wspólny schemat, więc brak pola w jednym języku zatrzymuje build zamiast skończyć się pustą sekcją.
3. Wyszukiwarka dokumentów. Jeśli serwis ma archiwum certyfikatów lub kart, przenoszę je do kolekcji z polami typu, daty ważności i numeru. Wyszukiwanie działa wtedy po stronie klienta na zbudowanym indeksie, bez zapytań do bazy.

#Polski i niemiecki obok siebie: hreflang w praktyce

Granica z Niemcami jest według Wikipedii około 5 km od granicy miasta, a w 1843 roku Szczecin dostał połączenie kolejowe z Berlinem, które dało początek kolei na Pomorzu. Region od dawna działa w dwóch językach, więc przy migracji spotykam serwisy, w których wersja niemiecka powstała jako druga instalacja WordPressa albo jako zbiór stron zduplikowanych ręcznie.

Najczęstsze błędy w takich serwisach są powtarzalne:

• Brak wzajemności. Strona polska wskazuje niemiecką, ale niemiecka nie wskazuje polskiej. Google ignoruje taką parę, więc wersje konkurują ze sobą w wynikach.
• Wskazanie na adres, który przekierowuje. Po migracji tag hreflang wskazuje stary adres, który zwraca 301. Pary powinny wskazywać adresy kanoniczne ze statusem 200.
• Automatyczne przekierowanie według języka przeglądarki. Robot wyszukiwarki zwykle nie wysyła nagłówka języka, więc widzi tylko jedną wersję i nie dociera do drugiej. Zamiast tego proponuję widoczny przełącznik języka i zapamiętanie wyboru użytkownika.
• Rozjechane adresy. Wersja polska ma adres opisowy, a niemiecka numer. Mapa przekierowań i kolekcje muszą obejmować oba języki w jednym arkuszu, żeby decyzja o jednej wersji nie zostawiła drugiej bez odpowiednika.

W Astro trzymam każdą wersję językową jako osobną kolekcję z tym samym schematem i polem identyfikującym grupę tłumaczeń. Skrypt po każdym buildzie czyta wszystkie strony, buduje pary i sprawdza trzy rzeczy: czy każda strona wskazuje samą siebie, czy wskazuje odpowiednik i czy ten odpowiednik wskazuje ją z powrotem. Błąd zatrzymuje wdrożenie.

#Angielski dla armatorów i klientów zza Bałtyku

Z lotniska Szczecin-Goleniów, około 47 km od centrum, według Wikipedii odbywają się stałe połączenia między innymi do Londynu, Liverpoolu, Dublina, Oslo i Bergen. Nie traktuję tego jako dowodu na to, kto czyta twoją stronę, bo tę wiedzę daje dopiero Search Console. Traktuję to jako powód, żeby przed migracją sprawdzić, z jakich krajów faktycznie przychodzi ruch i czy angielska wersja odpowiada na pytania, które zadają te osoby. Jeśli raport pokazuje, że angielski wchodzi z kilku krajów naraz, a wersja niemiecka dostaje niewielki ruch, rekomenduję inwestycję tam, gdzie jest popyt, a nie tam, gdzie wygodnie jest mieć flagę w nawigacji.

#Strony wydarzeń żeglarskich i sezonowych

Szczecin gościł finały regat The Tall Ships’ Races w sierpniu 2007 roku i w sierpniu 2013 roku, a organizatorzy pierwszej edycji deklarowali, że teren zlotu odwiedziły 2 miliony ludzi. Duże wydarzenia, festiwale, regaty i targi mają zwykle własne serwisy, które powstają na sezon i potem zostają w sieci jako archiwa.

Przy takich stronach najczęściej widzę dwa błędy. Pierwszy to usunięcie serwisu po wydarzeniu. Strona mogła mieć linki z mediów i blogów, więc po jej zniknięciu zostaje seria błędów 404. Drugi to zostawienie jej bez zmian, z ofertą biletów i hasłem “zapraszamy” na termin, który minął.

Wzorzec, który stosuję, jest prosty. Każda edycja wydarzenia ma stały adres z rokiem, na przykład /regaty/2027/. Edycja, która się skończyła, dostaje oznaczenie archiwalne, bez przycisków sprzedaży i z linkiem do bieżącej edycji. Stały adres bez roku, /regaty/, prowadzi do najnowszej edycji i ma canonical wskazujący samego siebie. Dane programu trzymam w jednym pliku, który można zaktualizować bez ruszania szablonu. Dzięki temu w roku następnym wystarczy dodać nową edycję, a poprzednie zachowują wartość, którą zbudowały.

#Strefy ekonomiczne i produkcja

W granicach miasta działa podstrefa Szczecin Specjalnej Strefy Ekonomicznej Euro-Park Mielec, według Wikipedii z 8 kompleksami o łącznej powierzchni 93,84 ha, oraz od 2013 roku podstrefa Kostrzyńsko-Słubickiej Specjalnej Strefy Ekonomicznej. Wikipedia wymienia wśród zakładów produkcję elementów nośnych, osłon przeciwsłonecznych i osprzętu elektroinstalacyjnego. To przykład branż, w których strona jest katalogiem i punktem pierwszego kontaktu dla zakupowców.

Dla takiego serwisu migracja jest dobrym momentem na uporządkowanie struktury katalogu. Ustalam z tobą, które grupy produktów mają osobne strony kategorii, które parametry są filtrami, a które tylko opisem, i jak wygląda strona produktu, żeby wyszukiwarka dostała jedno główne zapytanie na adres. W starym serwisie często widzę kilkanaście wariantów tej samej strony produktowej z parametrami sortowania i filtrowania w adresie. Przy migracji jedna z nich staje się stroną kanoniczną, a pozostałe dostają 301 albo znacznik canonical.

Formularz zapytania ofertowego przenoszę razem z logiką wyboru produktów. Jeśli zapytanie ma automatycznie zawierać wybraną pozycję, testuję to na kopii z prawdziwymi danymi, bo właśnie w tym miejscu psują się integracje z CRM.

#Uczelnie i projekty z okresem ważności

W mieście działa pięć uczelni publicznych. Wikipedia wymienia Uniwersytet Szczeciński, Zachodniopomorski Uniwersytet Technologiczny (powstał 1 stycznia 2009 roku z połączenia Politechniki Szczecińskiej i Akademii Rolniczej), Politechnikę Morską i Pomorski Uniwersytet Medyczny. Strony projektów badawczych, konferencji i inicjatyw studenckich mają zwykle jedną cechę: kończą się wraz z finansowaniem albo kadencją zespołu, a ich treść zostaje potrzebna jeszcze długo.

W takich serwisach pilnuję trzech rzeczy. Strona zakończonego projektu zostaje, jeśli ma linki zewnętrzne lub cytowania, ale zmienia status na archiwalny i dostaje datę zakończenia w widocznym miejscu. Lista publikacji i uczestników trafia do kolekcji, a nie do ręcznie utrzymywanego wpisu, więc zespół może ją uzupełniać po latach. Adres osoby w zespole nie zawiera roku ani funkcji, żeby awans albo zmiana stanowiska nie psuły linków.

#Co sprawdzam przed przełączeniem strony dwujęzycznej

Dla serwisu z wersją polską i niemiecką używam krótkiej listy kontrolnej, którą powtarzam dla każdej migracji:

1. Liczba adresów obu językach zgadza się z arkuszem mapy i z mapą witryny.
2. Każda para ma wzajemne tagi hreflang, a oba adresy zwracają 200.
3. Tagi canonical wskazują adres własny, a nie wersję w innym języku.
4. Formularze działają w obu językach i wysyłają potwierdzenie w języku, w którym zostały wypełnione.
5. Dane strukturalne mają inLanguage zgodny z wersją, a nazwa organizacji jest taka sama w obu.
6. Mapa witryny zawiera wszystkie adresy kanoniczne, a stare adresy znikają z niej w dniu przełączenia.
7. Pliki do pobrania działają pod dawnymi adresami albo mają przekierowanie.

Ostatni punkt dotyczy głównie firm z branży morskiej i produkcyjnej. Jeśli któryś punkt nie przechodzi, przełączenie czeka, aż naprawię przyczynę, a nie tylko objaw w jednym adresie. Wynik listy zapisuję w repozytorium, więc po starcie można do niego wrócić.

#Jakie przepisy trzeba sprawdzić przy okazji migracji?

Dane z formularzy i narzędzi analitycznych to dane osobowe, a skargi w tym zakresie rozpatruje Prezes Urzędu Ochrony Danych Osobowych. Migracja nie zmienia obowiązków, ale wymusza ich przegląd: sprawdzam, dokąd trafiają dane z formularzy i co wysyłają osadzone skrypty, a w dokumentacji zapisuję, kto ma do nich dostęp.

Stronę firmową z formularzami obejmuje ustawa z 18 lipca 2002 r. o świadczeniu usług drogą elektroniczną. Sklepy internetowe powinny dodatkowo sprawdzić ustawę z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze, obowiązującą od 28 czerwca 2025 r. Dotyczy ona usług handlu elektronicznego, czyli zawierania umów z konsumentem przez stronę lub aplikację, i wymaga między innymi, żeby identyfikacja, płatność i zabezpieczenia na ścieżce zakupu były postrzegalne, funkcjonalne, zrozumiałe i kompatybilne. Nie stosuje się jej do usług mikroprzedsiębiorców. Nie jestem prawnikiem: czy Twoja firma jest objęta, potwierdza Twój doradca. Moja rola to zbudować ścieżkę zakupu tak, żeby ten wymóg dało się spełnić bez przebudowy.

#Co zostaje u mnie, a co u Ciebie po migracji?

U Ciebie zostaje wszystko: kod w Twoim repozytorium, zmienne środowiskowe, pipeline wdrożeniowy i krótki opis publikowania zmian. Hosting dobieramy razem; strona statyczna może działać na prostym hostingu albo w sieci CDN, a miejsce przechowywania danych z formularzy ustalam przed wdrożeniem. Po starcie poprawiam błędy krytyczne i przeglądam wydajność po pierwszym szczycie ruchu. Pełny zakres opisuję na stronie o migracji do Astro i Next.js, a sposób pracy z samym frameworkiem na stronie programista Astro.

#Jak zacząć?

Wyślij mi adres obecnej strony, nazwę CMS-a z wersją, informację, skąd przychodzi ruch (wyszukiwarka, reklamy, polecenia, Search Console, jeśli masz dostęp), wersje językowe i listę integracji: formularze, płatności, CRM. Odpowiadam pisemnym zakresem: który framework i dlaczego, co przenoszę, jak mapuję adresy i co sprawdzam po starcie. Wycena wynika z zakresu, nie odwrotnie.