Funkčný starter kit pre eventový check-in a živý dashboard

Pri prvom Women in AI Prague meetupe som nechcela pracovať iba so zoznamom registrácií. Pri vstupe som potrebovala rýchlo nájsť človeka, označiť jeho príchod a zároveň počas eventu vidieť, aké publikum je práve v miestnosti.

Z toho vznikol jednoduchý flow, ktorý prepája registrácie, check-in a živý dashboard. Z riešenia, ktoré som použila na vlastnom evente, som pripravila starter kit, ktorý si môže ďalší tím prispôsobiť svojmu podujatiu.

Balík obsahuje funkčný demo režim, Google Sheets integráciu, Netlify Functions, automatické testy, bezpečnostný checklist a pripravené zadanie pre Codex alebo Claude Code. Namiesto stavania od nuly teda upravuješ už fungujúci základ podľa svojich dát, otázok, brandingu a eventového flow.

Ako to funguje v praxi

Na titulnom obrázku je reálny verejný dashboard z prvého Women in AI Prague meetupu. Zobrazuje iba súhrnné kategórie a počty, nie mená ani e-maily účastníčok.

Kedy sa ti tento starter hodí

Dáva zmysel tam, kde potrebuješ prepojiť registrácie, príchody a jednoduchý živý prehľad a nechceš kvôli tomu kupovať veľký eventový systém. Napríklad pre:

• komunitné meetupy a networkingové raňajky,
• interné learning days, workshopy a firemné podujatia,
• menšie konferencie s jedným check-in miestom,
• opakované eventy, pri ktorých sa mení značka, miesto alebo otázky v registrácii,
• pilot, na ktorom si tím chce overiť vlastný flow pred rozhodnutím o väčšom riešení.

Najväčšia úspora je v tom, že nezačínaš od prázdneho priečinka. Architektúra, demo flow, testy a základné bezpečnostné hranice už sú pripravené. Tvoj čas ide hlavne do mapovania vlastných dát, brandingu a toho, ako má check-in fungovať na konkrétnom evente.

Rovnaký základ sa dá prispôsobiť inej značke aj iným otázkam. Takto vyzerá verejný agregovaný dashboard pre EX Community Breakfast by BE-DNA:

Čo balík obsahuje

Po rozbalení nájdete dve rozhrania. Súkromný check-in slúži obsluhe pri vstupe. Verejný dashboard zobrazuje iba povolené kategórie a ich súhrny.

Balík obsahuje:

• vyhľadávanie účastníka podľa mena alebo e-mailu,
• check-in aj vrátenie chybne označeného príchodu,
• automatickú synchronizáciu s Google Sheetom,
• živý dashboard s obnovou približne každých päť sekúnd,
• demo dáta a vzorové CSV,
• pripravený prompt pre Codex alebo Claude Code,
• technickú špecifikáciu, bezpečnostný checklist a automatické testy.

Starter neobsahuje žiadne produkčné osobné údaje, PIN, Google Sheet ID, service-account kľúč ani cudzie logo. Ďalší tím si doplní vlastný Sheet, mapovanie stĺpcov, eventové údaje, branding a serverové premenné prostredia.

Ako ho odovzdať Codexu alebo Claude Code

Do nového projektu vložte rozbalený priečinok a coding agentovi pošlite súbor AGENT_PROMPT.md. Prompt ho najprv vedie cez README, technický kontrakt a bezpečnostné pravidlá. Potom žiada konkrétne vstupy: názov eventu, jazyk, značku, Sheet, povolené registračné stavy, dashboardové kategórie a cieľový hosting.

V zadaní je aj dôležitá release hranica: agent má najprv pripraviť lokálne overenie alebo chránený deploy preview. Produkciu nemá meniť bez výslovného schválenia.

Pri odovzdaní odporúčam doplniť iba informácie, ktoré už máte potvrdené. Reálne kľúče ani PIN nevkladajte do promptu. Agent má pomenovať presné environment variables a miesto, kde ich bezpečne nastavíte v hostingu.

Nová bezpečnostná vrstva

Prvá verzia používala PIN pri každom vyhľadaní a zápise. V aktuálnom balíku sa PIN odošle iba raz na serverový auth endpoint. Po úspešnom overení vznikne podpísaná relácia uložená v cookie s atribútmi Secure, HttpOnly a SameSite=Strict.

Prakticky to znamená:

• PIN sa neukladá do browser storage,
• vyhľadávanie ani check-in už PIN neposielajú,
• relácia je viazaná na povolené event ID,
• absolútny timeout je nastaviteľný od 5 minút do 8 hodín,
• obsluha sa môže ručne odhlásiť,
• zmena session secretu zneplatní všetky aktívne relácie,
• auth route obmedzuje pokusy na 5 za 180 sekúnd pre kombináciu IP a domény.

Netlify vo svojej dokumentácii upozorňuje, že vynucovanie rate limitu môže začať s krátkym oneskorením. Preto má zmysel použiť dlhý eventový PIN a po evente ho spolu so session secretom vymeniť. Pre citlivé alebo väčšie podujatie by som už volila používateľské účty, SSO, roly a audit log.

Verejný dashboard má inú dátovú hranicu. Endpoint neposiela meno, e-mail ani číslo riadka. Neznáme odpovede mapuje na unspecified, aby sa na verejnosť nedostala pôvodná textová hodnota. Pri veľmi malých skupinách treba aj tak zvážiť minimálny prah, pretože kombinácia zriedkavých kategórií môže človeka nepriamo identifikovať.

Technické zhrnutie

Automatické testy kontrolujú mapovanie dát, oprávnené registračné stavy, oddelenie ľudí so zhodným e-mailom, check-in aj undo, synchronizáciu so simulovaným Sheetom, podpis a timeout relácie aj neprítomnosť mien a e-mailov vo verejnom API. Reálny produkčný tok treba po doplnení vlastných credentials overiť na povolenom testovacom riadku.

Užitočné technické odkazy

• Codex pre vývojárov
• Začíname s Claude Code
• Netlify Functions – API a konfigurácia
• Netlify rate limiting
• Google Sheets API

Starter je základ, ktorý treba prispôsobiť reálnemu eventu, dátam a riziku. Ak chcete prejsť vlastný use case, mapovanie Sheetu alebo bezpečnostné hranice, vyberte si termín krátkeho úvodného meetingu alebo mi napíšte na womeninaiprague@gmail.com.