CLAUDE.md: šablona pro aplikaci

CLAUDE.md pro webovou aplikaci

Zkopíruj do kořene projektu a doplň. Pravidla o tajemstvích a oprávněních nemaž.

# [NÁZEV APLIKACE]

## Co to je
[JEDNA VĚTA: kdo aplikaci používá a jaký problém řeší]

## Příkazy
- Vývoj: `npm run dev`
- Sestavení: `npm run build`
- Kontrola typů: `npx tsc --noEmit`
- Migrace databáze: [PŘÍKAZ]

## Technologie
Next.js (App Router), TypeScript, Tailwind CSS.
Databáze: [JAKÁ]. Přihlašování: [JAK].

## Struktura
- `src/app/` – stránky a serverové endpointy
- `src/components/` – komponenty rozhraní
- `src/lib/` – logika, práce s daty
- `src/lib/db/` – jediné místo, které sahá do databáze

## Datový model
[STRUČNĚ: hlavní tabulky a jak spolu souvisí]

## BEZPEČNOST – tohle je nejdůležitější část
- Tajemství jsou VŽDY jen v proměnných prostředí. Nikdy v kódu.
- Proměnná s předponou NEXT_PUBLIC_ je veřejná. Nikdy do ní nedávej
klíč, token ani heslo.
- Kód, který používá tajemství, běží jen na serveru.
- KAŽDÝ dotaz na data uživatele musí ověřit, že záznam patří
přihlášenému uživateli. Nestačí ověřit, že je přihlášený.
- Vstupy od uživatele se validují na serveru, ne jen ve formuláři.
- Chybové hlášky uživateli neprozrazují detaily o systému.

## Pravidla práce
- Piš česky, i v komentářích.
- Před přidáním knihovny se zeptej a zdůvodni to.
- Neměň nic, o co jsem nepožádal.
- U čehokoli delšího než jeden krok nejdřív napiš plán a počkej.
- Po dokončení mi napiš, co jsi změnil a co by to mohlo rozbít jinde.
- Nikdy nespouštěj příkazy, které mažou data, bez mého výslovného
potvrzení.

## Migrace
- Změnu struktury databáze vždycky nejdřív popiš a počkej na potvrzení.
- Nikdy nesmaž sloupec nebo tabulku bez zálohy.

## Kontrola před hotovo
- `npm run build` projde bez chyb.
- `npx tsc --noEmit` projde bez chyb.
- Konzole prohlížeče bez chyb.
- Vyzkoušené na dvou různých účtech – uživatel nevidí cizí data.
- Prázdné, načítací a chybové stavy jsou ošetřené.