Správcovská konzole (Admin Console)
Uživatelé s administrátorskou rolí najdou v postranním panelu sekci Administrace (adresa /dashboard/admin).
1. Jak funguje administrátorská role
- První registrace: Úplně první uživatel, který se zaregistruje v čerstvě nainstalované databázi, je automaticky povýšen na hlavního administrátora.
- Uzamčení brány: Automatické povýšení proběhne jen jednou – poté se trvale uzamkne. Další administrátory lze jmenovat pouze z příkazové řádky (CLI/RPC) nebo z administrace, a roli může měnit jen stávající administrátor.
2. Povýšení a odebrání role administrátora (CLI / RPC)
V produkčním Docker kontejneru:
# Povýšení uživatele na Administrátora
docker compose exec app bin/tymeslot rpc 'Tymeslot.Release.promote_admin("uzivatel@vasedomena.cz")'
# Odebrání administrátorských práv
docker compose exec app bin/tymeslot rpc 'Tymeslot.Release.demote_admin("uzivatel@vasedomena.cz")'
Při spuštění z lokálního vývojového prostředí:
mix tymeslot.promote_admin uzivatel@vasedomena.cz
mix tymeslot.demote_admin uzivatel@vasedomena.cz
3. Funkce administrace
Nastavení aplikace
Nastavení je rozdělené do záložek:
- Obecné: Povolení registrace, maximální velikost obrázků a videí na pozadí, platby za schůzky, příjemce upozornění pro administrátory a informační banner (zpráva v horní části aplikace, přihlašovacích nebo rezervačních stránek, s překlady a vlastní barvou).
- Obecné – Přílohy k rezervacím: Nastavení příloh, které může rezervující přiložit na rezervační stránce u typů schůzek, kde je hostitel zapnul:
- Povolené typy souborů: csv, docx, jpeg, jpg, md, ods, odt, pdf, png, pptx, svg, txt, webp, xlsx, zip (SVG je ve výchozím stavu vypnuté). Když zrušíte výběr všech typů, přílohy se vypnou pro celou instalaci.
- Max. velikost souboru: výchozí 10 MB, nejvýše 100 MB.
- Max. počet souborů na rezervaci: výchozí 3, nejvýše 10.
- Obsah každého souboru se kontroluje podle jeho typu, takže přejmenovaný soubor neprojde. Soubory se neskenují antivirem.
- Ověření: Ověření heslem a přihlašování přes Google, GitHub, Microsoft a obecné OIDC; ochrana před boty zvlášť pro registraci a pro rezervace (vypnuto / Google reCAPTCHA v3 / Cloudflare Turnstile).
- E-mail: Branding e-mailů – logo, název značky a barva.
- Lokalizace: Záložní jazyk dashboardu a rezervační stránky, na výběr ze všech podporovaných jazyků (angličtina, čeština, němčina, francouzština, italština, ukrajinština, polština a brazilská portugalština).
- Auditní log: Doba uchování událostí (výchozí 90 dní) a sledované kategorie.
- V cloudu LockMyCal navíc Tarify – limity propojených kalendářů pro jednotlivé tarify.
Sledování chyb
LockMyCal ukládá neočekávané chyby, pády procesů a neúspěšné úlohy na pozadí do databáze aplikace – nic se neposílá třetím stranám. Funkce je ve výchozím stavu zapnutá a vypíná se proměnnou ERROR_TRACKING_ENABLED (Proměnné prostředí).
- Co se ukládá: typ, zpráva a stopa chyby a kontext, ve kterém nastala (uživatel, požadavek, akce v rozhraní nebo úloha na pozadí). Přihlašovací údaje, tokeny, cookies a e-mailové adresy se před uložením maskují a odkazy pro zrušení a přesun schůzky se v uložených cestách zakrývají.
- Jak dlouho: chyba, která se 30 dní neopakuje, se označí jako vyřešená a dalších 30 dní poté se smaže i s výskyty. U chyby, která se opakuje, se uchovává nejnovějších 50 výskytů starších než 30 dní a nejvýše 1000 v rámci 30 dní; jedné chyby se uloží nejvýše 10 výskytů za minutu.
- Upozornění e-mailem: je-li zapnuté
ADMIN_ALERTS_ENABLEDa nastavenéADMIN_ALERT_EMAIL, dostane správce e-mail o nové nebo se vracející chybě. Nové chyby, které přijdou v krátké době po sobě, se spojí do jedné zprávy za hodinu, informační upozornění chodí v denním souhrnu v 07:00 UTC. Předmět má tvar „[ZÁVAŽNOST] LockMyCal: …“ (podleAPP_NAMEinstance). - Po vypnutí se chyby dál logují, ale už se neukládají ani nehlásí; co bylo uloženo dřív, se smaže podle výše uvedených lhůt.
Uživatelé
Seznam všech registrovaných uživatelů s vyhledáváním a stránkováním (20 / 50 / 100 řádků), zemí podle Stripe účtu a akcemi:
- Povýšit / odebrat roli administrátora.
- Zakázat / povolit účet: Zakázaný uživatel je okamžitě odhlášen ze všech relací a nepřihlásí se ani přes Google, GitHub či OIDC.
- Smazat účet i se všemi daty.
Auditní log
Záznamy o přihlášeních, relacích, zablokováních účtů, změnách hesla, smazání účtů, akcích administrátorů a platbách. Lze je filtrovat podle typu nebo celé kategorie, uživatele a data; výpis je stránkovaný.