ADR-0001: Tech stack — Next.js 15 + Node.js 20 + MongoDB Atlas

Kontext

ClubUp potrebuje stack pre dve aplikácie (študentskú a admin) plus marketingový web. Nároky:

Slovensky-friendly UX — server-side rendering pre SEO, podpora SK locale
API-first — admin a študent zdieľajú backend
Platobný flow s 24-pay (redirect + webhook handler — ideálne v tom istom procese ako UI)
Video lekcie s adaptive streaming
Reálne škálovanie — 0–500 študentov v 1. roku, 5 000+ neskôr (viď ../architecture/scaling.md)
Zhoda s ekosystémom SportUp — ten istý stack, aby sa dali zdieľať packages/* knižnice
Dostupní vývojári na Slovensku — vyhnúť sa exotike

Pros: mainstream stack, server components znižujú JS bundle, Server Actions zjednodušujú backend, hosting na Verceli zero-config, MongoDB má JSON dokumenty zhodné s naším doménovým modelom (versioned courses, embedded progress), bohatý ecosystém.
Cons: Vendor lock-in na Vercel (hoci self-host je možný), Server Components majú learning curve, MongoDB transakcie sú menej zrelé než v PostgreSQL.

Pros: Web-standards-first prístup, jednoduchší mental model než App Router.
Cons: Menšia komunita než Next.js, menej React Server Components zdrojov, PostgreSQL by si vyžiadal komplexnejší schema management pre versioning entít.

Pros: Najmenší bundle, najrýchlejší dev mode.
Cons: Menší trh slovenských vývojárov so Svelte skúsenosťami, žiaden zdieľaný kód so SportUp.

Pros: Astro perfektný pre marketing web (statický), oddelený API server pre flexibilitu.
Cons: Dva deployment targets, dva mental modely, viac infraštruktúry, neopodstatnená komplexnosť pre náš objem.

Next.js 15 (App Router) na Node.js 20 LTS + MongoDB Atlas + TypeScript 5.6+ strict.

Marketingový web: statický build (website/), deploy ako root projektu na Verceli
Študentská aplikácia: Next.js 15 v src/apps/app/
Admin aplikácia: Next.js 15 v src/apps/admin/
Database: MongoDB Atlas, prístup cez natívny mongodb driver (NIE Mongoose)
Validácia: Zod (zdieľaná medzi serverom a klientom)

Zhoda so SportUp.sk — ten istý stack znamená zdieľané packages/*, zdieľanú znalosť, jednoduchšie cross-projektové onboarding.
App Router je hlavný smer Next.js — Pages Router je deprecated; ísť do nového projektu s Pages Router by bolo legacy od dňa 1.
Server Components šetria bundle — väčšina UI je server-rendered, len interaktívne komponenty (formuláre, prehrávač) sú client.
MongoDB pre versioning — naša entita Course má version + previousVersionId (viď ../domain/course.md). V dokumentovej DB je to triviálne; v relačnej by to vyžadovalo composite keys alebo audit tabuľky.
Žiadny ORM — Mongoose by pridal vrstvu pomalých proxies, problematické transakcie cez session, nekompatibilitu s niektorými agregáciami. Natívny driver + Zod pokrýva všetko, čo potrebujeme.
Vercel + MongoDB Atlas = zero infrastructure — žiadne servery na spravovanie, žiadne CI/CD pipelines mimo GitHub Actions.

Rýchly štart (zero-config deployment)
Spoločné knižnice s sportup.sk (auth, ui)
Veľký trh React/Next.js vývojárov v EÚ
Migrácia existujúceho marketingového webu z websupport.sk je triviálna (statické HTML pôjde tak ako je)

Vendor lock-in na Vercel — exit by trval ~1–2 dni práce (Next.js sa dá self-hostovať, ale Inngest, Cron, Edge Functions sú Vercel-špecifické)
MongoDB transakcie sú menej zrelé než v PostgreSQL — pre kritické sekvencie (payment → enrollment) pracujeme v session, ale máme na pamäti, že MongoDB nie je SQL
Server Components learning curve pre developerov, ktorí ešte robili len Pages Router

Pri 5 000+ aktívnych študentoch — vyhodnotiť, či App Router serverless funkcie nemajú cold-start problém pre dashboard; možno presunúť na Edge runtime alebo dlhobežiace Node servers
Ak Vercel zdvihne ceny zásadne — pripraviť self-host plán (Caddy + Node + Mongo na Hetzneri)
Pri integrácii s vládnym registrom (eDesk, eGov), ak by bolo nutné PostgreSQL kvôli compliance — re-evaluovať