Chytré zámky

Elektronické zámky jsou stále častější součástí moderního provozu – od hotelových recepcí a co-workingových prostor až po krátkodobé pronájmy, kde fyzické předávání klíčů není reálné. Modul /iot-lock spravuje integraci s cloudem TTLock a slouží jako centrální dispečink pro všechny zámky v organizaci. Umožňuje monitorovat dostupnost a stav baterie zámků, vydávat přístupová hesla vázaná na rezervace, vzdáleně otevírat dveře návštěvníkům a revidovat historii všech událostí zaznamenaných zámkem. Tím se fyzický zámek mění v plnohodnotný provozní nástroj propojený se zbytkem systému – rezervacemi, kontakty, notifikacemi.

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, co vyžaduje pozornost – aktivní a online zámky jsou nahoře, offline nebo nedostupné dole. Pro každý zámek se zobrazuje:
- Lock ID — číselný identifikátor přidělený službou TTLock.
- Alias — uživatelsky přívětivý název, typicky popisný ("Hlavní vchod", "Apartmán 3").
- Stav připojení — online nebo offline v závislosti na dostupnosti Wi-Fi brány.
- Dostupnost (uptime) — procentuální spolehlivost brány za posledních 30 dní.
- Nabíjení baterie — aktuální stav v procentech.
- Administrátor — přiřazená zodpovědná osoba, pokud je nastavena.
- Hardware — model zámku a verze firmwaru, pokud jsou tyto informace dostupné.
Tabulka se automaticky obnovuje každých 5 sekund a přizpůsobuje se velikosti zařízení. Hlavní akce nad tabulkou – Přidat pro přidání zámku, Obnovit pro vyžádání čerstvého stavu z cloudu a Odemknout pro okamžité otevření – jsou dostupné podle stavu daného řádku a uživatelských oprávnění.

ℹ️ Pořadí řádků není abecední ani podle data – odráží provozní důležitost, aby offline nebo problematická zařízení byla dole viditelnější.

Životní cyklus zámku

Každý zámek prochází několika fázemi, které systém automaticky monitoruje od počátečního párování až po nepřetržitý provoz. Samotné párování probíhá ve dvou krocích: nejprve je zámek fyzicky připojen k mobilní aplikaci TTLock na telefonu (to je krok specifický pro výrobce), poté je přidán v administraci pomocí tlačítka Přidat zadáním jeho ID. Po registraci systém automaticky vyžádá aktuální stav z cloudu a doplní metadata hardwaru – model, firmware, MAC adresu – aby eliminoval potřebu ručního zadávání.
V provozní fázi systém pravidelně aktualizuje stav každého zámku. Při každém obnovení zaznamenává úroveň baterie (historie je archivována pro trendy), stav připojení k bráně a jakékoli změny ve firmwaru nebo aliasu. Pokud se brána odpojí, událost je zaznamenána do systémového logu a e-mail je odeslán přiřazenému administrátorovi.

💡 ID zámku získáte v mobilní aplikaci TTLock v detailu konkrétního zámku. Bez platných přihlašovacích údajů TTLock nelze zámek do systému přidat.

⚠️ Pokud úroveň baterie klesne pod 25 %, systém vygeneruje kritické upozornění. Baterie by měla být co nejdříve vyměněna – úplné vybití by mohlo vést k nedostupnosti zámku pro vzdálené ovládání, přičemž jediné řešení by zůstal fyzický zásah přes Bluetooth z mobilní aplikace.

Pro delší výpadky se v řádku tabulky zobrazí Offline od (začátek aktuálního výpadku) a Poslední online (poslední úspěšná komunikace). Po opětovném připojení systém automaticky vygeneruje nové záložní heslo a uloží ho k záznamu zámku, aby byl vždy zachován přístup administrátora i po incidentu.

Detail zámku

