Ak čítaš príručku prvýkrát a zajtra ideš zapisovať na súťaž, stačí ti táto jedna sekcia. Všetko ostatné je podrobnejšie vysvetlenie.

Pri požiarnom útoku sa merajú dva prúdy – ľavý (LP) a pravý (PP). Ty zadávaš len tieto dve čísla, systém z nich odvodí všetko ostatné.

Príklad zhody časov

Obidve družstvá majú rovnaký výsledný čas 16.48. Vyhráva Zálesie, lebo má lepší zostrek. Riadok, kde o poradí rozhodol zostrek, je vo výsledkoch označený ikonou.

Ako ide rýchly zápis

Čo si zapamätať

• Prázdne pole = neplatný prúd. Keď družstvo nedostreklo, pole nechaj prázdne a vyber verdikt NP.
• Poradie pokusu sa doplní samo podľa toho, koľkýkrát družstvo v danej kategórii štartuje.
• Kategória sa prepína hore a platí pre celú obrazovku, takže sa nedá omylom zapísať ženský čas do mužskej kategórie.
• Opravy priamo v riadku. Prepíšeš čas, klikneš vedľa a uloží sa; zelený prúžok znamená uložené, červený chybu.
• Čiarka aj bodka fungujú rovnako – 16,48 aj 16.48.

Štartové čísla

Štartové čísla bežia cez celú udalosť od 1 po toľko, koľko je v nej prihlášok – nie zvlášť od jednotky v každej kategórii. Dvojka je v udalosti jedna jediná. Tak to chodí aj na súťaži: hlásateľ volá číslo a nikto sa nepýta, z ktorej kategórie je.

Číslo patrí prihláške, teda družstvu v konkrétnej kategórii. Družstvo, ktoré behá šport aj klasiku, má preto dve rôzne čísla – sú to dva samostatné štarty a aj na papierovej štartovke stoja zvlášť.

• Keď číslo zadáš niekomu a drží ho už iná prihláška, systém zápis odmietne a povie, kto ho má – aj s kategóriou.
• Pri druhom pokuse tej istej prihlášky číslo vypĺňať nemusíš – prevezme sa.
• Pole v zápise ponúka ako nápovedu najbližšie voľné číslo.
• Čísla nie sú povinné. Bez nich sa poradie riadi tým, ako boli družstvá pridané.

Podľa štartových čísel sa počíta aj to, kto nasleduje v prekrytí pre OBS: na rad ide ďalšie číslo v poradí, aj keď patrí do inej kategórie. Po poslednom čísle už nenasleduje nikto.

Prečíslovanie starej udalosti

Udalosti z čias, keď sa čísla viedli zvlášť pre každú kategóriu, majú jednotku aj dvojku viackrát. Také čísla si navzájom prekážajú a nedá sa zapísať nový pokus s takým číslom.

Systém to zbadá sám: nad zápisom sa objaví žltý pruh so zoznamom sporných čísel a tlačidlom Prečíslovať od 1. Po stlačení dostane celá udalosť čísla 1 až N.

• Kategórie zostanú pokope – ženy nadviažu na mužov, neprestriedajú sa s nimi.
• V rámci kategórie sa zachová doterajšie poradie; prihlášky bez čísla idú na koniec svojej kategórie.
• Všetky pokusy tej istej prihlášky dostanú rovnaké číslo.

Pokus na základni

Nad formulárom je pruh Na základni. Vyberieš družstvo, ktoré sa práve chystá štartovať, a stlačíš Postaviť. Od tej chvíle ho vidia diváci na stránke udalosti aj prekrytie v OBS – ešte predtým, než dobehne.

Po zapísaní jeho času sa základňa uvoľní sama, takže sa o to nemusíš starať. Ak družstvo odstúpi, uvoľníš ju tlačidlom Uvoľniť.

Ponuka obsahuje len družstvá zapísané v tejto udalosti a je rozdelená podľa kategórií – Muži · Šport, Muži · Klasika, Ženy · Šport a tak ďalej. Kategória sa teda preberie z vybranej položky a družstvo, ktoré behá šport aj klasiku, je v zozname dvakrát – zakaždým so svojím štartovým číslom.

