Elektronické zámky jsou stále častější součástí moderního provozu — od recepcí hotelů přes coworkingové prostory až po krátkodobé pronájmy, kde není realistické předávat klíče fyzicky. Modul /iot-lock spravuje integraci s cloudem TTLock a slouží jako centrální dispečink pro všechny zámky v organizaci. Umožňuje sledovat, zda je zámek dostupný a jak je na tom s baterií, vydávat přístupová hesla vázaná na rezervace, vzdáleně otevírat dveře návštěvníkům a procházet historii všech událostí, které zámek zaznamenal. Tím se fyzický zámek proměňuje v plnohodnotný provozní nástroj napojený na zbytek systému — rezervace, kontakty, notifikace.
Přehled zámků
Hlavní tabulka zobrazuje všechny aktivní zámky patřící aktuální organizaci (smazané záznamy jsou skryty). Pořadí řádků je navrženo tak, aby administrátor na první pohled viděl, čemu má věnovat pozornost — aktivní a online zámky jsou nahoře, offline nebo nedostupné dole. U každého zámku se zobrazuje:
- ID zámku — číselný identifikátor přidělený službou TTLock.
- Alias — uživatelský název, typicky popisný („Hlavní vchod", „Apartmán 3").
- Stav připojení — online nebo offline podle toho, zda je dostupná Wi-Fi brána.
- Dostupnost (uptime) — procentuální spolehlivost brány za posledních 30 dní.
- Nabití baterie — aktuální stav v procentech.
- Administrátor — přiřazená odpovědná osoba, pokud je nastavena.
- Hardware — model zámku a verze firmware, je-li tato informace k dispozici.
Tabulka se automaticky obnovuje každých 5 sekund a přizpůsobuje se velikosti zařízení. Hlavní akce nad tabulkou — Add pro přidání zámku, Refresh pro vyžádání čerstvého stavu z cloudu a Odemknout pro okamžité otevření — jsou k dispozici podle stavu daného řádku a oprávnění uživatele.
ℹ️ Pořadí řádků není alfabetické ani podle data — odráží provozní důležitost, aby offline nebo problémová zařízení byla lépe viditelná dole.
Životní cyklus zámku
Každý zámek prochází několika fázemi, které systém automaticky sleduje od prvního spárování až po trvalý provoz. Samotné párování probíhá ve dvou krocích: nejprve se zámek fyzicky spojí s mobilní aplikací TTLock na telefonu (to je vlastní krok výrobce), následně se v administraci přidá tlačítkem Add zadáním jeho ID. Po registraci si systém sám vyžádá aktuální stav z cloudu a doplní hardwarová metadata — model, firmware, MAC adresu — aby nebylo nutné je zadávat ručně.
V provozní fázi pak systém pravidelně obnovuje stav každého zámku. Při každém refreshi zaznamenává úroveň baterie (historie se archivuje pro trendy), stav připojení k bráně a případné změny firmware či aliasu. Pokud brána vypadne, událost se zapíše do systémového logu a na přiřazeného administrátora odchází e-mail.
💡 ID zámku získáte v mobilní aplikaci TTLock v detailu daného zámku. Bez platných přihlašovacích údajů k TTLock nelze zámek do systému přidat.
⚠️ Pokud úroveň baterie klesne pod 25 %, systém generuje kritickou notifikaci. Baterii je třeba co nejdříve vyměnit — při úplném vybití by mohlo dojít k uzamčení zámku bez možnosti vzdáleného ovládání, a jediným řešením by zůstal fyzický zásah přes Bluetooth z mobilní aplikace.
U delších výpadků se v řádku tabulky zobrazí informace Offline od (začátek aktuálního výpadku) a Naposledy online (poslední úspěšná komunikace). Po obnovení spojení systém automaticky vygeneruje nové záložní heslo a uloží je k záznamu zámku, aby byl vstup pro administrátora vždy zajištěn i po incidentu.
Detail zámku
Kliknutím na řádek se otevře detail rozdělený do čtyř záložek, které tematicky oddělují každodenní operace od historických záznamů a konfigurace.
Záložka Aktivní hesla je provozně nejvytíženější — obsahuje seznam platných přístupových kódů, které lze na zámku použít. U každého hesla je vidět platnost (od – do, případně označení „Trvalé"), volitelný popisek („Rezervace pana Nováka"), vazba na událost v kalendáři, pokud bylo heslo vygenerováno automaticky k rezervaci, a aktuální stav. Nové heslo se přidává modálním formulářem: zadává se vlastní kód nebo se nechá prázdné pole a systém vygeneruje náhodný 8místný kód, doplní se volitelný název a rozsah platnosti. Ponechání prázdného konce platnosti vytvoří trvalé heslo, typické například pro personál.
Záložka Historie odemknutí poskytuje chronologický přehled všech událostí, které zámek zaznamenal — odemknutí aplikací, klávesnicí, otiskem prstu, automatické uzamčení. U každé události je vidět úspěšnost, čas zaznamenaný hardware, čas doručení do cloudu a použité heslo (pokud je dostupné, což platí jen u událostí z klávesnice). Texty typů událostí se překládají do jazyka, který má uživatel právě vybraný.
Záložka Nabití baterie zobrazuje graf a tabulku historických měření úrovně baterie. Slouží především k odhadu, kdy bude třeba baterii vyměnit, a pomáhá odhalit zámky, které se vybíjí rychleji než ostatní — typicky kvůli slabšímu signálu k bráně nebo stárnutí hardware.
Záložka Nastavení pak shromažďuje parametry zámku, které lze upravit: alias, příznak aktivní / neaktivní (neaktivní zámky se neobnovují ani nekontrolují), příznak smazaný (skrytí z hlavního přehledu) a přiřazení administrátora. Administrátor je vždy kontakt z téže organizace a přijímá notifikace o kritických událostech — výpadku brány, kritické baterii, chybě API.
💡 Typy hesel se v praxi dělí podle použití: trvalá pro personál, časově omezená pro rezervace a návštěvy a jednorázová či krátkodobá pro jednotlivé vstupy v řádu hodin až dnů.
⚠️ Heslo odeslané do zámku je po vytvoření okamžitě aktivní na hardware. Smazání probíhá obousměrně — kód zmizí jak v systému, tak na samotném zámku, takže zákazník s již neaktivním heslem nemůže dveře otevřít ani při ztrátě spojení s cloudem.
Vzdálené odemknutí
Akce Odemknout pošle okamžitý povel k otevření dveří přes cloud TTLock. Jde o nejvíce ceněnou funkci modulu — administrátor může z kanceláře otevřít dveře návštěvníkovi, aniž by za ním musel jít. Úspěch operace však závisí na několika podmínkách: zámek musí být aktivní (ne smazaný), musí mít připojenou Wi-Fi bránu a integrace s TTLock musí mít platné přihlašovací údaje.
⚠️ Bez připojené brány nelze zámek ovládat vzdáleně. Samotný zámek komunikuje s cloudem jen prostřednictvím brány (gateway); pokud brána vypadne, zůstává jedinou cestou Bluetooth spojení z mobilní aplikace zákazníka, které je ovšem lokální a nedosažitelné z administrace.
Zabezpečení integrace
Komunikace s cloudem TTLock se opírá o čtyři hodnoty, které se nastavují v konfiguraci modulu: Client ID a Client Secret identifikují aplikaci vůči vývojářskému portálu TTLock, uživatelské jméno a heslo pak konkrétní účet, ke kterému jsou zámky přiřazeny. Při běžné obměně hesla v mobilní aplikaci TTLock stačí v administraci vyplnit pouze nové heslo — ostatní pole zůstanou zachována, což usnadňuje rutinní údržbu.
Na úrovni autorizace platí stejná pravidla jako ve zbytku systému: zámek patří vždy jediné organizaci a každý povel (odemknutí, přidání či smazání hesla) je před odesláním ověřen proti organizaci aktuálního uživatele. Každá akce si navíc uloží identitu iniciátora, takže je kdykoli dohledatelné, kdo zámek otevřel nebo komu vystavil kód. Chybové stavy (neplatné údaje, výpadek API) se zapisují do systémového logu a mohou spustit notifikaci administrátorovi.
ℹ️ Uložené tajné hodnoty (Client Secret a heslo k účtu TTLock) se nikdy nevrací zpět do prohlížeče. Rozhraní pouze zobrazuje indikátor, zda je daná hodnota v systému uložena — skutečný obsah je chráněn a neodhaluje se ani uživateli, který ji zadal.
Notifikace
Přiřazený administrátor dostává e-mailová upozornění v situacích, které vyžadují lidskou reakci: brána přechází do stavu offline, úroveň baterie klesla pod kritickou hranici, opakovaně selhává komunikace s cloudem TTLock, nebo došlo k mimořádné změně stavu zámku (například samovolné přepnutí aliasu). Cílem je zajistit, aby žádný problematický zámek neunikl pozornosti, i když se administrátor aktivně nedívá do přehledu.
💡 Pokud administrátor u zámku není přiřazen, systém pouze zapíše záznam do logu a žádnou e-mailovou notifikaci neodesílá. Pro produkční nasazení proto vždy doporučujeme administrátora přiřadit — jinak o výpadku brány nebo vybité baterii nemusí nikdo vědět včas.