Přeskočit na obsah

Marek.media — portfolio a CMS

Vlastní headless CMS ve dvou jazycích, provoz na bezplatných tarifech. Fullstack monorepo: Next.js web, React administrace a NestJS API nad PostgreSQL.

Motivace

Portfolio je pro vývojáře vizitka, jenže statická šablona ukáže jen frontend. Cílem bylo, aby web sám ukazoval návrh a stavbu celé aplikace: databázi, API, administraci ovládanou AI, nasazení i provoz. Projekt je tedy primárně ukázkový.

Zároveň má fungovat jako skutečný produkt, ne jen demo:

  • obsah editovatelný bez nasazení, v češtině a angličtině,

  • náhled konceptů před publikováním,

  • rychlý statický web, který se po změně obsahu sám obnoví,

  • provoz za pár dolarů měsíčně a bez závislosti na jednom poskytovateli.

Hotový CMS by většinu z toho pokryl, ale datový model, API i oprávnění by určoval on a ukázal by hlavně práci s cizím nástrojem. Proto je celý stack vlastní.


Originalita

Prémiová služba si zaslouží originální design, ne výstup z promptu. Generativní AI dnes vyrobí web na pár promptů a je to poznat: stejné gradienty, stejné ilustrace, stejná rozvržení, grafika bez nápadu. AI slop.

AI je tu nástroj, ne autor. Design i architektura jsou vlastní práce. Místo nudné hero sekce si můžete zahrát skákací minihru.

image.png

SEO a výkon

ISR s on-demand revalidací, WebP varianty obrázků z CDN, Redis cache, canonical a hreflang, Open Graph, JSON-LD, generovaná sitemap, přesměrování 308.

Lidsky řečeno: web se načte rychle i na mobilu, změna obsahu je na něm ihned a vyhledávače ho správně zobrazí v obou jazycích.

image.png

image.png

Architektura

Turborepo s pnpm workspaces, tři aplikace, každá s produkcí a stagingem:

Aplikace

Stack

Hosting

Web (marek.media)

Next.js (App Router, ISR, draft mode), React, Tailwind

Vercel

Administrace (adm.marek.media)

React SPA, Vite, TanStack Router a Query, shadcn/ui, TipTap

Cloudflare Pages

API (api.marek.media)

NestJS, Prisma, PostgreSQL, BullMQ, Swagger

Railway (Docker)

Infrastruktura: PostgreSQL na Neonu, Redis (Valkey) na Aivenu, soubory v Cloudflare R2, e-maily přes Resend. Sdílené balíčky nesou design tokeny a utility. Typovaný API klient se pro web i administraci generuje ze Swagger schématu (Kubb), takže změna kontraktu API se okamžitě projeví v typech na frontendu.

API má 24 Prisma modelů a 7 nativních PostgreSQL enumů. Kromě CRUD obsahu řeší RBAC, audit log, soft delete s košem, přesměrování starých slugů, podepsané náhledy konceptů a zpracování obrázků do WebP variant na pozadí. Administrace obsahuje AI asistenta AURORA se 94 serverovými nástroji nad stejnými službami jako REST API.


Klíčová rozhodnutí a kompromisy

Rozhodnutí

Důvod

Kompromis

Vlastní headless CMS vs Strapi / Payload

Projekt je primárně ukázkový: celý stack od databáze po frontend je vlastní práce a datový model, API i oprávnění odpovídají přesně potřebám webu.

Funkce, které hotový CMS má v základu (koš, náhledy, role), je potřeba napsat a udržovat.

Bezplatné tarify (Neon, Vercel, Cloudflare, Aiven, Resend) a Railway za 5 USD měsíčně

Provoz téměř zdarma.

Limity tarifů, studený start databáze a víc služeb ke správě.

Cloudflare R2 vs AWS S3

S3-kompatibilní API a nulové poplatky za odchozí přenos, u webu plného obrázků podstatné.

Menší ekosystém navazujících služeb než AWS.

Resend vs Mailgun

Modernější API a jednodušší integrace.

Bezplatný tarif je omezený na 3 000 e-mailů měsíčně.

Railway vs Render (free)

API běží nepřetržitě. Free služba na Renderu se po 15 minutách bez provozu uspí, probuzení trvá zhruba minutu a s ní by stály i BullMQ workery.

Railway není zdarma, stojí 5 USD měsíčně.

Aiven Valkey vs Upstash

BullMQ workery generují provoz do Redisu i nad prázdnou frontou. Upstash účtuje za každý příkaz a free limit 500 000 příkazů měsíčně by se vyčerpal za pár dní. Valkey na Aivenu příkazy nepočítá a je s Redisem plně kompatibilní.

Bezplatný tarif neumožňuje vybrat region.

Turborepo vs Nx

Pro tři aplikace stačí minimum konfigurace.

Při třech aplikacích žádný. Výhody Nx (generátory, hranice modulů, automatické upgrady) se projeví až u velkého monorepa.

Typy generované z OpenAPI vs sdílená Zod schémata

Validace formulářů se od validace API liší a sdílená schémata pokryla jen zlomek případů. Zdrojem pravdy je API, typy se z něj generují přes Swagger (Kubb).

Validace formulářů na frontendu (Zod) je samostatná a musí odpovídat validaci API.

Prisma vs TypeORM

Typově bezpečné dotazy a schéma na jednom místě.

Některá databázová omezení Prisma ve schématu nepopíše, zůstávají v SQL migracích.


Testy, CI a nasazení

  • CI na každém pull requestu: lint, typecheck, unit testy, e2e testy API přes Jest a Supertest na reálném PostgreSQL a Redisu (Testcontainers), vizuální regresní testy Storybooku v Chromaticu, automatické code review (CodeRabbit).

  • Vývoj s AI agenty. Kód vzniká s pomocí AI agentů (Claude Code), kteří se řídí pravidly a plány uloženými přímo v repozitáři. Vše důležité hlídají automatické testy.

image.png