Čísla v ponuke bežia od 1 cez celú udalosť, nie od jednotky v každej kategórii. Ak sa ti v zozname opakujú, udalosť treba prečíslovať – viď vyššie.

Podľa družstva na základni systém zároveň vypočíta, kto ide po ňom, a ukáže to v prekrytí pre OBS. Berie sa ďalšie štartové číslo v poradí, aj keď patrí do inej kategórie; keď sa štartové čísla nevedú, ide ďalšie družstvo bez zapísaného času.

Elektronická časomiera môže časy posielať priamo do systému. Nepotrebuje prihlásenie ani knižnice – stačí jedno volanie adresy.

Volanie

Družstvo sa posielať nemusí. Systém si pokus odvodí z toho, kto je v udalosti práve na základni – stačia teda časy:

GET /device.php?dev=zakladna1&key=TAJNY_KLUC&lp=16.21&pp=16.48

OK 16.48 3        ← uložené · výsledný čas · poradie
ERR dovod         ← nezapísalo sa

Čo zariadenie nesmie

• Zapisovať do udalosti, ku ktorej nie je pridelené.
• Zapisovať do ukončenej alebo zrušenej udalosti.
• Zakladať družstvá ani udalosti – tie musia existovať vopred.
• Čokoľvek čítať. Rozhranie slúži výhradne na zápis časov.

Ak kľúč unikne, v správe zariadení vygeneruješ nový a starý okamžite prestane platiť. Oprávnenia: device.manage zakladá, device.assign prideľuje, device.log vidí denník.

Živý prenos

Prepni stav udalosti na Prebieha. Divákom na stránke udalosti sa výsledky obnovujú samy – nový čas sa zelene rozsvieti, opravený žlto. Obnovuje sa len výsledková časť, takže nikomu nepreskočí obrazovka.

Server pri každom dotaze porovná odtlačok stavu udalosti. Ak sa nič nezmenilo, odpoveď má pár desiatok bajtov – pri stovke divákov je to rozdiel medzi znesiteľnou a zabitou databázou. Odtlačok zahŕňa aj časy prúdov, takže sa prejaví aj oprava, ktorá nezmenila výsledný čas.

Premietanie na projektor

Menu udalosti → Premietať výsledky. Otvorí sa samostatné okno, ktoré presunieš na projektor a klávesou F roztiahneš na celú obrazovku. V pôvodnom okne medzitým ďalej zapisuješ.

Nastavenie premietania

Ozubené koliesko vpravo otvorí panel, kde si zmeníš:

• Stĺpce a riadky – koľko družstiev sa zmestí na obrazovku. Písmo sa dopočíta samo: pri 3 × 2 sú čísla veľké na celú sálu, pri 6 × 8 sa zmenšia.
• Striedanie kategórií – za koľko sekúnd sa prepne kategória.
• Listovanie strán – za koľko sekúnd sa prelistuje strana. Kratší čas sa hodí pri veľkom štartovom poli.
• Pevná kategória – keď chceš premietať len jednu.

Na ďalšiu kategóriu sa prepne až po prejdení všetkých strán, takže nikto nevypadne. Keď prepneš kategóriu ručne, automatika sa na pol minúty odloží. Rovnaké voľby fungujú aj v adrese (cols, rows, rotate, pagesec, cat), takže si premietanie uložíš ako záložku.

Spodný pás sa prepisuje podľa práve zobrazenej kategórie – najlepší pokus, najlepší zostrek, počet družstiev aj úspešnosť teda platia pre to, čo je na plátne.

Prekrytie je úzky pruh s výsledkom, ktorý sa v OBS položí na obraz z kamery. Pozadie je priehľadné, obnovuje sa samo. Odkazy nájdeš na stránke udalosti dole v časti Prekrytia pre OBS.

Čo prekrytie ukazuje

