Jak Scout Scoring funguje

Čtyři skupiny lidí, čtyři vstupy do aplikace

• Administrátor — zakládá účty organizátorů, spravuje uživatele celé instance. Přihlašuje se emailem a heslem.
• Organizátor — vlastní nebo spravuje konkrétní závod: hlídky, stanoviště, kategorie, spuštění a uzavření závodu, výsledky. Přihlašuje se emailem a heslem.
• Rozhodčí na stanovišti — nemá účet. Naskenuje QR kód stanoviště a zapisuje body.
• Doprovod hlídky — nemá účet. Naskenuje QR kód hlídky a vyplní slovní zpětnou vazbu.

1. 1 · Příprava (draft)

   Organizátor zakládá kategorie, hlídky a stanoviště, nastavuje kritéria bodování. Nic se ještě nedá zapisovat, žádné PINy neexistují.

2. 2 · Připraveno (ready)

   Tlačítko „Připravit ke spuštění“ vydá PINy a QR kódy pro stanoviště i pro doprovod hlídek — karty se dají vytisknout. Stanoviště jdou dál upravovat, u hlídek jen název a členové; nové hlídky se už nepřidávají. Kdo QR načte, uvidí obrazovku „závod ještě nebyl spuštěn“, která si sama hlídá start.

3. 3 · Běží (active)

   Rozhodčí zapisují body, doprovod vyplňuje zpětnou vazbu, organizátor sleduje průběh v dashboardu a live aktivitě.

4. 4 · Uzavřeno (closed)

   Zápis bodů ze stanovišť se zastaví. Body jdou opravit už jen záložkou „Opravy“ s povinným důvodem. Výsledky se zveřejní, okno pro zpětnou vazbu doprovodu zůstává otevřené ještě 12 hodin.

Co admin umí

• Založit uživatele — vyplní jméno, email a heslo. Aplikace neposílá emaily, takže heslo se zobrazí po vytvoření a admin ho předá osobně.
• Povýšit na admina — přepínač u uživatele; admin vidí a spravuje všechny účty.
• Resetovat heslo — vygeneruje nové heslo pro uživatele, který se nemůže dostat dovnitř.
• Upravit nebo smazat účet — změna jména či emailu, odebrání přístupu.
• Vidět, ke kterým závodům má uživatel přístup — v detailu uživatele je seznam jeho závodů s rolí (vlastník / editace / čtení).

Role na závodě

• Vlastník — kdo závod založil. Má plná práva včetně sdílení a uzavření.
• Editace — smí měnit hlídky, stanoviště i nastavení.
• Čtení — vidí všechno, ale editace je uzamčená (aplikace to hlásí páskou „Máš přístup jen pro čtení“).

Záložky dashboardu

1. Přehled

   Dvě tabulky vedle sebe: postup hlídek (kolik stanovišť má hotovo, celkem bodů, poslední aktivita) a průběh stanovišť (kolik hlídek zpracovalo, kolik zbývá) s pruhy dokončení. Nad tím dlaždice s počty hlídek a stanovišť.

2. Live aktivita

   Chronologický proud posledních zápisů bodů ze stanovišť — kdo, kde, kolik bodů a kdy. Slouží ke sledování závodu v reálném čase a k rychlému odhalení stanoviště, které nezapisuje.

3. Hlídky

   Přidání hlídky ručně nebo import CSV se sloupci start_number, name, category, members. U hlídky se eviduje startovní číslo, název, kategorie a členové. Hlídku, která se nedostavila, lze stáhnout ze závodu (zůstane v datech, vypadne z výsledkovky) a případně vrátit zpět. Tady se také tisknou QR karty pro doprovod a resetuje se PIN hlídky.

4. Stanoviště

   Definice stanovišť: název, pořadí, kritéria bodování s maximem bodů a přepínač půlbodů. Kritéria se rozhodčímu zobrazí jako formulář. Stanoviště se dá deaktivovat, znovu vydat PIN a vytisknout „Login Cards“ — karty s QR kódem, které se rozdají rozhodčím.

5. Opravy

   Objeví se u uzavřeného závodu. Matice hlídka × stanoviště, kde jde doplnit chybějící hodnocení nebo opravit zapsané — vždy s povinným důvodem. Pod tím panel „Historie změn“ (audit log) s exportem do CSV; původní hodnoty zůstávají zachované.

6. Nastavení

   Základní údaje (název, datum, místo), kategorie, model bodování a měření času, sdílení závodu s dalšími organizátory, odkaz na veřejné výsledky s přístupovým kódem a nastavení zpětné vazby od doprovodu.

