Stav systému

Architektúra

Systém má štyri vrstvy. Záujemcovia sa registrujú na /register (meno, e-mail, adresa, PIN, aktivačný kód balíčka) a po kliknutí na aktivačný e-mail získajú prístup. Superadmin spravuje zoznam kvízmajstrov, master katalóg a aktivačné kódy. Kvízmajstri sa prihlasujú v /admin e-mailom a PIN-om, spravujú vlastné kolá, témy, hru. Tímy hrajú cez /r/<token>. Tabuľa premieta hru na /r/<token>/screen.

Vrstvy pre tímy a tabuľu (/r/<token>) budú aktivované v ďalšej fáze — momentálne sú nahradené placeholderom.

Kvízmajstri

Kvízmajstri sa registrujú sami na /register — vyplnia meno, e-mail, adresu, zvolia si PIN a zadajú aktivačný kód balíčka. Po registrácii im prijde e-mail s aktivačným odkazom; po kliknutí na odkaz sa ich účet stane aktívnym a môžu sa prihlásiť e-mailom + PIN-om. Tu vidíte všetkých registrovaných kvízmajstrov a viete im manuálne zmeniť stav (napr. ak e-mail nedorazil) alebo upraviť pridelené sady.

Zoznam kvízmajstrov

Sady kvízmajstra

Pridelit ďalšiu sadu

Oprávnenia na tvorbu vlastných médiových otázok

Určuje, či tento kvízmajster môže vo vlastných (nezaplatených) otázkach použiť audio, obrázok alebo video. Vhodné napr. na predaj ako samostatný doplnok.

Master katalóg otázok

Globálna banka tém a otázok. Superadmin môže témy a otázky priamo pridávať, editovať a mazať. Kvízmajstri si ich stiahnu cez sady z Trhoviska.

Nová téma

Téma je len štítok/parameter sady (podobne ako Obtiažnosť) — slúži na filtrovanie v Trhovisku. Otázky sa nepridávajú sem, ale priamo do konkrétnej sady nižšie.

Nová sada

Základná jednotka obsahu. Každá sada má presne jednu tému a jednu obtiažnosť — otázky patria vždy len tejto jednej sade, nemiešajú sa s inými.

Sady v katalógu

Sady na Trhovisku

Sada (pack) je skupina tém a otázok, ktorú kvízmajster dostane buď automaticky (default), zaplatí, alebo odomkne aktivačným kódom. Pri vytvorení kvízmajstra sú mu predvolene priradené všetky default sady.

Existujúce sady

Kódy sád vygenerujete v záložke Databáza → „Migrácia: Kódy sád".

Vytvoriť aktivačný kód

Kód odomkne kvízmajstrovi konkrétnu sadu (pack). Po zadaní kódu v /admin sa sada pridelí k jeho účtu. Stripe platby pribudnú neskôr — momentálne funguje len táto cesta.

Existujúce kódy

Čakajúce objednávky

Kvízmajster si na Trhovisku vyberie sady, ktoré ešte nemá, a odošle ich ako jednu žiadosť. Schválením sa mu naraz pridelia všetky sady z objednávky.

História objednávok

Inicializácia databázy

Naseedovanie master katalógu

Naplní master katalóg: 10 tém × 10 otázok úrovne A (základná) + 10 tém × 10 otázok úrovne B (pokročilá) (spolu 200 otázok). Zároveň vytvorí 1 Štartovaciu sadu (A – default, zadarmo) a 10 samostatných pokročilých sád na Trhovisku (každá obsahuje 1 tému × úroveň B, odomyká sa aktivačným kódom).

Vymazať master katalóg

Vymaže iba master témy, otázky, sady, licencie a aktivačné kódy. Kvízmajstri a ich hry zostanú zachovaní (ale prídu o priradené sady).

Migrácia: Šablóny kvízov

Bezpečne vytvorí tabuľky pre funkciu Šablóny kvízov, ak ešte neexistujú. Nevymaže žiadne existujúce dáta kvízmajstrov — spustite raz po nasadení tejto funkcie.

Migrácia: Objednávky sád

Bezpečne vytvorí tabuľku pre objednávky sád z Trhoviska (kvízmajster si vyberie sady, ktoré nemá, a odošle jednu hromadnú žiadosť superadminovi na schválenie). Nevymaže žiadne existujúce dáta — spustite raz po nasadení tejto funkcie.

Migrácia: Hromadný výber tém

Bezpečne vytvorí tabuľku pre hromadný výber tém kvízmajstrami (nezávisle od sád), ak ešte neexistuje. Nevymaže žiadne existujúce dáta — spustite raz po nasadení tejto funkcie.

Migrácia: Otvorené otázky (textové odpovede)

Bezpečne doplní stĺpce potrebné pre otvorené otázky (typ otázky, % textovej zhody pri vyhodnocovaní). Nevymaže žiadne existujúce dáta — spustite raz po nasadení tejto funkcie.

Migrácia: Hudobné otázky (audio ukážky)

Bezpečne doplní stĺpce pre hudobné otázky (link na audio, voľba kde sa dá prehrať). Nevymaže žiadne existujúce dáta — spustite raz po nasadení tejto funkcie.

Migrácia: Video otázky a oprávnenia médií

Bezpečne doplní stĺpce pre video otázky a stĺpce na povoľovanie audio/obrázkových/video otázok jednotlivým kvízmajstrom (nastavuje sa v záložke Kvízmajstri). Nevymaže žiadne existujúce dáta.

Migrácia: 3-úrovňová obtiažnosť (A/B/C)

Spustiť IBA RAZ. Premapuje existujúce dáta z 2-úrovňového systému (A=pokročilý, B=štandard) na nový 3-úrovňový (A=základná, B=pokročilá, C=extra pokročilá pre budúce sady). Staré B → nové A, staré A → nové B. Opakované spustenie by znova prehodilo už premapované dáta.

Doplniť chýbajúci pôvod otázok

Doplní zdrojovú sadu (source_pack_id) pri otázkach, ktoré boli stiahnuté pred zavedením sledovania pôvodu a zobrazujú sa ako "neznáma sada". Bezpečné spustiť opakovane — len doplní chýbajúce údaje, nič neprepíše. Spustite AŽ PO premapovaní úrovní vyššie, ak ste ho ešte nespustili.

Migrácia: Zdržanie spustenia ukážky (audio/video)

Bezpečne doplní stĺpce audio_play_delay a video_play_delay (počet sekúnd od štartu otázky po spustenie ukážky, default 3 s). Nevymaže žiadne existujúce dáta — spustite raz po nasadení tejto funkcie.

Backfill: Nastaviť predvolené zdržanie (3 s) pre existujúce otázky

Nastaví audio_play_delay = 3 a video_play_delay = 3 pre všetky otázky, ktoré majú tieto hodnoty NULL (teda boli vytvorené pred touto migráciou). Bezpečné spustiť opakovane.

Migrácia: Kódy sád + rozbitie štartovacej sady

Pridá stĺpce code a created_month do sád. Vygeneruje kódy (napr. ZEM001) pre všetky existujúce sady. Rozloží štartovaciu sadu (10×10) na 10 samostatných sád s príznakom zadarmo. Bezpečné spustiť opakovane.