Správa systému

Stránka /admin slouží ke správě systému organizací a jejich uživatelů. Je primárně určena pro interní správce systému, kteří potřebují přehled napříč všemi organizacemi a nástroje pro řešení zákaznických incidentů — blokování účtů, změnu kontextu organizace, audit systémových událostí. > ⚠️ Přístup k modulu vyžaduje členství ve skupině interních administrátorů. Běžní uživatelé sem přístup nemají a všechny pokusy o otevření stránky jsou zamítnuty. ## Záložky - Organizace — přehled všech organizací v systému s filtrováním a fulltextovým vyhledáváním - Hledání uživatele — vyhledávání uživatele podle přihlašovacího jména (e-mailu) a zobrazení všech organizací, do kterých patří ## Přehled organizací Tabulka zobrazuje seznam všech organizací v systému, seřazených dle interní logiky (zpravidla dle data vytvoření nebo aktivity). Sloupce tabulky: - Emoji — ikona organizace (buďto ručně vybraná, nebo automaticky generovaná pomocí AI) - Název — klikatelný odkaz otevírající detail organizace - Slug — technický URL-friendly identifikátor organizace, používaný v adresách a systémových příkazech - Počet členů — počet aktivních (neblokovaných) členů - Popis — volný text, pokud je vyplněn Hledání: - Nad tabulkou se nachází fulltextové pole, které prohledává současně v názvu a slugu organizace. - Výsledky jsou stránkované a stránkování zachovává aktuální filtr. > 💡 Pokud potřebujete najít organizaci podle konkrétního uživatele, použijte záložku Hledání uživatele — zobrazí všechny organizace, kde má daný uživatel členství. ## Detail organizace Kliknutím na název v přehledu se otevře detailní okno organizace, rozdělené do záložek: ### Členové Tabulka zobrazuje všechny členy dané organizace, včetně blokovaných. Sloupce tabulky: - Jméno — celé jméno uživatele - Uživatelské jméno — přihlašovací e-mail - E-mail — kontaktní e-mailová adresa (může se lišit od přihlašovacího e-mailu) - Blokování — barevný indikátor (ano / ne) - Datum přidání — datum, kdy uživatel získal členství v organizaci Hledání: nad tabulkou se nachází fulltextové pole, které prohledává ve jménu, přihlašovacím jménu a osobním čísle. Akce: - Přidat člena — tlačítko v pravém horním rohu otevírá formulář pro přidání existujícího uživatele (dle e-mailu) do dané organizace. Pokud uživatel ještě není členem, je vytvořeno nové členství a zaslán uvítací e-mail. Pokud již členem je, operace pouze vrátí stávající členství. - Blokovat člena — dlouhým kliknutím (stiskem a podržením) na řádku člena se otevře dialog blokování. Po potvrzení jsou zablokovány všechny API klíče blokovaného člena a je mu zaslán notifikační e-mail. Posledního aktivního člena organizace nelze zablokovat. > ⚠️ Blokování je vratná operace — administrátor ji v budoucnu může vzít zpět. Kromě toho, že se uživatel nebude moci přihlásit, mu však budou zneplatněny i jeho API klíče, které je pak potřeba znovu vygenerovat. ### Systémové logy Tabulka zobrazuje chronologický seznam systémových událostí pro danou organizaci, seřazených od nejnovějších. Stránkuje po 50 záznamech. Sloupce tabulky: - Úroveň — závažnost události (error, warning, info, debug). Závažnější úrovně jsou zvýrazněny barevně. - Zpráva — text události (může obsahovat identifikátory entit nebo chybové zprávy) - Datum — časové razítko vzniku záznamu > 💡 Systémové logy jsou klíčovým nástrojem pro diagnostiku zákaznických incidentů. Při řešení ticketu je vhodné nejprve zkontrolovat logy dané organizace na chyby v relevantním časovém rámci. ## Kontextové menu Kontextové menu se systémovými akcemi je k dispozici pro každou organizaci v přehledu i v detailu. ### Přepnout do organizace (Switch To) Tato akce přepne aktuální relaci administrátora do kontextu vybrané organizace. Vytvoří se nová identita a nastaví se ověřovací cookie, takže po přepnutí se chováte, jako byste byli přímo přihlášeni do organizace. > ⚠️ Přepnutí je silný nástroj pro zákaznickou podporu — v cílové organizaci vidíte a ovládáte data, jako byste byli běžným členem. Respektujte GDPR a interní zásady; přepínejte pouze v nezbytných případech pro řešení incidentu a neprovádějte žádné změny v cizí organizaci bez souhlasu majitele. ### Změnit Slug Modifikace technického URL identifikátoru organizace. Slug musí být unikátní napříč systémem a nesmí kolidovat s existujícími veřejnými cestami (např. /new, /admin). > ⚠️ Změna slugu naruší všechny starší odkazy na organizaci. Přestanou fungovat veřejné URL, odkazy pro odhlášení z newsletterů i cesty k feedům. Používejte jen v krajních případech a s vědomím dopadů. ## Hledání uživatele Tato záložka umožňuje najít uživatele podle přihlašovacího jména (e-mailu) a zobrazit všechny organizace, do kterých patří. Zobrazený seznam obsahuje: - Název organizace a Slug - Blokování — zda je dané členství blokováno - Datum vstupu — kdy se uživatel stal členem Hlavním účelem je podpora zákaznických případů, kdy se stejný uživatel obrací na podporu z různých organizací a je potřeba rychle zjistit, kde všude působí a jaký je stav jeho členství.