Jak si postavit appku na správu VIP hostů s Claude Code (a co jsme pokazili)

Tohle je zákulisí vip-manageru — appky na správu VIP pozvánek, kterou jsme postavili za ~10 hodin večerů. Ne proto, abyste stavěli zrovna správu pozvánek, ale protože stejný postup funguje na většinu interních nástrojů.

Krok 1: Zadání před kódem (naše největší lekce)

Začali jsme prototypem a hned stavěli. Chyba. Zadání jsme pak třikrát zásadně předělávali — v dokumentu to dodnes vidíte jako revize PRD 1.0 → 1.1 → 1.2. Třeba registr osob (jeden člověk může působit ve víc organizacích) přišel až ve třetí revizi, a to už znamenalo přestavbu hotových částí.

Co bychom udělali znovu: nejdřív si s Claudem sepsat PRD (produktové zadání) formou rozhovoru a nechat se vyzpovídat:

Chci postavit interní nástroj na [X]. Než začneme kódovat, vyzpovídej mě jako produktový manažer: kdo ho bude používat, jaké má scénáře, co je v první verzi a co vědomě odkládáme. Ze všech odpovědí sestav PRD s očíslovanými funkčními požadavky.

Hodina takového rozhovoru ušetří víc času, než kolik stojí — my na to přišli obráceně.

Krok 2: CLAUDE.md jako ústava projektu

Do repozitáře patří soubor CLAUDE.md: co je projekt zač, jaké má konvence, na co si dát pozor. Claude Code si ho načte při každém startu — díky tomu každé nové vlákno pokračuje, místo aby začínalo od nuly.

Krok 3: Stack, který nemusíte spravovat

Zvolili jsme Vite + React + TypeScript + Tailwind a Firebase (přihlášení, databáze Firestore, hosting v jednom, štědrý free tier). Pro interní nástroj je to sázka na nudu — a nuda je u infrastruktury přesně to, co chcete. Za provoz v1 neplatíme nic.

Krok 4: Iterace po funkčních celcích

PRD má očíslované požadavky (organizace → osoby → zařazení židlí → pozvánky → usazování). Každý celek = jedno vlákno s Claudem:

Pokračujeme na vip-manageru, přečti si CLAUDE.md a PRD. Dnes implementujeme FR-C2 (pozvánky hostů): stavový workflow, kontrola duplicit osoby v akci, filtrace podle balíčků. Až budeš hotový, ukaž mi, co mám ručně otestovat.

Malé celky = malé škody, když se něco nepovede. A commit po každém celku.

Krok 5: Testujte na nečisto

Firebase má lokální emulátory — appka běží kompletně na vašem počítači s testovacími daty (na naplnění máme skript). Produkce zůstává čistá, dokud v1 opravdu nefunguje.

Krok 6: Dejte to brzy do rukou skutečnému uživateli

Naším testerem byla Dáda — a její „tady mi chybí sloupec s dětmi“ má hodnotu deseti hodin promýšlení. Verzi 1 teď používá jako demo pro pořadatele; zpětná vazba rovnou krmí zadání v2.

Bilance

Čas: ~10 h vývoje po večerech (+ čas na revize zadání, který jsme zaplatit nemuseli)
Náklady: předplatné Claude (plán Max), Firebase free tier — žádné další
Výsledek: nástroj, který srazil přípravu akce ze 40 na ~20 hodin

Nechce se vám stavět? Přečtěte si, co vip-manager umí, a napište na info@zaidovi.cz — postavíme vám to na míru.