Pan Jacek

Poradnik4 min czytania

Jak zbudowałem serwis ogłoszeniowy Denwi: technologie i decyzje

Autor: , fullstack developer z Bydgoszczy

Denwi.pl zbudowałem jako dwie osobne części: stronę w Next.js renderowaną po stronie serwera (żeby Google i asystenci AI widzieli pełną treść bez JavaScriptu) i API w Laravelu z bazą MySQL, Redisem i czatem na WebSocketach. Aplikacja mobilna w React Native korzysta z tego samego API, a całość działa w kontenerach Docker na jednym serwerze VPS z wdrożeniami bez przerwy.

Serwis ogłoszeniowy wygląda prosto: formularz, lista, strona oferty. W praktyce to jeden z bardziej wymagających typów aplikacji, bo łączy wyszukiwarkę, czat, zdjęcia, moderację, SEO tysięcy podstron i aplikację na telefon. Opisuję, z czego zbudowałem Denwi, dlaczego tak, i które decyzje okazały się błędem.

Z czego składa się Denwi

Najważniejsza decyzja zapadła na początku: strona i logika biznesowa są rozdzielone. Strona, którą widzi użytkownik, nie ma własnej bazy danych, tylko pyta API. Dzięki temu aplikacja mobilna dostała te same dane i te same reguły bez pisania czegokolwiek drugi raz.

Stack technologiczny Denwi.pl (październik 2026)
WarstwaTechnologiaPo co
StronaNext.js 16, React 19Renderowanie po stronie serwera, pełna treść dla Google i AI
APILaravel 13, PHP 8.4Ogłoszenia, konta, moderacja, płatności, kolejki zadań
Baza danychMySQL 8Ogłoszenia, użytkownicy, wiadomości
Cache i kolejkiRedis 7Cache kategorii i stron, kolejka zadań w tle
Czat na żywoLaravel Reverb (WebSocket)Nowe wiadomości, „pisze…”, „przeczytane” bez odświeżania
Aplikacja mobilnaReact Native (Expo)Android, później iOS, to samo API co strona
AIModele GeminiWycena rzeczy ze zdjęcia, generator treści ogłoszenia
InfrastrukturaDocker, nginx, GitHub ActionsTesty i wdrożenie po każdym pushu, przełączanie blue-green

Dlaczego renderowanie po stronie serwera

Serwis ogłoszeniowy żyje z wyszukiwarek. Gdyby lista ogłoszeń ładowała się dopiero w przeglądarce, robot Google zobaczyłby pusty szkielet, a roboty asystentów AI, które w większości w ogóle nie uruchamiają JavaScriptu, nie zobaczyłyby nic. Dlatego każda publiczna strona Denwi przychodzi z serwera z gotowym tekstem, cenami i danymi strukturalnymi. Szerzej o tym, jak AI czyta strony, piszę w tekście skąd AI bierze informacje o firmach.

Ceną jest wydajność: każda strona to zapytanie do API. Rozwiązałem to cache'em w trzech miejscach: w Redisie (kategorie, liczniki), w bramie nginx (gotowy HTML stron publicznych) i w przeglądarce (pliki statyczne na rok). Według pomiarów od prawdziwych użytkowników 94% wyświetleń na telefonach ma LCP w normie Google.

Formularz, który zmienia się z kategorią

Samochód potrzebuje marki, modelu, przebiegu i pojemności silnika. Mieszkanie metrażu i piętra. Oferta pracy widełek wynagrodzenia. Zamiast osobnego formularza dla każdej kategorii Denwi ma jeden kreator, a pola dla kategorii opisane są w konfiguracji. Te same pola zasilają filtry na liście, dane strukturalne i aplikację mobilną.

Lekcja, która kosztowała mnie najwięcej: automat sprawdzający ogłoszenie po publikacji nie może być surowszy niż formularz. Kiedy formularz coś przepuścił, a job w tle to odrzucił, użytkownik widział „opublikowano”, a po minucie ogłoszenie znikało. Dziś reguły są w jednym miejscu.

Wdrożenia bez przerwy na jednym serwerze

