E-commerce · Projekt własny

Vantage Hunting

Demo sklepu i wizerunku dla marki premium sprzętu myśliwskiego i optycznego.

Rok

2026

Platforma

Next.js · Payload CMS

Moja rola

Projekt, kod i wdrożenie, wszystko solo.

Vantage Hunting

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

  1. Architektura: Next.js 16 (App Router) z Payload CMS 3 jako headless backend w tym samym procesie, jedna aplikacja, jeden deployment.
  2. 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.
  3. 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”.
  4. 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.
  5. 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.
  6. 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.

Następna realizacja

Aplikacja mobilna · Cyberbezpieczeństwo

Zaczynamy?

Zacznijmy od rozmowy

Opisz, co chcesz zbudować. W odpowiedzi dostaniesz zakres, cenę i termin. Zapytanie nic nie kosztuje i do niczego nie zobowiązuje.