W skrócie
- Stack: Next.js 16
- CMS: Payload 3
- Model 3D: React Three Fiber
Wyzwanie
Chciałem sprawdzić, czy da się zbudować sklep, który wygląda i działa jak dla marki premium. To demo, bez klienta i bez zdjęć produktowych. Wyzwaniem było wizerunkowe Hero z interaktywnym elementem, który od pierwszej sekundy pokazuje precyzję i nie zwalnia słabszego sprzętu, plus ścieżka zamówienia (konta, koszyk, zamówienia, stan magazynowy) i dział wiedzy edytowalny bez pomocy programisty. Płatności online, wysyłka i e-maile transakcyjne zostały poza zakresem demo.
Rozwiązanie
Next.js 16 (App Router) z Payload CMS 3 jako headless backendem w tym samym procesie: jedna aplikacja, jeden deployment, bez osobnego serwera CMS. W Hero interaktywny model 3D lunety (React Three Fiber) rozkłada się na części i kręci samoczynnie; przy braku WebGL albo gdy liczba klatek spada poniżej progu, pokazuje się statyczny wariant. Ceny i dostępność liczy serwer, a dane cenowe z przeglądarki są ignorowane. Aplikacja działa w Dockerze (multi-stage, użytkownik bez uprawnień roota), z CI na GitHub Actions i wdrożeniem przez Portainer za Nginx Proxy Manager.
Proces
- Architektura: Next.js 16 (App Router) z Payload CMS 3 jako headless backend w tym samym procesie, jedna aplikacja, jeden deployment.
- Katalog produktów, koszyk i zamówienia gościa oraz konta klientów (historia zamówień, zapisane adresy). Zamówienie dostaje numer i jeden z siedmiu statusów; płatności online nie ma.
- Warstwa wizualna: model 3D lunety w React Three Fiber w Hero, animowane tło canvas 2D reagujące na kursor, mikro-tilt na kafelkach kategorii, z poszanowaniem ustawienia „ogranicz ruch”.
- Konteneryzacja (Docker, multi-stage build) i CI na GitHub Actions (lint, build, obraz); wdrożenie przez Portainer za Nginx Proxy Manager. Migracje bazy uruchamiają się same przy starcie kontenera.
- Przegląd własnego kodu w trakcie budowy panelu klienta: wykryty i naprawiony wyciek, w którym zalogowany klient mógł odczytać dane innych klientów i ich zamówienia.
- Optymalizacja po pomiarze Lighthouse: warstwa 3D była głównym źródłem blokowania wątku, więc ładuje się leniwie, po zdarzeniu load i bezczynności przeglądarki, z lżejszym renderem. Układ sprawdzony od 320 px wzwyż.
Jak to wygląda
Pierwsze pięć obrazów to zrzuty z działającej wersji demo, ostatnie trzy to makiety z przykładowymi danymi (zmyślone produkty i klient).








Co potrafi
- Interaktywny model 3D. Luneta w Hero (React Three Fiber) rozkłada się na części i obraca samoczynnie. Bez WebGL albo przy słabym sprzęcie zastępuje ją statyczny wariant.
- Katalog i stan magazynowy. Produkty z kategoriami, wariantami i specyfikacją techniczną; dostępność sprawdzana w przeglądarce i ponownie, autorytatywnie, na serwerze przy składaniu zamówienia.
- Koszyk, zamówienia i konta. Zamówienia gościa oraz konta klientów: rejestracja, logowanie, historia zamówień, zapisane adresy, „zamów ponownie”. Ceny liczy serwer. Bez płatności online.
- Dział wiedzy z CMS. Blog techniczny sterowany z panelu Payload: kategorie, artykuły i obrazy dodaje się bez dotykania kodu.
- Sekcje marketingowe z CMS. Hero, „Manifesto” i „Przewaga Vantage” edytowalne z panelu admina, bez zaglądania do kodu strony.
- Formularz kontaktowy i newsletter. Wiadomości i zapisy trafiają do CMS, ze statusem obsługi. Bez wysyłki e-maili.
- SEO z CMS. Mapa strony generowana z katalogu, artykułów i kategorii, dane strukturalne Product i Offer na stronie produktu, tagi Open Graph.
- Tło reagujące na kursor. Animowana „cyfrowa topografia” w tle (canvas 2D) reaguje na ruch kursora, świadomie bez WebGL, bo druga ciężka scena 3D nie miała uzasadnienia wydajnościowego.
Dane techniczne
- Stack: Next.js 16 (App Router, TypeScript), React 19
- CMS: Payload CMS 3 (headless, w tym samym procesie)
- Baza danych: PostgreSQL 16, migracje przy starcie
- Styling: Tailwind CSS v4
- Infrastruktura: Docker (multi-stage, standalone), Portainer, Nginx Proxy Manager
- CI: GitHub Actions: lint, build i obraz Dockera
- Zakres demo: bez płatności online, e-maili transakcyjnych i testów automatycznych
Prywatność
W trakcie budowy panelu klienta znalazłem i naprawiłem wyciek danych: błąd w API pozwalał zalogowanemu klientowi odczytać dane innych klientów i ich zamówienia. To demo, więc nie ma w nim klientów ani płatności, a produkty w katalogu są fikcyjne.