Nastavení závodu podrobněji

Import stanovišť pomocí AI

• Do dialogu se nahraje dokument s propozicemi závodu (do 5 MB).
• AI z něj vytáhne návrh stanovišť s kritérii a doplňujícími otázkami.
• Organizátor otázky zodpoví, návrh se zpřesní a teprve pak se stanoviště uloží — nic nevzniká bez potvrzení.

Průběh na stanovišti

1. Přihlášení

   Naskenováním QR kódu se otevře /station/<id> s PINem v odkazu a rozhodčí je rovnou přihlášený. Bez karty jde na /station vybrat závod a stanoviště ručně a PIN opsat. První přihlášení vyžaduje připojení k síti.

2. Výběr hlídky

   Seznam hlídek závodu s vyhledáváním podle startovního čísla i názvu. U hlídek, které už na stanovišti byly, je vidět „Zapsáno“, u rozepsaných offline zápisů „Uloženo lokálně“.

3. Zápis bodů

   Formulář s kritérii daného stanoviště. Body se zadávají v celých číslech, nebo po půl bodu, pokud to stanoviště povoluje. Podle nastavení závodu se doplní čas příchodu a odchodu ve formátu HH:MM. Aplikace hlídá maximum bodů i formát času.

4. Odeslání

   Online se zápis rovnou uloží do databáze. Offline padne do fronty a odešle se sám, jakmile se objeví signál — rozhodčí může pokračovat na další hlídku.

Stavy, které rozhodčí uvidí

• Bez připojení — indikátor v hlavičce; zápisy se ukládají lokálně.
• Zápis čeká na odeslání — počet položek ve frontě.
• Zápis vyžaduje řešení — odeslání selhalo kvůli uzavřenému závodu nebo vypršenému přihlášení; je potřeba se znovu přihlásit nebo předat body organizátorovi.
• Závod ještě nebyl spuštěn — karta funguje, ale závod je teprve ve stavu „Připraveno“; obrazovka si start hlídá sama.

Jak to probíhá

1. Vstup přes QR kartu hlídky

   QR kód z karty hlídky otevře formulář přímo pro tu hlídku. Bez PINu z karty se dovnitř nedá dostat; první otevření potřebuje síť.

2. Vyplnění

   N polí „Co se povedlo“ a M polí „Prostor pro zlepšení“ — počty určuje organizátor v nastavení závodu. Text se průběžně sám ukládá, takže se nedá ztratit.

3. Odeslání

   Tlačítkem „Uzavřít a odeslat“ se hodnocení potvrdí (aplikace se ještě jednou zeptá) a dál je jen ke čtení.

4. Souběh dvou zařízení

   Když formulář otevře někdo druhý, uvidí, že hodnocení právě vyplňuje jiné zařízení, a může vyplňování explicitně převzít — nic se nepřepíše nepozorovaně.

Co s tím dělá organizátor

• Vidí odeslaná hodnocení u jednotlivých hlídek.
• Může odeslané hodnocení vrátit k editaci — obsah přitom sám editovat nesmí.
• Rozhoduje, zda se hodnocení objeví i ve veřejných výsledcích; ve výchozím stavu zůstává neveřejné.
• Může hlídce resetovat PIN, pokud se karta ztratila.

• Pořadí se počítá zvlášť pro každou kategorii podle zvoleného modelu bodování.
• Stažené hlídky se do pořadí nepočítají a jsou označené jako „nedostavila se“.
• Detail hlídky ukazuje rozpad bodů po stanovištích a rozdíl proti nejlepšímu.
• Odkaz je chráněný přístupovým kódem, který zadá návštěvník při prvním otevření.
• Výsledky jdou vytisknout, součástí tisku je i QR kód na online verzi.
• U opravených bodů je vidět, že byly upraveny, a kdy — bez důvodu a bez jména.

• Aplikace je PWA — dá se přidat na plochu telefonu a spustit jako běžná aplikace.
• Seznam hlídek a kritéria stanoviště se drží v paměti zařízení, takže se načtou i bez sítě.
• Zápisy bodů i rozepsaná zpětná vazba jdou do fronty a odešlou se automaticky po obnovení signálu.
• Frontu nevyprázdní ani obnovení stránky nebo nové přihlášení.
• V patičce je verze aplikace a hash buildu — podle nich se pozná zařízení, které běží na staré verzi.
• Když je k dispozici nová verze, aplikace nabídne aktualizaci.