Aplikace Lili Příměsto podporuje řadu volitelných hardwarových modulů, které rozšiřují její základní funkce o automatizovanou docházku, bezkontaktní identifikaci dětí, samoobslužné terminály a další. Každý modul je nezávislý — můžete aktivovat pouze ty, které skutečně potřebujete. Všechny moduly se spravují v sekci Nastavení → Příslušenství.

Aktivace modulů

Před použitím jakéhokoli hardwarového modulu jej musíte nejprve aktivovat v nastavení aplikace. Aktivace zpřístupní příslušné sekce v menu a na dashboardu. Pokud modul deaktivujete, jeho položky z menu zmizí, ale data zůstanou v databázi zachována pro případ, že jej v budoucnu znovu zapnete.

1. Otevřete nastavení aplikace
   V levém postranním menu klikněte na položku Nastavení (ikona ozubeného kola). Otevře se stránka s několika záložkami.
2. Přejděte na záložku Příslušenství
   V horní liště záložek klikněte na poslední záložku s názvem Příslušenství. Zobrazí se seznam všech dostupných hardwarových modulů.
3. Zapněte požadovaný modul
   U každého modulu najdete přepínač (toggle). Kliknutím přepínač přepnete do polohy Zapnuto (zelená barva). Modul se okamžitě aktivuje a jeho položky se objeví v menu.
4. Vypnutí modulu
   Pokud modul již nepotřebujete, klikněte znovu na přepínač a přepněte jej do polohy Vypnuto (šedá barva). Položky zmizí z menu, ale data zůstanou uložená.

RFID čtečky

Modul RFID čtečky umožňuje automatickou evidenci docházky dětí a vedoucích. Když dítě přiloží svou RFID kartu nebo náramek ke čtečce, systém automaticky zaznamená příchod nebo odchod. Odpadá tak nutnost ruční evidence a minimalizuje se riziko chyb.

Jak RFID čtečka funguje

RFID čtečka je fyzické zařízení připojené k místní síti (Wi-Fi nebo Ethernet). Čtečka neustále naslouchá a čeká na přiložení karty. Jakmile detekuje kartu, přečte z ní unikátní identifikátor (UID) a odešle jej prostřednictvím HTTP požadavku na API endpoint aplikace Lili Příměsto. Aplikace UID porovná s databází přiřazených karet a automaticky vytvoří záznam docházky pro příslušné dítě.

Registrace nové čtečky

Po aktivaci modulu RFID čteček přejděte do sekce pro správu čteček. Pro přidání nové čtečky vyplňte následující údaje:

• Název čtečky — srozumitelný název pro identifikaci (např. „Vstup hlavní budova", „Jídelna").
• IP adresa — síťová adresa čtečky v místní síti (např. 192.168.1.100). Čtečka musí mít statickou IP adresu nebo rezervaci v DHCP.
• Typ čtečky — vyberte model nebo protokol, který vaše čtečka používá (závisí na výrobci zařízení).

Monitoring stavu čtečky

Aplikace pravidelně kontroluje dostupnost registrovaných čteček (tzv. health check). U každé čtečky vidíte její aktuální stav:

• Online (zelená) — čtečka je dostupná a připravená ke skenování.
• Offline (červená) — čtečka neodpovídá. Zkontrolujte napájení, síťové připojení a IP adresu.
• Neznámý (šedá) — stav čtečky nebyl dosud ověřen (např. ihned po registraci).

Komunikace čtečky s aplikací

Čtečka komunikuje s aplikací přes REST API endpoint. Když dítě přiloží kartu, čtečka odešle HTTP POST požadavek obsahující UID karty a identifikátor čtečky. Aplikace zpracuje požadavek, ověří kartu v databázi a vytvoří záznam docházky. Celý proces trvá méně než sekundu. Podrobnosti o přiřazení karet k dětem najdete na stránce RFID karty a peněženka a o evidenci docházky na stránce Docházka.

Požadavky na RFID čtečku

• Stabilní připojení k místní síti (Wi-Fi nebo Ethernet).
• Stálé napájení (síťový adaptér nebo PoE — Power over Ethernet).
• Kompatibilní RFID frekvence (dle typu karet používaných v aplikaci — typicky 13,56 MHz pro MIFARE).
• Statická IP adresa nebo DHCP rezervace pro spolehlivou komunikaci.

Chytré náramky

Modul Chytré náramky rozšiřuje funkce RFID karet o nositelné zařízení přímo na zápěstí dítěte. Náramek plní stejnou identifikační funkci jako karta (přiložením ke čtečce se zaznamená docházka), ale nabízí navíc další možnosti.

Funkce chytrých náramků

• Bezkontaktní identifikace — náramek obsahuje RFID/NFC čip, který funguje stejně jako RFID karta. Dítě přiloží zápěstí ke čtečce a docházka se automaticky zaznamená.
• Sledování aktivity — náramek zaznamenává počet kroků a fyzickou aktivitu dítěte během dne. Data se synchronizují s aplikací a zobrazují se v profilu dítěte.
• Počítadlo kroků — vedoucí i rodiče mohou v aplikaci sledovat, jak aktivní dítě během tábora bylo. Data jsou dostupná i v rodičovském portálu.
• Volitelný GPS modul — některé modely náramků podporují GPS lokalizaci. Pokud je tato funkce zapnuta, vedoucí mohou v reálném čase vidět polohu dětí na mapě — ideální pro výlety a venkovní aktivity.

Správa náramků

