Relace¶
Relace představuje návštěvu uživatele v zóně — od vstupu až po odchod.
Zahájení relace¶
- Na dashboardu vyberte zónu
- Klikněte na Zahájit relaci
- Systém ověří podmínky (kredit, kapacita, provozní hodiny)
- Primární zařízení (zámek) se odemkne
- Sekundární zařízení (světla) se zapnou
Chování zámku při vstupu¶
Způsob otevření zámku závisí na nastavení lock_mode na zařízení:
| Režim | Chování |
|---|---|
permanent |
Zámek se odemkne trvale — zůstane otevřený po celou dobu relace |
short_open_5s |
Zámek se odemkne na 5 sekund a automaticky se zavře |
short_open_10s |
Zámek se odemkne na 10 sekund a automaticky se zavře |
Co vidíte během aktivní relace¶
Panel aktivní relace má jasnou hierarchii — nejdůležitější nahoře, podrobnosti schované:
1. Přehled (vždy viditelný)
- Název zóny a doba pobytu ve formátu 42 min nebo 1 h 12 min (bez sekund)
- Cena z vyúčtování serveru, vždy jen orientační (≈ 84 Kč, bez živě běžících čísel) a pod ní aktuální sazba. Podle situace se místo ceny zobrazí:
- Zaplaceno vstupem — u vstupních zón (případně „+ X Kč za zařízení“, pokud zařízení něco stojí navíc)
- Zdarma · název produktu — relaci plně pokrývá permanentka nebo jiný produkt
- Zdarma (admin) — administrátorský účet
- Štítky se objevují jen tehdy, když jsou důležité:
- Automatický konec u vstupních zón s časovým limitem: dokud zbývá víc než 5 minut, vidíte jen klidné „Konec v HH:MM“; při 5 minutách a méně žlutý štítek, při poslední minutě červený s odpočtem m:ss
- Kvóta — když zbývá méně než 20 % některého limitu, nebo je vyčerpán
- Dnes mimo provoz — pokud je pro zónu na dnešek naplánovaná uzavírka
2. Tlačítko Ukončit (a nad ním případné upozornění)
Červené tlačítko Ukončit je hned pod cenou, takže ho nemusíte hledat. Pokud jsou zavřené všechny hlavní dveře zóny (primární zámky v režimu permanent), zobrazí se nad ním žluté upozornění: Dveře jsou zamčené, ale akce stále běží a účtuje se. Upozornění zmizí, až se některé z hlavních dveří znovu odemknou nebo akci ukončíte.
3. Ovládání zařízení
Sbalený panel (výchozí stav si prohlížeč pamatuje). V záhlaví je shrnutí i ve sbaleném stavu: počet zařízení, stav hlavních dveří (Zamknuto / Odemknuto) a světel (Rozsvíceno / Zhasnuto) a varování, pokud je některé zařízení offline nebo má neověřený stav. Po rozbalení má každé zařízení vlastní dlaždici s aktuálním stavem (viz níže).
4. Detail účtu
Sbalený panel (výchozí stav si prohlížeč pamatuje). V záhlaví je shrnutí, např. Sazba 2 Kč/min · 120 Kč/h do 18:00 · sleva −45 Kč (při zalomení řádku nikdy nezačíná ani nekončí oddělovačem „·“). Po rozbalení uvidíte aktuální sazbu a do kdy platí, čas zahájení, položky účtu (poplatky a slevy), aktivní produkty včetně věrnostního postupu, kvótu a nadcházející uzavírky.
Ovládání zařízení během relace¶
Během aktivní relace můžete ovládat zařízení přiřazená k zóně. Každé zařízení je jedna dlaždice na celou šířku (vždy jedna na řádek): vlevo ikona zařízení, vedle ní název, případně sazba a — jen když něco nesedí — řádek s problémem. Pod tím jsou tlačítka vždy pod sebou.
- Světla — Rozsvítit / Zhasnout.
- Zásuvky — Zapnout / Vypnout.
- Zámek s trvalým otevřením (
permanent) — Odemknout / Zamknout (s ikonou odemčeného / zamčeného zámku — stejné popisky jako u zámku s krátkým otevřením). - Zámek s krátkým otevřením (
short_open_5s/short_open_10s) — jediné tlačítko Odemknout; po úspěchu se na něm zobrazí odpočet „Otevřeno · 5 s“ (čistě informativní, tlačítko je během něj neaktivní). Odpočet naběhne i tehdy, když zámek otevřelo samotné zahájení relace (hlavní dveře), a pokračuje i po obnovení stránky.
Všechny příkazy jsou explicitní (nikdy přepínání).
Zobrazuje se jen skutečný stav
Když zařízení svůj stav skutečně potvrdilo, je tlačítko odpovídající aktuálnímu stavu tiché (obrys s ✓ a názvem stavu: „✓ Rozsvíceno“, „✓ Zhasnuto“, „✓ Zapnuto“, „✓ Vypnuto“, „✓ Odemknuto“, „✓ Zamknuto“) a ikona dlaždice se obarví (světlo žlutě, zásuvka a zámek zeleně). Druhé tlačítko je plné a nese akci („Zhasnout“, „Rozsvítit“, „Odemknout“, …). Tiché tlačítko lze stisknout dál — znovu odešle stejný explicitní příkaz.
Zařízení, které stav hlásit neumí (např. REST zařízení bez status_pin), nemá stav potvrzený: obě tlačítka jsou stejně důležitá a pod názvem je řádek „? Stav neověřen · naposledy zapnuto 18:02“ podle posledního příkazu — i od jiného uživatele nebo z automatiky. Stav se nikdy neukládá v prohlížeči; zdrojem pravdy je vždy server. Žádná „online“ kontrolka se nezobrazuje, jen problém: nedostupné zařízení má štítek „Offline“, tlačítka zůstávají aktivní (selhání příkazu se zobrazí chybovou hláškou).
Během odesílání příkazu jsou všechna tlačítka zařízení zablokovaná a na stisknutém se točí indikátor; po úspěchu se stav okamžitě znovu načte ze serveru.
Provozní hodiny
Mimo provozní hodiny zóny nelze spustit novou relaci. Aktivní relace jsou po uplynutí provozní doby + 10 minut automaticky ukončeny. Administrátoři mají výjimku ze všech omezení.
Časová osa¶
V detailu relace je k dispozici časová osa událostí:
- Zahájení relace
- Otevření/zavření zařízení
- Zapnutí/vypnutí světel
- Ukončení relace
Pokud se příkaz zařízení nepovede (zařízení neodpovídá, odmítlo příkaz nebo je špatně nastavené), zobrazí se v časové ose u dané události červený štítek Selhalo s důvodem (např. „zařízení neodpovědělo včas“) a poznámkou, že pokus není započítán do ceny. Událost se štítkem Neodesláno znamená, že se příkaz záměrně neposlal, protože zónu ještě používají ostatní hráči; do ceny se počítá normálně. Administrátor v časové ose navíc vidí technický detail chyby.
Ukončení relace¶
- V panelu aktivní relace klikněte na červené tlačítko Ukončit (pod cenou, nad sekcemi s ovládáním a detailem účtu)
- Otevře se potvrzení, které si vždy čerstvě načte vyúčtování ze serveru: dobu pobytu, položky a celkovou cenu a také to, jak se zaplatí:
- Vstup je již zaplacen (vstupní zóny; případně doplatek za zařízení)
- řádek Hrazeno (název produktu / administrátor) v části Úhrada
- řádek Zaokrouhlení před řádkem Celkem, pokud se cena zaokrouhlila (např. 820,30 → 820 Kč); řádky se zobrazují s haléři
- Z kreditu: X Kč a K doplacení: Y Kč, pokud kredit nestačí (kredit se strhává jen v celých korunách, zbylé haléře zůstanou na účtu)
- Potvrďte tlačítkem Ukončit (nebo se vraťte tlačítkem Zpět). Konečná částka se počítá v okamžiku ukončení, proto se může o pár sekund lišit od náhledu.
- Všechna sekundární zařízení se vypnou
- Systém spočítá cenu (u time-based zón)
- Kredit se strhne (nebo se navýší dluh)
- Pokud jste poslední uživatel v zóně, zámek se zavře
Automatické otevření ukončení po zamčení dveří
Když v ovládání zařízení úspěšně zavřete (zamknete) poslední z hlavních dveří zóny (primární zámky v režimu permanent), aplikace sama otevře stejné potvrzení ukončení, jako kdybyste klikli na Ukončit. Zákazník, který zamkne a odchází, tak nezůstane omylem účtován. Tlačítkem Zpět akci necháte běžet dál; upozornění nad tlačítkem Ukončit pak zůstává. Potvrzení se otevírá jen vaším vlastním zamknutím — ne po načtení stránky, ani když dveře zavře automatika nebo jiný uživatel. Zavření vedlejších zámků, zámků s krátkým otevřením a světel ho nevyvolá.
Co se děje při ukončení¶
Entry-based zóna:
- Cena už byla zaplacena při vstupu
- Zařízení se vypnou
- Relace se označí jako dokončená
Time-based zóna:
- Spočítá se celková doba pobytu
- Aplikují se cenová pravidla (viz Ceníky)
- Aplikují se slevy z produktů (pokud existují)
- Strhne se kredit:
- Plně pokryto kreditem →
paid = true - Částečně pokryto → strhne se co je k dispozici, zbytek se stane dluhem
- Nulová cena (produkt/admin) →
paid = true
- Plně pokryto kreditem →
- Pokud zbývá nedoplatek, vygeneruje se QR kód pro platbu
Poslední uživatel¶
Pokud jste poslední uživatel v zóně (žádná další aktivní relace), systém:
- Zavře všechna primární zařízení (zámky)
- Vypne všechna sekundární zařízení (světla, zásuvky)
Stavy relace¶
| Stav | Popis |
|---|---|
pending |
Vytvořena, čeká na otevření zařízení |
active |
Probíhající relace |
completed |
Ukončená |
cancelled |
Zrušena (selhání při otevírání zařízení) |