Po co piszemy o technologii

Jedną z naszych wartości jest przejrzystość. Chcemy, żebyś wiedział nie tylko CO robimy, ale też JAK. A poza tym, może ktoś z Was chce zbudować podobne narzędzie dla innego sektora? Dzielimy się wiedzą.

Stack technologiczny

Frontend: Next.js 16 z App Router

Co to jest: Next.js to framework do React, rozwijany przez Vercel. Pozwala budować szybkie, SEO-friendly strony.

Dlaczego wybraliśmy:

• Server-side rendering (SSR), strony ładują się szybko, są indeksowane przez Google
• App Router, nowoczesna architektura z React Server Components
• Świetny developer experience
• Darmowy hosting na Vercel dla projektów open source

Dla nietechników: Dzięki Next.js strona ładuje się błyskawicznie i jest widoczna w Google.

Styling: Tailwind CSS

Co to jest: Framework CSS z podejściem „utility-first" — zamiast pisać własne klasy, składasz style z gotowych klocków.

Dlaczego wybraliśmy:

• Szybkie prototypowanie
• Spójny design system
• Mały rozmiar końcowego CSS
• Ogromna społeczność i dokumentacja

Baza danych: Neon Postgres (Frankfurt, UE)

Co to jest: Neon to managed Postgres w modelu serverless, hostowany w chmurze AWS. Używamy regionu EU Central 1 (Frankfurt).

Dlaczego wybraliśmy:

• Standardowy Postgres — żadnego vendor-specific SQL, w razie czego przenosimy się gdziekolwiek
• Serwery w UE (Frankfurt) — zgodność z RODO, dane nie opuszczają EOG
• Connection pooling out of the box (Neon serverless driver przez HTTP)
• Atomic upserty dzięki ON CONFLICT DO UPDATE — żadnych race condition przy zliczaniu zapytań
• Darmowy tier dla małych projektów (0.5 GB storage)

Dla nietechników: Wasze konta, historia rozmów i dzienne liczniki zapytań trzymamy w bazie Postgres w Niemczech. Standardowa, sprawdzona od dekad technologia.

AI: Groq API z modelami open-weight

Co to jest: Groq to firma oferująca ultra-szybką infrastrukturę do AI. Używamy ich API z modelami GPT-OSS 120B (od OpenAI/Meta) oraz Llama 3.3 70B (od Meta).

Dlaczego wybraliśmy:

• Najszybsza inferancja na rynku (dosłownie — tysiące tokenów/s)
• Modele open-weight, możemy je w razie czego pobrać i hostować sami
• Darmowy tier dla developerów
• API zgodne ze standardem OpenAI (łatwa integracja)

Dla nietechników: Gdy piszesz pytanie, Groq je przetwarza i odpowiada w ułamku sekundy.

Hosting: Vercel

Co to jest: Platforma do hostowania aplikacji webowych, stworzona przez twórców Next.js.

Dlaczego wybraliśmy:

• Automatyczne deploymenty — push do GitHub = nowa wersja na żywo
• Global Edge Network, strona serwowana z najbliższego serwera
• Darmowy hosting dla projektów hobby / open source
• Integracja z Next.js jest idealna (ten sam zespół!)

Dla nietechników: Vercel sprawia, że strona działa szybko na całym świecie.

CMS: markdown w repozytorium Git

Co to jest: Wpisy blogowe, FAQ, dane zespołu — wszystko jako pliki .md i .ts w katalogu src/content/ naszego repozytorium na GitHubie.

Dlaczego wybraliśmy:

• Zero zewnętrznych zależności (mniej rzeczy, które mogą się zepsuć)
• Wersjonowanie treści przez git — każda zmiana ma historię, da się cofnąć
• Edytowanie w dowolnym edytorze (VS Code, IDE, nawet przeglądarka GitHub)
• Pełnotekstowe wyszukiwanie po treści w sekundę (grep)
• Darmowe, dopóki repo żyje

Dla nietechników: Aktualizacja blogu to commit do git zamiast klikania w zewnętrznym narzędziu. Mniej ruchomych części.