Denwi działa na jednym serwerze VPS. Na początku wdrożenie oznaczało kilkadziesiąt sekund przerwy i ryzyko, że coś się nie podniesie. Dziś działa układ blue-green: nowa wersja startuje obok starej, przechodzi kontrolę zdrowia, a brama nginx przełącza ruch dopiero wtedy, gdy nowa odpowiada poprawnie. Jeśli coś pójdzie źle, powrót to jedno polecenie.

Dwie awarie nauczyły mnie więcej niż dokumentacja. Raz cache Dockera zapełnił dysk i padła baza w pamięci podręcznej. Innym razem równoległe budowanie strony i API zjadło całą pamięć serwera i trzeba było go zrestartować z panelu. Od tamtej pory skrypt wdrożenia sprząta po sobie, a budowanie idzie po kolei, z limitami pamięci.

Co zrobiłbym inaczej

Gdybym zaczynał od nowa, wcześniej zrobiłbym trzy rzeczy:

  • Adresy ogłoszeń od pierwszego dnia w docelowym formacie (/ogloszenia/kategoria/tytul-miasto-id). Zmiana po starcie wymagała przekierowań 301 i czekania, aż Google przepisze indeks.
  • Pomiar źródła każdego konta i ogłoszenia. Bez tego długo nie wiedziałem, że ChatGPT przysyła ludzi, którzy pobierają wzory umów, a reklamy - ludzi, którzy dodają ogłoszenia.
  • Test SEO w procesie wdrożenia. Dziś CI uruchamia crawler, który zatrzymuje wdrożenie, gdy znajdzie np. artykuł bez daty publikacji albo stronę z błędnym canonical.

Podsumowanie

  • Denwi to strona w Next.js renderowana na serwerze i osobne API w Laravelu, z którego korzysta też aplikacja mobilna.
  • Renderowanie po stronie serwera jest konieczne, bo roboty AI zwykle nie uruchamiają JavaScriptu.
  • Cache w Redisie, w bramie nginx i w przeglądarce daje 94% wyświetleń mobilnych z LCP w normie.
  • Wdrożenia idą w układzie blue-green, bez przerwy, z testami i crawlerem SEO w CI.
Najważniejsze decyzje przy budowie Denwi
DecyzjaDlaczego
Osobne APIStrona i aplikacja mobilna mają te same dane i reguły
SSR zamiast renderowania w przeglądarcePełna treść dla Google i asystentów AI
Pola kategorii w konfiguracjiJeden kreator, filtry i dane strukturalne z jednego źródła
Blue-green na jednym VPSWdrożenia bez przerwy bez kosztów chmury

Najczęstsze pytania

Czy Denwi wciąż się rozwija?
Tak, nowe funkcje trafiają na produkcję co kilka dni. Po ogłoszeniach, kontach i czacie doszły wzory umów, kalkulatory, wycena AI, aplikacja mobilna i program poleceń.
Czy serwis ogłoszeniowy da się postawić na WordPressie?
Mały katalog ogłoszeń tak, z gotową wtyczką. Przy czacie na żywo, aplikacji mobilnej, rozbudowanych filtrach i tysiącach podstron wtyczki szybko stają się ograniczeniem, dlatego Denwi jest pisane od zera.
Dlaczego Laravel, a nie Node.js na backendzie?
Laravel ma gotowe kolejki, harmonogram zadań, autoryzację, WebSockety (Reverb) i dojrzały ekosystem testów. Przy jednym programiście liczy się to, ile rzeczy działa od razu.

O autorze

Jacek Pawlos - fullstack developer z Bydgoszczy

Piszę ten poradnik z perspektywy osoby, która te strony buduje. Od 7 lat robię strony, sklepy i aplikacje webowe w Next.js, React i Laravelu - mam na koncie 10 wdrożonych projektów, od stron firmowych po sklep z konfiguratorem 3D. Kwoty i terminy biorę z własnego cennika; gdy się zmieniają, aktualizuję datę pod tytułem. Więcej o mnie na LinkedInie.

Czytaj dalej

Masz pytanie, którego tu nie ma?

Napisz w dwóch zdaniach, co chcesz zbudować. Odpowiadam w ciągu 24 godzin, a prototyp dostajesz w 48.