Przekazanie gotowej strony klientowi to moment, w którym kończy się projekt, a zaczyna jej codzienne życie. Warto podejść do tego procesu metodycznie: uporządkować pliki i konta, przygotować instrukcje, zadbać o stabilność i bezpieczeństwo, a także jasno opisać, co i w jaki sposób zostało zbudowane. Poniższa instrukcja to praktyczna lista kroków, dzięki której oddasz projekt w sposób profesjonalny, ograniczysz ryzyko i ułatwisz klientowi start w samodzielnym zarządzaniu serwisem.
Przygotowanie merytoryczne i organizacyjne
Zakres, warunki wsparcia i akceptacja
Zacznij od ujednolicenia tego, co zostało dostarczone. Przygotuj spis funkcjonalności, listę integracji, mapę informacji i krótkie streszczenie architektury. Dołącz kryteria akceptacji i status ich spełnienia: co przeszło odbiór, co wymaga poprawek, a co jest zmianą zakresu. Wyraźnie opisz sposób zgłaszania błędów, priorytety, czasy reakcji oraz co obejmuje gwarancja. Podlinkuj repozytorium, środowiska i narzędzia komunikacji.
- Zakres realizacji i daty kamieni milowych
- Lista integracji (płatności, ERP, CRM, mailing, wyszukiwarki, mapy)
- Opis architektury (warstwy, technologie, zależności)
- Matryca odpowiedzialności (kto za co odpowiada po odbiorze)
- Procedura zgłoszeń i eskalacji (kanał, SLA, formularz)
Uzgodnij, czy dalsze prace po odbiorze będą rozliczane w ramach pakietu godzin lub oddzielnej umowy utrzymaniowej. Zaproponuj rozsądny harmonogram przeglądów jakościowych w pierwszych tygodniach po starcie.
Struktura dokumentacji
Zbierz i uporządkuj dokumentacja w jednym miejscu, najlepiej w przestrzeni współdzielonej (wiki, Notion, Confluence lub repozytorium). Zdefiniuj spójny spis treści i nazewnictwo. Każdy rozdział powinien mieć jasny cel, zwięzłe instrukcje i odnośniki do plików źródłowych.
- Przegląd systemu: stos technologiczny, diagramy, przepływy danych
- Instrukcja CMS: edycja treści, media, formularze, role i uprawnienia
- Instrukcja publikacji: pipeline, środowiska, zmienne, klucze
- Instrukcja awaryjna: przywracanie, kontakt do operatorów, RTO/RPO
- Instrukcja rozwoju: standardy kodu, konwencje commitów, przeglądy
Dołącz zrzuty ekranu, krótkie nagrania wideo oraz checklisty. Upewnij się, że instrukcje są aktualne względem wersji wydania, które przekazujesz.
Repozytorium i wersjonowanie
Oddaj kompletną historię Git wraz z tagiem wydania produkcyjnego, opisem releasu i changelogiem. Uporządkuj gałęzie: zamknij tymczasowe feature branches, wyczyść martwe eksperymenty, zmerguj istotne poprawki. Skonfiguruj reguły ochrony głównych gałęzi, przeglądy kodu i obowiązkowe testy przed scaleniem.
- Release notes z listą zmian i znanymi ograniczeniami
- Pliki konfiguracyjne: lintery, formatery, edytory, kontenery
- Szablony PR/Issue, etykiety, automatyzacje (CI/CD)
- Instrukcje uruchomienia lokalnego i na stagingu
Zadbaj o wersjonowanie semantyczne oraz jasny plan utrzymania gałęzi serwisowych, szczególnie gdy projekt wchodzi w fazę gwarancji.
Porządkowanie środowisk i transfer dostępu
Konta, uprawnienia i bezpieczeństwo
Przekaż wszystkie niezbędne dostępy w sposób bezpieczny: menedżer haseł, zaszyfrowane notatki, dedykowane skrzynki serwisowe. Utwórz konta klienta jako właścicieli zasobów i ogranicz swoje uprawnienia do minimum. Włącz 2FA, skonfiguruj logowanie SSO, zdefiniuj politykę haseł i rotację kluczy. Przeglądnij role w CMS, panelu serwera, chmurze i narzędziach marketingowych, aby uniknąć nadmiernych uprawnień.
- Lista kont: domeny, serwer/pojemność, CDN, e‑mail, narzędzia devops
- Rotacja kluczy API i tokenów integracji
- Przegląd ról: admin, edytor, moderator, lektor danych
- Log audytowy: kto ma dostęp, kiedy nadano, kiedy wygasa
Udokumentuj procedurę dodawania nowych użytkowników i odbierania dostępu, aby klient mógł bezpiecznie skalować zespół.
Dane, migracja i kopie zapasowe
Przed przekazaniem wykonaj pełny backup bazy, plików i konfiguracji. Zweryfikuj spójność danych, strefy czasowe, kodowanie, integralność multimediów. Zadbaj o anonimizację danych testowych oraz usunięcie kont tymczasowych. Jeśli przenosisz środowisko, przygotuj plan migracji z oknem serwisowym i procedurą roll-back.
- Weryfikacja integralności: checksums, size diff, porównanie rekordów
- Plan migracji: kroki, czas, odpowiedzialności, punkt decyzyjny
- Trening odtwarzania: przywracanie backupu na świeżym środowisku
- Archiwizacja: retencja, szyfrowanie, lokalizacje, test odczytu
Udostępnij klientowi harmonogram kopii, parametry RPO/RTO i sposób monitorowania zadań backupowych wraz z alertami.
Konfiguracja serwera, DNS i poczta
Spisz konfigurację hosting, w tym parametry PHP/Node, wersje runtime, rozszerzenia, limity, cron, workers, kolejki, cache, CDN, reguły WAF i firewalla. Opisz proces wdrożenia, lokalizację logów oraz rotację. W DNS przygotuj recordy A/AAAA, CNAME, MX, TXT (SPF), DKIM, DMARC i zasady subdomen. Ustal obniżenie TTL na czas przełączenia, aby skrócić propagację.
- Certyfikaty TLS: automatyczne odnawianie, HSTS, redirecty
- CDN: reguły cache, purge, kompresja, HTTP/2 lub HTTP/3
- Poczta transakcyjna: test deliverability, bounces, webhooki
- Logi: dostęp, przeszukiwanie, retencja, alertowanie
Przygotuj checklistę po zmianie DNS: monitoring dostępności, testy formularzy i płatności, weryfikacja certyfikatów, brak mieszanych treści.
Jakość, zgodność i optymalizacja
Testy funkcjonalne i UAT
Uruchom kompleksowe testy: automatyczne (jednostkowe, integracyjne, e2e) oraz manualne według scenariuszy użytkownika. Zadbaj o pokrycie krytycznych ścieżek: rejestracja, logowanie, dodawanie do koszyka, płatności, wyszukiwanie, filtrowanie, wysyłka formularzy, pobieranie plików. Utwórz protokoły z wyników, zrzutami i nagraniami. Przeprowadź UAT z zespołem klienta, zbierz uwagi i zrób krótką sesję poprawkową przed uruchomieniem produkcyjnym.
- Macierz urządzeń i przeglądarek (desktop, tablet, mobile)
- Testy regresyjne po wdrożeniach i hotfixach
- Kontrola e-maili systemowych, linków, załączników
- Walidacja formularzy, stany błędów i pustych wyników
Ustal jasne kryteria zamknięcia UAT i protokół odbioru, aby uniknąć niekończących się poprawek.
Wydajność i Core Web Vitals
Zmierz parametry wydajności w narzędziach syntetycznych i rzeczywistych (Lighthouse, WebPageTest, RUM). Skup się na LCP, CLS, INP i TTFB. Zaimplementuj krytyczne CSS, lazy-loading, preconnect, dns-prefetch, optymalizację obrazów (AVIF/WebP), minifikację i cache. Zadbaj o edge caching na CDN i kompresję. Ustal budżety wydajności i dodaj testy w pipeline, aby utrzymać poziom w kolejnych wydaniach.
- Optymalizacja fontów: subsety, font-display, zmienne fonty
- Prefetch krytycznych danych i hydracja po stronie klienta
- Kontrola bundle: tree-shaking, code splitting, remove dead code
- Server-side rendering lub statyczne generowanie jeśli zasadne
Udokumentuj narzędzia i dashboardy, by klient samodzielnie monitorował metryki po starcie.
SEO techniczne i treściowe
Przygotuj podstawy SEO: poprawne tytuły i meta, hierarchię nagłówków, linkowanie wewnętrzne, alt dla obrazów, sitemap.xml, robots.txt, canonicale, hreflangi (jeśli wielojęzyczność), breadcrumbs i dane strukturalne. Upewnij się, że wersje http i www przekierowują właściwie. Zadbaj o przyjazne adresy URL, paginację i obsługę 404/410. Skonfiguruj narzędzia webmasterów i zgłoś mapy witryny.
- Audyt treści: duplikaty, thin content, brakujące meta
- Przekierowania 301: stara do nowej struktury, mapowanie
- Monitorowanie indeksacji i błędów skanowania
- Parametry UTM i czystość adresów w linkach marketingowych
Dołącz checklistę aktualizacji treści i kalendarz publikacji, aby utrzymać świeżość serwisu i widoczność.
Dostępność i zgodność z WCAG
Sprawdź kontrasty, kolejność fokusu, etykiety formularzy, napisy do wideo, semantykę, obsługę klawiaturą, komunikaty o błędach i role ARIA. Przetestuj z czytnikami ekranu oraz na urządzeniach mobilnych z ułatwieniami dostępu. Udokumentuj poziom zgodności (np. WCAG 2.2 AA) i listę odstępstw wraz z planem naprawy.
- Alternatywy tekstowe dla mediów
- Widoczne stany focus/hover
- Blokada ruchów wywołujących chorobę symulatorową
- Bezpieczne komunikaty i zrozumiała treść błędów
Dodaj sekcję deklaracji dostępności, jeśli dotyczy, oraz proces zgłaszania problemów użytkownikom.
Bezpieczeństwo aplikacji i danych
Oceń bezpieczeństwo według OWASP: walidacja wejścia, ochrona przed XSS, CSRF, SSRF, ograniczenie uploadu, polityki CORS, nagłówki bezpieczeństwa (CSP, HSTS, X-Frame-Options), rate limiting i rejestrowanie incydentów. Zaktualizuj zależności, usuń debug i endpointy testowe. Zaszyfruj dane w spoczynku i w tranzycie, wprowadź politykę retencji i minimalizacji danych.
- Skany SCA/SAST/DAST i raport ryzyk
- Polityka haseł i MFA dla paneli administracyjnych
- Segregacja środowisk i zasad least privilege
- Procedury IR: identyfikacja, ograniczenie, usunięcie skutków
Przygotuj plik security.txt z kontaktem do zgłaszania podatności oraz polityką nagród, jeśli klient tego oczekuje.
Analityka i tagowanie
Skonfiguruj analityka: narzędzie do pomiaru ruchu, menedżer tagów, piksele reklam, zdarzenia i konwersje. Zadbaj o spójne nazewnictwo, parametry UTM i mapę zdarzeń zgodną z celami biznesowymi. Włącz anonimizację IP, ogranicz czas retencji, aktywuj zgody zgodnie z RODO i polityką cookies. Zbuduj dashboard KPI i udostępnij go zespołowi klienta.
- Plan pomiarowy: cele, zdarzenia, źródła danych
- Weryfikacja zgodności z consent mode i CMP
- Testy poprawności danych w trybach prywatności
- Alerty na anomalie ruchu i spadki konwersji
Dodaj instrukcje wdrażania nowych tagów, przeglądów i wersjonowania zmian w menedżerze tagów.
Materiały dla klienta i procedury na przyszłość
Instrukcje, szkolenia i checklisty
Przygotuj krótkie szkolenie z obsługi CMS, publikacji, zarządzania mediami i podstawowego troubleshooting. Udostępnij nagrania, slajdy i zwięzłe karty pracy. Stwórz checklisty: publikacja artykułu, dodanie nowej podstrony, wdrożenie zmian, przygotowanie kampanii, reagowanie na alerty. Zadbaj o przekazanie wiedzy asynchronicznej: baza Q&A, słownik pojęć i ścieżki eskalacji.
- Materiały wideo (2–5 min) do najczęstszych zadań
- Szablony treści, zasady stylu i dostępności
- Checklisty jakości przed publikacją
- Mapa kontaktów i godzin dostępności wsparcia
Ustal termin sesji follow‑up po pierwszym miesiącu, aby odpowiedzieć na pytania i zebrać wnioski z użytkowania.
Plan utrzymania, SLA i komunikacja
Zaprezentuj plan utrzymania z jasno opisanymi zadaniami cyklicznymi: aktualizacje, skany, przegląd logów, weryfikacja kopii, audyty wydajności i dostępności. Zdefiniuj kanały kontaktu, priorytety zgłoszeń i czasy reakcji. Zaproponuj pakiety wsparcia i rozwoju wraz z raportowaniem postępów i statusami incydentów.
- Harmonogram: tygodniowy, miesięczny, kwartalny przegląd
- Szablon raportu: uptime, błędy, wydajność, wnioski
- Matryca priorytetów i czasy reakcji/naprawy
- Proces change request: wycena, akceptacja, realizacja
Ustal też politykę wersjonowania treści i publikacji, aby zachować spójność oraz zgodność z celami biznesowymi.
Plan wdrożenia i awaryjny (roll-back)
Przekazanie powinno zawierać instrukcję, jak wykonać bezpieczne wdrożenie i jak się wycofać w razie problemów. Opisz pre‑deployment checks, smoke testy, migracje bazy, invalidację CDN i weryfikację kluczowych funkcji po starcie. Dołącz checklistę roll-back: warunki uruchomienia, kroki wycofania, reindeksacja, przywrócenie konfiguracji i powiadomienia interesariuszy.
- Okno wdrożeniowe i plan komunikacji (wewnętrznie/publicznie)
- Punkt bezpieczeństwa danych (snapshot bazy, backup mediów)
- Walidacja po starcie: monitoring, logi, formularze, płatności
- Runbook awarii: kto decyduje, kto komunikuje, jak raportować
Wdróż automatyczne testy dymne i health-checki, które uruchomią się po każdej publikacji na produkcję.
Przekazanie praw i licencji
Dopełnij formalności: prawa autorskie do kodu i treści, przeniesienie kont i subskrypcji, a także wykaz zewnętrznych komponentów z warunkami użycia. Opisz dokładnie licencje na grafiki, fonty, wtyczki i biblioteki. Wskaż daty odnowień, koszty oraz odpowiedzialność po przekazaniu. Zadbaj o zgodność z RODO: rejestr czynności, umowy powierzenia, polityka prywatności i cookies.
- Inwentaryzacja komponentów open source (licencje, obowiązki)
- Dowody zakupu i faktury za szablony, wtyczki, banki zdjęć
- Dane rejestrowe domen, kontakt do rejestratora
- Polityki prawne: prywatność, cookies, regulaminy
Przekaż wszystkie klucze aktywacyjne i instrukcje odnowień oraz wskaż ryzyka wyłączeń przy braku płatności.
Na koniec wykonaj wspólne przejście przez materiały i system: sesja live lub nagranie pokazujące, gdzie są pliki, jak zgłaszać zmiany, jak dbać o serwis. Po spotkaniu wyślij protokół przekazania z listą załączników i potwierdzeniem odbioru. Dzięki temu każda strona wie, co zostało zrobione i jak utrzymać wysoką jakość projektu w czasie.
Tomek Bogucki
Tomek Bogucki tworzy treści dla bloga icomSEO: praktyczne poradniki o SEO, reklamie i marketingu internetowym.