Architektura systemu

Przepływ danych:

Użytkownik → Vercel Edge Network → Next.js App → Neon Postgres (baza) + Groq API (AI)

1. Użytkownik wchodzi na stronę
2. Vercel serwuje stronę z najbliższego serwera edge
3. Next.js renderuje interfejs
4. Gdy użytkownik pisze pytanie, idzie do Groq
5. Historia konta i rozmów zapisuje się w Neon Postgres

Dlaczego open source jest ważny

Większość narzędzi, których używamy, jest open source albo open-weight:

• Next.js — MIT License
• React — MIT License
• PostgreSQL (silnik bazy) — PostgreSQL License (BSD-like)
• Drizzle ORM (klient bazy) — Apache 2.0
• GPT-OSS 120B / Llama 3.3 — open weights (OpenAI / Meta Llama License)
• Tailwind CSS — MIT License

Co to oznacza:

• Przejrzystość — można sprawdzić kod
• Bezpieczeństwo — tysiące oczu szuka bugów
• Brak vendor lock-in — możemy zmienić dostawcę (zrobiliśmy to w maju 2026, przenosząc bazę aplikacyjną — bezboleśnie, bo schemat to standardowy Postgres)
• Społeczność — problemy są szybko rozwiązywane

Koszty infrastruktury

Oto nasze koszty miesięczne (przybliżone):

Usługa	Koszt
Vercel (hosting)	$0 (hobby tier)
Neon (baza Postgres)	$0 (free tier — 0.5 GB)
Groq (AI)	$0 (free tier)
Domena polandai.pl	~1 zł/dzień
Razem	~$0–$1/miesiąc

Tak, budujemy to praktycznie za darmo. Gdy urośniemy, przejdziemy na płatne plany (Neon Pro to $19/mc). Ale na start — działająca platforma AI za grosze.

Co można zbudować samodzielnie

Jeśli chcesz stworzyć podobne narzędzie:

1. Zacznij od Next.js — nextjs.org/learn
2. Dodaj Neon Postgres — neon.com/docs (przez Vercel Marketplace setup zajmuje 2 minuty)
3. Zintegruj Groq — console.groq.com
4. Deployuj na Vercel — vercel.com

Dokumentacja wszystkich tych narzędzi jest świetna.

Wyzwania techniczne

Żeby być szczerym, nie wszystko jest proste:

1. Rate limiting

Darmowe tiery mają limity. Monitorujemy użycie i planujemy skalowanie.

2. Latency

Groq jest szybki, ale transfer danych do USA dodaje opóźnienie. Dla polskich użytkowników ~100–200 ms.

3. Utrzymanie

Frameworki się zmieniają. Next.js 16 ma inne API niż 14. Trzeba być na bieżąco.

4. Bezpieczeństwo

Każda nowa funkcja to potencjalna luka. Trzeba testować, audytować, aktualizować.

Przyszłość

Planujemy:

• Self-hosting modeli — możliwe uruchamianie Llama na własnej infrastrukturze
• Więcej integracji — połączenie z popularnymi narzędziami NGO
• API dla innych — żeby inne organizacje mogły korzystać z naszej infrastruktury
• Open source całego kodu — gdy dojrzeje, opublikujemy na GitHubie

Podsumowanie

Warstwa	Technologia	Dlaczego
Frontend	Next.js 16	Szybkość, SEO
Styling	Tailwind CSS	Produktywność
Baza danych	Neon Postgres (Frankfurt)	Standardowy SQL, UE, brak vendor lock-in
AI	Groq + GPT-OSS 120B / Llama 3.3	Szybkość, open weights
Hosting	Vercel	Integracja z Next.js, edge CDN
CMS	markdown w git	Wersjonowanie, zero zewnętrznych zależności

Technologia nie jest celem samym w sobie. To narzędzie do realizacji misji. Ale cieszymy się, że możemy ją opisać otwarcie. Przejrzystość buduje zaufanie.

Masz pytania techniczne? kontakt@polandai.pl