Náramky se přiřazují k dětem stejným způsobem jako RFID karty — v kartě dítěte nebo v sekci RFID karty a peněženka. Každý náramek má unikátní identifikátor, který se po přiřazení spojí s profilem dítěte. Při předání náramku dítěti doporučujeme ověřit funkčnost přiložením ke čtečce.

Kiosek

Modul Kiosek umožňuje provozovat samoobslužný terminál pro check-in dětí. Kiosek je typicky tablet nebo dotykový displej umístěný u vchodu do budovy nebo v recepci tábora. Dítě přiloží svou RFID kartu nebo náramek ke čtečce připojené ke kiosku a na obrazovce se zobrazí uvítací zpráva s jeho jménem.

Jak kiosek funguje

1. Dítě přijde k terminálu
   U vchodu je umístěn tablet nebo displej s připojenou RFID čtečkou. Na obrazovce se zobrazuje výzva k přiložení karty.
2. Přiloží kartu nebo náramek
   Dítě přiloží svou RFID kartu nebo chytrý náramek ke čtečce. Čtečka přečte identifikátor a odešle jej do aplikace.
3. Obrazovka zobrazí uvítání
   Na displeji se okamžitě zobrazí personalizovaná uvítací zpráva — například „Ahoj, Petře! Vítej na táboře." Současně se automaticky zaznamená příchod do docházky.
4. Dítě pokračuje na tábor
   Po několika sekundách se obrazovka vrátí do výchozího stavu a čeká na dalšího příchozího.

Nastavení kiosku

Pro zprovoznění kiosku potřebujete:

• Tablet nebo dotykový displej — jakékoli zařízení s webovým prohlížečem (Android tablet, iPad, notebook s dotykovou obrazovkou).
• RFID čtečku — připojenou k zařízení nebo k síti (viz sekce RFID čtečky výše).
• Režim kiosku v prohlížeči — nastavte prohlížeč do celoobrazovkového režimu (kiosk mode), aby děti nemohly zavřít aplikaci nebo přejít na jinou stránku. Na Androidu lze použít funkci „Připnutí obrazovky" (Screen pinning) nebo specializovanou aplikaci pro kiosk režim.
• Stabilní internetové připojení — kiosek komunikuje s aplikací v reálném čase.

Bankomat / platební terminál

Modul Bankomat (někdy označovaný jako platební terminál) slouží k dobíjení kreditu na RFID karty nebo chytré náramky přímo na místě. Kredit na kartě může dítě využívat k nákupům v rámci tábora — například na svačiny, nápoje, suvenýry nebo vstupné na speciální aktivity.

Jak dobíjení funguje

1. Vedoucí nebo dítě přistoupí k terminálu
   Terminál je fyzické zařízení (tablet s čtečkou nebo specializovaný terminál) umístěné na přístupném místě v areálu tábora.
2. Přiloží kartu nebo náramek
   RFID čtečka identifikuje dítě a na obrazovce se zobrazí aktuální zůstatek kreditu na kartě.
3. Zadá částku k dobití
   Vedoucí (nebo dítě, pokud je to povoleno) zadá částku, kterou chce na kartu přidat. Částka se přičte k aktuálnímu zůstatku.
4. Potvrdí transakci
   Po potvrzení se kredit okamžitě aktualizuje v systému. Transakce se zaznamená do historie peněženky dítěte, kterou lze zobrazit v sekci RFID karty a peněženka.

Využití kreditu

Kredit na kartě lze využít kdekoli, kde je v rámci tábora k dispozici čtečka s modulem peněženky — v kantýně, na stánku s občerstvením nebo u vedoucích, kteří prodávají drobné předměty. Při každém nákupu se z karty odečte odpovídající částka a transakce se zaznamená.

Outdoor hry

Modul Outdoor hry integruje aplikaci s venkovními herními systémy a sledovacím vybavením pro outdoorové aktivity. Výsledky her se automaticky zaznamenávají do profilů dětí a zobrazují se v žebříčcích (leaderboardech).

Podporované typy aktivit

• Laser game — výsledky jednotlivců i týmů se automaticky přenášejí do aplikace po skončení hry.
• Orientační běh — děti skenují RFID karty na kontrolních stanovištích. Systém zaznamenává časy průchodu a automaticky počítá pořadí.
• Sportovní soutěže — vedoucí zadávají výsledky (body, časy, umístění) přes mobilní rozhraní aplikace. Data se okamžitě promítnou do žebříčků.
• Týmové hry — systém podporuje vytváření týmů, přiřazování dětí do týmů a sledování týmového skóre.

Žebříčky a výsledky

Všechny výsledky se agregují do přehledných žebříčků. Žebříčky lze zobrazit na kiosku, na webové stránce tábora nebo v rodičovském portálu. Děti tak mohou sledovat svůj pokrok a porovnávat se s ostatními. Vedoucí mohou žebříčky využít pro závěrečné vyhlášení výsledků a předání cen.

Záznam výsledků

Výsledky se do systému dostávají dvěma způsoby: automaticky (ze zařízení podporujících přímou integraci, jako jsou RFID stanoviště na orientačním běhu) nebo ručně (vedoucí zadají výsledky přes formulář v aplikaci). Oba způsoby vedou ke stejnému výsledku — záznam v profilu dítěte a aktualizace žebříčku.

Požadavky na hardware

Bez ohledu na to, které moduly používáte, existují obecné požadavky, které musí být splněny pro spolehlivý provoz hardwarového příslušenství.