• Družstvo, ktoré práve dobehlo aj so zborom a kategóriou.
• Priebežné poradie v kategórii – prepočíta sa hneď po zápise.
• Verdikt farebným štítkom: OK zeleno, NP žlto, D červeno, N/A sivo.
• Na základni – jantárový pruh s družstvom, ktoré sa práve chystá štartovať, aj s jeho kategóriou.
• Nasleduje – družstvo, ktoré ide po tom na základni, aj s kategóriou (napríklad DHZ Imeľ · Muži · Šport). Keď na základni nikto nestojí, počíta sa od posledného zapísaného času.

Nastavenie v OBS

Liga je seriál súťaží. Udalosť do nej zaradíš pri jej úprave – zaškrtneš ligu, zadáš číslo kola a prípadne koeficient, ak má kolo vyššiu váhu.

Ktorý pokus sa počíta do ligy

Súpiska ligy

Zoznam prihlásených družstiev nastavíš raz za sezónu v Správa → Ligy → súpiska. Pri každom družstve sa dá určiť aj kategória, takže družstvo prihlásené v kategórii šport-muži sa v klasike nezapočíta. Po prvom kole sa dá súpiska naplniť jedným klikom zo štartovky.

Bodovanie

• Body podľa umiestnenia v kole, podľa bodovacej tabuľky ligy (predvolene 25-22-20-18-16… do dvadsiateho miesta).
• Poradie sa počíta medzi ligovými družstvami, nie medzi všetkými štartujúcimi.
• Škrtacie kolá nastavíš poľom „Počíta sa najlepších N kôl“.
• Ktorý pokus sa berie – najlepší, alebo len prvý – určuje nastavenie ligy.
• Pri rovnosti bodov rozhoduje počet víťazstiev, potom najlepší čas sezóny.

Na stránke ligy sú aj rebríčky najlepších pokusov a zostrekov – počítajú sa naprieč všetkými ročníkmi seriálu, takže vidíš aj historické maximá. Platia pre ne rovnaké podmienky ako pre tabuľku: súpiska aj kategória musia sedieť.

Okrem oprávnení sa dá obmedziť aj to, ktoré udalosti človek spravuje. Hodí sa, keď kolá ligy usporadúvajú rôzne zbory a každý si má odbaviť to svoje.

Kontrola beží na stránke aj pri ukladaní – skryté tlačidlo nie je jediná ochrana. Kto má udalosť spravovať, je vidieť priamo pod jej názvom. To isté pravidlo platí pre meracie zariadenia: prideliť ich smieš len k udalosti, ktorú sám spravuješ.

Každý účet má jednu rolu a tá určuje, čo smie. Podrobný rozpis aj možnosť oprávnenia prehadzovať je v Správa → Role.

vlastné znamená, že oprávnenie platí len na družstvo z profilu alebo na udalosť, ktorú človek spravuje. pridelené znamená, že ho treba zaškrtnúť pri konkrétnej udalosti. Divák je predvolená rola nového účtu – vidí presne to, čo každý neprihlásený návštevník.

Jednotlivé oprávnenia

Toto je úplný zoznam toho, čo sa dá rolám zaškrtnúť v Správa → Role. Rovnaké kódy používa systém aj vo výpisoch chýb, takže keď niekomu niečo nejde, nájdeš tu, čo mu chýba.

Ako role prideľovať

• Časomerač zapisuje len tam, kam ho pridelíš. Otvor udalosť → Upraviť → Kto smie udalosť spravovať a zaškrtni ho. Je to krok navyše, ale pozvaný časomerač tak nezasiahne do cudzích súťaží.
• Vedúcemu družstva nastav v profile domovské družstvo, inak sú jeho oprávnenia neúčinné.
• Vedúci nemôže povýšiť sám seba – prideliť smie len role nižšie, než má on.
• Tréner a časomerač nemajú celoplošné práva. Ak majú spravovať cudziu súťaž, pridaj ich medzi správcov tej udalosti.

Družstvo má súpisku – členov na konkrétnych pozíciách (kôš, strojník, savičiar, rozdeľovač, prúdari, béčkar, veliteľ, náhradník). Jeden človek môže byť vo viacerých družstvách a v každom na inej pozícii.

Založenie družstva

Správa → Družstvá → Pridať. Povinný je len názov, ale oplatí sa vyplniť viac:

• Názov tak, ako sa má písať vo výsledkoch – napríklad DHZ Zálesie A. Áčko a béčko sú samostatné družstvá.
• Skratka sa použije tam, kde je málo miesta – v premietaní a na úzkom mobile.
• Zbor a obec sa ukazujú pod názvom v prekrytí aj vo výsledkoch.
• Kategória podľa pohlavia patrí k družstvu natrvalo. Športovú kategóriu (šport/klasika) družstvo nemá – tá sa určuje až pri konkrétnom pokuse, lebo to isté družstvo môže behať oboje.
• Farba sa používa na odlíšenie v grafoch a porovnaniach.

Družstvo, ktoré už má zapísané výsledky, nemaž – odškrtni mu aktívne. Zmizne z bežných ponúk, ale výsledky aj história zostanú.

Založenie člena

Správa → Členovia → Pridať: meno, priezvisko, prípadne prezývka a rok narodenia. V tom istom formulári sa rovno priraďuje do družstiev – pri každom si vyberieš pozíciu, číslo dresu a či je kapitán. Práve tu urobíš z jedného človeka člena mužov aj dorastu naraz.

Telefón a e-mail vidí len ten, kto spravuje členov.

Zápis dochádzky

Vyhodnotenie nájdeš na troch miestach: pri udalosti (súhrn po družstvách), pri družstve (graf účasti, najspoľahlivejší člen a kto najviac chýba) a pri členovi (história, séria účastí, porovnanie s priemerom družstva).

„Najviac chýba“ sa počíta podľa počtu neúčastí, nie podľa percenta – inak by vyhral ten, kto má málo zápisov. Berú sa len členovia s aspoň tromi zápismi, aby jedna neúčasť nerozhodovala.

Účty

Správa → Používatelia. Pri zakladaní účtu zadáš prihlasovacie meno, heslo a rolu – tá rozhoduje o všetkom ostatnom. Ak ide o človeka z družstva, nastav mu aj domovské družstvo: bez neho sú oprávnenia typu „vlastné“ neúčinné, lebo systém nevie, čo je jeho.

Vedúci družstva smie zakladať účty len vo svojom družstve a len s rolou nižšou, než má sám – nemôže teda vyrobiť ďalšieho administrátora.

Zabudnuté heslo

Keď je nastavený odosielateľ pošty, na prihlasovacej stránke pribudne odkaz Zabudnuté heslo?. Človek zadá e-mail, príde mu správa s odkazom a nastaví si nové heslo sám – administrátora na to netreba.

• Odkaz platí 1 hodinu a dá sa použiť raz.
• Nový odkaz zruší ten predchádzajúci.
• Stránka odpovedá rovnako pri existujúcom aj neexistujúcom e-maile – inak by sa dalo skúšaním zistiť, kto v systéme účet má.
• Po zmene hesla sa zruší aj prípadné zamknutie prihlasovania.
• V databáze je uložený len odtlačok odkazu, nie odkaz samotný.

Nastavuje sa v config/config.php, v časti Odosielanie e-mailov. Treba vyplniť server, port, šifrovanie a prihlasovacie údaje; stav aj skúšobnú správu nájdeš v Správa → E-mail.

Registrácia zvonku

Systém vie nechať ľudí zaregistrovať sa samých. Prepína sa to konštantou ALLOW_REGISTRATION v config/config.php a novoprihlásený dostane rolu z DEFAULT_ROLE_CODE – predvolene Divák, teda len prehliadanie.

Číselníky

Správa → Číselníky drží veci, z ktorých sa skladá všetko ostatné:

• Športové kategórie – napríklad Šport a Klasika.
• Kategórie podľa pohlavia – Muži, Ženy, prípadne dorast.
• Typy udalostí – súťaž, tréning, pohár. Pri type sa určuje, či sa z neho počítajú rebríčky.
• Pozície v družstve – kôš, strojník, savičiar, prúdari…
• Typy meraných časov – prúdy, predvolene ľavý a pravý.

Protokol činnosti

