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_ENABLED a 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: …“ (podle APP_NAME instance).
  • 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ý.