• Docs
• Nastavenia
• Aquapark
• Aquapark nastavenia

Aquapark nastavenia

Aquapark

V tejto sekcii nastavuješ integráciu s aquaparkovým systémom a čítačkami prístupových kariet. Používaš ju vtedy, keď potrebuješ prepojiť Ellipse Cloud s čítačkami pri vstupe do aquaparku, priradiť im prístupové úrovne, nastaviť toleranciu vstupu alebo určiť, ktorá pokladňa bude tlačiť vstupenky. Obrazovka obsahuje dve vnútorné záložky: Aquapark (prevádzkové nastavenia) a MagicHome (konfigurácia čítačiek a Building Assistant API).

Kde to nájdeš

Otvor ľavé menu a klikni na Nastavenia → Aquapark. Adresa v prehliadači bude /manager/settings/hgaquapark/. Po otvorení uvidíš v hornej časti stránky submenu s ďalšími záložkami (Front, Import, Sklad priemerka, Card date, Logs, HGconfig, Servis, Aquapark, MagicHome, Notifikácie). Kliknutím na Aquapark sa dostaneš na prevádzkové nastavenia aquaparku, kliknutím na MagicHome na konfiguráciu čítačiek a API pripojenia.

Čo tu môžeš robiť

• Nastaviť prístupové úrovne pre aquapark: Priraď čítačkám konkrétne prístupové úrovne (napr. „dospelý", „dieťa", „senior"), ktoré určujú, kto môže prejsť cez turniket.
• Určiť toleranciu vstupu: Zadaj časový interval v minútach, počas ktorého môže hosť použiť vstupovú kartu po jej aktivácii.
• Priradiť pokladňu pre tlač vstupeniek: Vyber, ktorá pokladnica (register) bude tlačiť vstupenky pri vstupe do aquaparku.
• Povoliť kontrolu odchodu: Zapni alebo vypni kontrolu pri východe z aquaparku (či systém má overovať, že hosť skutočne opúšťa areál).
• Označiť čítačky ako východ: Nastav, ktoré čítačky slúžia na odchod (nie na vstup).
• Zapnúť/vypnúť MagicHome modul: Aktivuj alebo deaktivuj integráciu s MagicHome čítačkami pomocou prepínača v záložke MagicHome.
• Konfigurovať Building Assistant API: Zadaj prihlasovacie údaje a endpoint pre komunikáciu s Building Assistant systémom, ktorý spravuje čítačky.
• Otestovať pripojenie k Building Assistant: Klikni na testovacie tlačidlá (AUTH, READERS, OBJECTS), aby si overil, či API komunikácia funguje správne.
• Označiť čítačky pre ubytovanie a aquapark: V záložke MagicHome zaklikni, ktoré čítačky patria k recepcii (Ubytovanie) a ktoré k aquaparku (Aquapark).
• Filtrovať čítačky: Použi vyhľadávacie pole na rýchle nájdenie čítačky podľa UID, názvu alebo zóny.
• Uložiť zmeny: Po úprave nastavení klikni na tlačidlo Uložiť, aby sa zmeny aplikovali.

Postup krok za krokom

Nastavenie prístupových úrovní a pokladne pre aquapark

1. Otvor Nastavenia → Aquapark a uisti sa, že si v záložke Aquapark (nie MagicHome).
2. V sekcii s prístupovými úrovňami vyber pre každú čítačku zodpovedajúcu úroveň (napr. „dospelý", „dieťa", „senior") z rozbaľovacieho menu. Ak čítačka nemá priradenú úroveň, zobrazí sa „-".
3. Do poľa Tolerancia vstupu zadaj počet minút, počas ktorých môže hosť použiť kartu po jej aktivácii (napr. 15 minút).
4. V poli Pokladňa pre tlač vstupeniek vyber pokladnicu, ktorá bude tlačiť vstupenky pri vstupe do aquaparku.
5. Ak chceš kontrolovať odchod, zaklikni políčko Kontrolovať odchod.
6. Ak máš čítačky na výstupe, zaklikni ich v stĺpci Východ.
7. Klikni na tlačidlo Uložiť v spodnej časti formulára. Zobrazí sa hlásenie „Aquapark nastavenia boli uložené".

Konfigurácia Building Assistant API a označenie čítačiek

1. Otvor Nastavenia → Aquapark a klikni na záložku MagicHome v hornom submenu.
2. Ak chceš aktivovať MagicHome modul, prepni prepínač MagicHome do polohy „Zapnuté". Zmena sa uloží automaticky.
3. V sekcii Building Assistant API vyplň polia:
   • API Base URL: adresa Building Assistant servera (napr. https://api.buildingassistant.sk).
   • Cloud ID: identifikátor tvojho cloudu v Building Assistant.
   • Username: prihlasovacie meno do Building Assistant.
   • Password: heslo do Building Assistant.
   • Token TTL (sekundy): platnosť autentifikačného tokenu (predvolene 43200 sekúnd = 12 hodín).
4. Klikni na tlačidlo Uložiť v spodnej časti sekcie Building Assistant API. Zobrazí sa hlásenie „MagicHome nastavenia boli uložené".
5. Otestuj pripojenie kliknutím na tlačidlá Test AUTH, Test READERS alebo Test OBJECTS. Ak je pripojenie úspešné, zobrazí sa zelené hlásenie „Building Assistant: AUTH OK" (alebo READERSLIST OK / OBJECTSPREVIEW OK). Ak test zlyhá, zobrazí sa červené hlásenie s chybou.
6. V tabuľke čítačiek zaklikni políčka v stĺpci Ubytovanie pre čítačky, ktoré patria k recepcii.
7. Ak máš zapnutý aquapark modul, zaklikni políčka v stĺpci Aquapark pre čítačky, ktoré patria k aquaparku.
8. Klikni na tlačidlo Uložiť pod tabuľkou. Zmeny sa uložia a stránka sa obnoví.

Polia, stĺpce a nastavenia

Záložka Aquapark

• Prístupová úroveň (accesslevel): Rozbaľovacie menu pri každej čítačke, kde vyberáš, akú úroveň vstupu má čítačka kontrolovať (napr. „dospelý", „dieťa", „senior"). Ak nevyberieš nič, zobrazí sa „-" a čítačka nebude aktívna. Toto pole určuje, ktoré typy vstupeniek môžu prejsť cez danú čítačku.
• Tolerancia vstupu (tolerance): Číselné pole, kde zadávaš počet minút, počas ktorých môže hosť použiť vstupovú kartu po jej aktivácii na pokladni. Napríklad ak zadáš 15, hosť má 15 minút na to, aby prešiel cez turniket. Po uplynutí tejto doby karta prestane byť platná.
• Pokladňa pre tlač vstupeniek (printer): Rozbaľovacie menu, kde vyberáš pokladnicu (register), ktorá bude tlačiť vstupenky pri vstupe do aquaparku. Vyber pokladnicu, ktorá je fyzicky umiestnená pri vstupe alebo ktorú používa recepcia na vydávanie vstupeniek.
• Kontrolovať odchod (checkexit): Zaškrtávacie políčko. Ak ho zaklikneš, systém bude kontrolovať, či hosť skutočne opúšťa aquapark pri východe. Ak políčko nezaklikneš, systém bude sledovať len vstupy.
• Východ (exit): Stĺpec v tabuľke čítačiek. Zaklikni políčko pri čítačke, ktorá slúži na odchod z aquaparku (nie na vstup). Toto nastavenie je dôležité, ak máš oddelené turnikety na vstup a výstup.
• UID (uid): Jedinečný identifikátor čítačky v Building Assistant systéme. Toto pole je len na zobrazenie, nemôžeš ho meniť. Používa sa na filtrovanie a identifikáciu čítačiek v systéme.
• Názov (name): Popisný názov čítačky (napr. „Vstup aquapark hlavný", „Výstup šatne"). Toto pole je len na zobrazenie, pomáha ti rýchlo identifikovať čítačku v zozname.
• Zóna (zone): Názov zóny, do ktorej čítačka patrí (napr. „Aquapark", „Wellness", „Recepcia"). Toto pole je len na zobrazenie, slúži na logické zoskupenie čítačiek.
• Filtrovať (uid, názov, zóna): Vyhľadávacie pole nad tabuľkou čítačiek. Zadaj časť UID, názvu alebo zóny a tabuľka sa automaticky prefiltruje. Používaj ho, keď máš veľa čítačiek a potrebuješ rýchlo nájsť konkrétnu.

Záložka MagicHome

• MagicHome prepínač: Prepínač (toggle) v hornej časti záložky. Ak ho prepneš do polohy „Zapnuté", aktivuješ integráciu s MagicHome čítačkami. Ak ho prepneš do polohy „Vypnuté", integrácia sa deaktivuje a čítačky nebudú komunikovať so systémom. Zmena sa uloží automaticky po prepnutí.
• API Base URL (ba_api_base): Textové pole, kde zadávaš základnú adresu Building Assistant API servera (napr. https://api.buildingassistant.sk). Táto adresa sa používa na všetky API volania. Ak ju zadáš nesprávne, testy pripojenia zlyhajú.
• Cloud ID (ba_cloud_id): Textové pole, kde zadávaš identifikátor tvojho cloudu v Building Assistant systéme. Tento identifikátor ti poskytne správca Building Assistant. Bez neho sa systém nepripojí k API.
• Username (ba_username): Textové pole, kde zadávaš prihlasovacie meno do Building Assistant. Toto meno musí mať oprávnenia na čítanie zoznamu čítačiek a objektov.
• Password (ba_password): Textové pole, kde zadávaš heslo do Building Assistant. Heslo sa ukladá v čistom texte (nie v MD5), systém ho automaticky zahashuje pri autentifikácii.
• Token TTL (sekundy) (ba_token_ttl): Číselné pole, kde zadávaš platnosť autentifikačného tokenu v sekundách. Predvolená hodnota je 43200 sekúnd (12 hodín). Po uplynutí tejto doby sa systém musí znova prihlásiť do Building Assistant API.
• Test AUTH: Tlačidlo, ktoré otestuje prihlásenie do Building Assistant API. Po kliknutí sa zobrazí zelené hlásenie „Building Assistant: AUTH OK", ak je prihlásenie úspešné, alebo červené hlásenie s chybou, ak prihlásenie zlyhalo. Výsledok testu sa uloží do systémového logu.
• Test READERS: Tlačidlo, ktoré otestuje načítanie zoznamu čítačiek z Building Assistant API. Po kliknutí sa zobrazí zelené hlásenie „Building Assistant: READERSLIST OK", ak sa zoznam načítal, alebo červené hlásenie s chybou, ak načítanie zlyhalo.
• Test OBJECTS: Tlačidlo, ktoré otestuje načítanie zoznamu objektov (napr. izieb, zón) z Building Assistant API. Po kliknutí sa zobrazí zelené hlásenie „Building Assistant: OBJECTSPREVIEW OK", ak sa zoznam načítal, alebo červené hlásenie s chybou, ak načítanie zlyhalo.
• Ubytovanie (stĺpec v tabuľke): Zaškrtávacie políčko pri každej čítačke. Zaklikni ho, ak čítačka patrí k recepcii alebo ubytovaniu (napr. čítačka pri vstupe do hotela, pri výťahu na izby). Tieto čítačky sa použijú na kontrolu prístupu hostí do ubytovacích priestorov.
• Aquapark (stĺpec v tabuľke): Zaškrtávacie políčko pri každej čítačke. Zaklikni ho, ak čítačka patrí k aquaparku (napr. čítačka pri vstupe do aquaparku, pri šatniach). Tieto čítačky sa použijú na kontrolu prístupu do aquaparku a na evidenciu vstupov.
• Keyboard, NFC, QR (stĺpce v tabuľke): Indikátory, ktoré zobrazujú, aké typy prístupu čítačka podporuje (klávesnica, NFC karta, QR kód). Tieto polia sú len na zobrazenie, nemôžeš ich meniť. Pomáhajú ti identifikovať, akým způsobom môže hosť použiť čítačku.
• Last respond, Last scan (stĺpce v tabuľke): Časové pečiatky, ktoré zobrazujú, kedy čítačka naposledy odpovedala na API volanie a kedy naposledy zaznamenala sken karty. Tieto polia sú len na zobrazenie, používaj ich na diagnostiku, či čítačka funguje správne.

Tipy a časté chyby

• Nezabudni uložiť zmeny: Po úprave akéhokoľvek nastavenia v záložke Aquapark alebo MagicHome musíš kliknúť na tlačidlo Uložiť. Ak stránku zatvoríš bez uloženia, zmeny sa stratia. Výnimkou je prepínač MagicHome, ktorý sa ukladá automaticky.
• Otestuj pripojenie pred spustením: Pred tým, ako začneš používať aquapark systém, klikni na tlačidlá Test AUTH, Test READERS a Test OBJECTS v záložke MagicHome. Ak niektorý test zlyhá, skontroluj API Base URL, Cloud ID, Username a Password. Časté chyby sú preklepy v URL (napr. chýbajúce https://) alebo nesprávne prihlasovacie údaje.
• Priraď prístupové úrovne všetkým aktívnym čítačkám: Ak čítačka nemá priradenú prístupovú úroveň (zobrazuje sa „-"), nebude kontrolovať vstupy. Uisti sa, že každá čítačka pri vstupe do aquaparku má vybranú správnu úroveň (napr. „dospelý", „dieťa").
• Rozlišuj medzi vstupom a výstupom: Ak máš oddelené turnikety na vstup a výstup, nezabudni zakliknúť políčko Východ pri čítačkách, ktoré slúžia na odchod. Ak toto políčko nezaklikneš, systém bude považovať všetky čítačky za vstupné a evidencia odchodov nebude fungovať správne.
• Nastav dostatočnú toleranciu vstupu: Ak je tolerancia vstupu príliš krátka (napr. 5 minút), hostia môžu mať problém prejsť cez turniket včas (napr. ak sa zdržia pri recepcii alebo v šatni). Odporúčaná hodnota je 15–30 minút.
• Skontroluj, či máš zapnutý aquapark modul: Ak nevidíš záložku Aquapark v submenu, znamená to, že aquapark modul nie je zapnutý v globálnych nastaveniach systému (konštanta AQUAPARK). Kontaktuj administrátora alebo technickú podporu.
• Použij filter pri veľkom počte čítačiek: Ak máš desiatky čítačiek, neprehliadaj vyhľadávacie pole nad tabuľkou. Zadaj časť názvu alebo zóny a tabuľka sa automaticky prefiltruje. Ušetríš si čas pri hľadaní konkrétnej čítačky.
• Nezamieňaj záložky Aquapark a MagicHome: Záložka Aquapark slúži na prevádzkové nastavenia (prístupové úrovne, tolerancia, pokladňa), záložka MagicHome slúži na konfiguráciu API a označenie čítačiek. Ak nevieš, kde hľadať konkrétne nastavenie, skontroluj najprv, v ktorej záložke si.
• Ak test zlyhá, skontroluj debug log: Po každom teste (AUTH, READERS, OBJECTS) sa výsledok uloží do systémového logu. Ak test zlyhá, kontaktuj technickú podporu a poskytni im časovú pečiatku testu. Pomôže to pri diagnostike problému.
• Nezabudni označiť čítačky pre aquapark: V záložke MagicHome musíš zakliknúť políčka v stĺpci Aquapark pri čítačkách, ktoré patria k aquaparku. Ak toto neurobíš, čítačky sa nezobrazia v záložke Aquapark a nebudeš im môcť priradiť prístupové úrovne.