Poradnik4 min czytania
Jak zbudowałem serwis ogłoszeniowy Denwi: technologie i decyzje
Autor: Jacek Pawlos, 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.
| Warstwa | Technologia | Po co |
|---|---|---|
| Strona | Next.js 16, React 19 | Renderowanie po stronie serwera, pełna treść dla Google i AI |
| API | Laravel 13, PHP 8.4 | Ogłoszenia, konta, moderacja, płatności, kolejki zadań |
| Baza danych | MySQL 8 | Ogłoszenia, użytkownicy, wiadomości |
| Cache i kolejki | Redis 7 | Cache kategorii i stron, kolejka zadań w tle |
| Czat na żywo | Laravel Reverb (WebSocket) | Nowe wiadomości, „pisze…”, „przeczytane” bez odświeżania |
| Aplikacja mobilna | React Native (Expo) | Android, później iOS, to samo API co strona |
| AI | Modele Gemini | Wycena rzeczy ze zdjęcia, generator treści ogłoszenia |
| Infrastruktura | Docker, nginx, GitHub Actions | Testy 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.
| Decyzja | Dlaczego |
|---|---|
| Osobne API | Strona i aplikacja mobilna mają te same dane i reguły |
| SSR zamiast renderowania w przeglądarce | Pełna treść dla Google i asystentów AI |
| Pola kategorii w konfiguracji | Jeden kreator, filtry i dane strukturalne z jednego źródła |
| Blue-green na jednym VPS | Wdroż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.