Správa → Protokol činnosti zaznamenáva, kto čo urobil – zápis a mazanie pokusov, zmeny udalostí, prihlásenia aj spustené migrácie. Keď sa niekto pýta „kto to zmazal“, odpoveď je tu. Čítať ho smie rola s oprávnením log.view.

Vyhľadávanie

Pole Hľadaj v hornej lište prehľadá naraz družstvá, udalosti, členov aj ligy. Stačia dva znaky. Mená členov sa ukážu len prihlásenému používateľovi a neverejné udalosti len tomu, kto na ne má prístup – neprihlásený návštevník tieto časti výsledkov vôbec nevidí.

Všade, kde má zmysel rozlišovať šport a klasiku či mužov a ženy, sú dáta rozdelené podľa kategórií a farebne odlíšené.

Stránka compare.php postaví dve družstvá vedľa seba. Otvoríš ju zo zoznamu družstiev alebo z menu konkrétneho družstva – vtedy je už jedna strana predvyplnená.

• Vzájomné súboje – udalosti, kde obe družstvá štartovali v tej istej kategórii, so skóre a časmi z každej z nich.
• Čísla po kategóriách – najlepší pokus, najlepší zostrek, priemerný čas, úspešnosť, počet pokusov a udalostí. Lepšia hodnota je zvýraznená.

Kategórie, v ktorých štartovalo len jedno z družstiev, sú označené a druhá strana zostane prázdna – nulami by to vyzeralo, akoby tam družstvo malo nulovú úspešnosť.

Import z Excelu

Správa → Import. Načíta .xlsx aj CSV. Postup má štyri kroky a nič sa nezapíše, kým to nepotvrdíš.

Importovať sa dajú družstvá, členovia, kalendár udalostí, výsledky s časmi aj bodovacia tabuľka. Verdikty prijíma v podobe OK, NP, D, N/A aj slovom.

Čo vieš vytlačiť a stiahnuť

V exportoch sú časy uložené ako čísla, takže sa v Exceli dajú rovno počítať a triediť. Sťahovanie je viazané na oprávnenie export.data, import na import.data.

Aplikácia v telefóne

Portál sa dá nainštalovať na plochu – v Chrome sa objaví tlačidlo Inštalovať, na iPhone Zdieľať → Pridať na plochu. Stránky, ktoré si už otvoril, zostanú čitateľné aj bez signálu.

Prihlásenie odtlačkom prsta

V profile → Nastaviť na tomto zariadení. Telefón si vypýta odtlačok a kľúč zostane v ňom; na server sa posiela len podpis, nikdy nie odtlačok. Nastaviť sa dá na viacerých zariadeniach a ktorékoľvek sa dá zrušiť.

Meno pri prihlásení vypĺňať netreba. Keď to prehliadač podporuje, kľúč sa ponúkne priamo v našepkávači pri poli s menom – stačí ho potvrdiť odtlačkom. Tlačidlo Prihlásiť sa odtlačkom prsta zostáva ako druhá cesta.

Vyžaduje HTTPS. Na http://localhost to prehliadač povolí, cez IP adresu v sieti už nie.

Chod bez internetu

Systém vie bežať úplne offline – na localhose aj v uzavretej sieti. Riadi to konštanta APP_OFFLINE v konfigurácii. Namiesto knižníc z internetu sa použijú vlastné súbory v assets/vendor/: mriežka, ikony, písma, triedenie tabuliek, grafy aj vyhľadávacie výbery. Podrobnosti sú v súbore INSTALL-LOCALHOST.md.

Rozšírenia databázy

Každá väčšia funkcia má vlastnú migráciu v priečinku sql/. Stav uvidíš v Správa → Stav databázy, odkiaľ sa dajú aj spustiť. Zisťuje sa podľa skutočného stavu tabuliek, nie podľa evidencie, a dajú sa spustiť opakovane.

Prihlasovanie je chránené proti hádaniu hesla: po piatich neúspešných pokusoch sa kombinácia mena a IP zamkne na pätnásť minút. Zamknutia nájdeš v protokole činnosti pod login.blocked.

Niečo tu chýba alebo je napísané nejasne? Napíš to správcovi systému – príručka sa dá doplniť.