Kliknutím na řádek se otevře detailní zobrazení 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ě nejpoužívanější – obsahuje seznam platných přístupových kódů, které lze použít na zámku. Pro každé heslo je zobrazena jeho platnost (od – do, nebo označeno „Permanentní“), volitelný popis („Rezervace pana Nováka“), odkaz na událost v kalendáři, pokud bylo heslo automaticky vygenerováno pro rezervaci, a aktuální stav. Nové heslo se přidává pomocí modálního formuláře: zadáte vlastní kód nebo necháte pole prázdné, aby systém vygeneroval náhodný 8místný kód, poté doplníte volitelný název a rozsah platnosti. Ponechání konce platnosti prázdné vytvoří permanentní heslo, typické například pro zaměstnance.
Záložka Historie odemknutí poskytuje chronologický přehled všech událostí zaznamenaných zámkem – odemknutí aplikací, klávesnicí, otiskem prstu, automatické uzamčení. Pro každou událost se zobrazuje úspěšnost, čas zaznamenaný hardwarem, čas doručení do cloudu a použité heslo (pokud je dostupné, což platí pouze pro události z klávesnice). Texty typů událostí jsou přeloženy do aktuálně zvoleného jazyka uživatele.
Záložka Nabíjení baterie zobrazuje graf a tabulku historických měření úrovně baterie. Slouží primárně k odhadu, kdy bude potřeba baterii vyměnit, a pomáhá identifikovat zámky, které se vybíjejí rychleji než ostatní – typicky kvůli slabšímu signálu k bráně nebo stárnoucímu hardwaru.
Záložka Nastavení pak shromažďuje parametry zámku, které lze upravit: alias, příznak aktivní/neaktivní (neaktivní zámky se neobnovují ani nemění), příznak smazáno (skrytí z hlavního přehledu) a přiřazení administrátora. Administrátor je vždy kontakt ze stejné organizace a přijímá oznámení o kritických událostech – výpadek brány, kritická baterie, chyba API.

💡 V praxi se typy hesel dělí podle použití: permanentní pro zaměstnance, časově omezené pro rezervace a návštěvy a jednorázové nebo krátkodobé pro jednotlivé vstupy v řádu hodin až dnů.

⚠️ Heslo odeslané do zámku je ihned po vytvoření aktivní na hardwaru. Smazání je obousměrné – kód zmizí jak v systému, tak i na samotném zámku, takže zákazník s již neaktivním heslem nemůže otevřít dveře, i kdyby došlo ke ztrátě spojení s cloudem.

Vzdálené odemykání

Akce Odemknout odešle okamžitý příkaz k otevření dveří přes cloud TTLock. Toto je nejvíce ceněná funkce modulu – administrátor může otevřít dveře návštěvníkovi z kanceláře, aniž by tam musel fyzicky jít. Úspěšnost operace však závisí na několika podmínkách: zámek musí být aktivní (nesmazaný), 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 vzdáleně ovládat. Zámek samotný komunikuje s cloudem pouze přes bránu; pokud se brána odpojí, jedinou cestou zůstává Bluetooth připojení z mobilní aplikace zákazníka, které je lokální a z administrace nedosažitelné.

Bezpečnost integrace

Komunikace s cloudem TTLock se opírá o čtyři hodnoty nakonfigurované v modulu: Client ID a Client Secret identifikují aplikaci pro vývojářský portál TTLock, zatímco username a password identifikují konkrétní účet, ke kterému jsou zámky přiřazeny. Pro rutinní změny hesla v mobilní aplikaci TTLock stačí zadat nové heslo v administraci – ostatní pole zůstávají zachována, což zjednodušuje rutinní údržbu.
Na úrovni autorizace platí stejná pravidla jako ve zbytku systému: zámek vždy patří jediné organizaci a každý příkaz (odemknout, přidat nebo smazat heslo) je před odesláním ověřen proti organizaci aktuálního uživatele. Dále každá akce ukládá identitu iniciátora, takže je vždy dohledatelné, kdo zámek otevřel nebo komu byl kód vydán. Chybové stavy (neplatná data, výpadek API) jsou zaznamenány do systémového logu a mohou spustit notifikaci administrátorovi.

ℹ️ Uložené tajné hodnoty (Client Secret a heslo k účtu TTLock) nejsou nikdy vráceny do prohlížeče. Rozhraní zobrazuje pouze indikátor, zda je hodnota v systému uložena – skutečný obsah je chráněn a není odhalen ani uživateli, který jej zadal.

Notifikace

Přiřazený administrátor dostává e-mailová upozornění v situacích vyžadujících lidský zásah: brána přejde do režimu offline, úroveň baterie klesne pod kritickou hranici, komunikace s cloudem TTLock opakovaně selže nebo dojde k mimořádné změně stavu zámku (např. automatické přepnutí aliasu). Cílem je zajistit, aby žádný problematický zámek nezůstal nepovšimnut, i když administrátor aktivně nesleduje přehled.

💡 Pokud není k zámku přiřazen žádný administrátor, systém pouze zaznamená událost a neodesílá e-mailové oznámení. Pro produkční nasazení proto vždy doporučujeme administrátora přiřadit – jinak by se o výpadku brány nebo vybité baterii nikdo včas nedozvěděl.