📖
Návod k Datwrk UCP
Přehled všech akcí dostupných v administračním panelu. UCP pracuje přímo se Supabase přes Service Role Key — veškeré změny jsou okamžitě aktivní v mobilní aplikaci.
🔑 Přihlášení do UCP
UCP se připojuje přímo k Supabase databázi přes Service Role Key, který obchází Row Level Security a vidí data všech organizací.
- Key se uloží do
localStorage v prohlížeči — klíč nikam jinam neodesílá.
- Pro odhlášení (smazání klíče) použij tlačítko Odhlásit v pravém horním rohu nebo v sekci Nastavení.
- Nikdy nesdílej Service Role Key — dává plný přístup ke všem datům.
🏠 Dashboard
Úvodní přehled celého systému. Data se načítají při startu, pro obnovení použij tlačítko ↺ Obnovit vpravo nahoře.
Statistické karty
Zobrazují celkové počty organizací, členů, záznamů, vozidel, tankování a myčkových kódů přes všechny organizace (nebo filtrovanou org).
Poslední záznamy
10 nejnovějších půjčovních případů. Kliknutím na řádek se otevře detail záznamu.
Noví členové
10 naposledy registrovaných uživatelů s přiřazenou organizací a rolí.
Grafy
Záznamy po měsících (posledních 12) a záznamy per organizace.
🏢 Organizace
Správa všech organizací v systému. Každá organizace je izolovaná — členové vidí jen svá data.
+ Nová organizace
Vytvoří novou organizaci. Povinné: Název a unikátní Kód (max 8 znaků, jen písmena a čísla). Kód zadávají uživatelé při registraci, pokud nemají pozvánku.
Mód appky
🚗 Půjčovna — standardní mód s případy, kalendářem a docházkou. 🚛 LKW — přepravní mód s jiným dashboardem a sadou záložek. Přepnutí je okamžité.
Funkce appky (feature flags)
Klepnutím na štítek funkci zapneš nebo vypneš. Žlutý štítek = aktivní. Každá funkce odpovídá záložce v mobilní aplikaci:
📋 Případy — záložka půjčovních případů
⚙️ Provoz — tankování a myčky
✅ Docházka — příchody, odchody, přesčasy
🗓️ Kalendář — přehled vrácení v kalendáři
📌 Bulletin — nástěnka zpráv
🚿 Myčka — myčkové kódy v Provozu
⛽ Tank — tankování v Provozu
🎁 Benefit — benefitní program
Statistiky v kartě org
Každá karta zobrazuje počet členů, záznamů a vozidel pro danou organizaci spolu se seznamem členů a jejich rolemi.
👥 Členové
Seznam všech uživatelů napříč organizacemi. Hledání funguje přes přezdívku i název organizace.
Změna role
Dropdown v sloupci Akce. Možnosti: Admin (plný přístup v appce, vidí tlačítko UCP), Člen (standardní uživatel), Pozorovatel (jen čtení, nemůže provádět úpravy). Změna se projeví okamžitě.
⊘ Deaktivovat / ✓ Aktivovat
Deaktivace zabrání uživateli přihlásit se do mobilní aplikace (Supabase ban). Deaktivovaný uživatel je zobrazen s průhledností 55 % a červeným odznakem Deaktivován. Opětovnou aktivací se ban okamžitě zruší.
⚠️ Deaktivace neodstraní data uživatele — záznamy, tankování a komentáře zůstanou zachovány.
✉️ Pozvánky
Jednorázové tokeny pro registraci nových uživatelů s předem nastavenou rolí a organizací.
+ Nová pozvánka
Vyber organizaci, roli (Admin / Člen / Pozorovatel) a platnost (1 den / 7 dní / 30 dní / 1 rok). Po kliknutí na Vytvořit se zobrazí 10místný token — zkopíruj ho a pošli uživateli. Token lze použít pouze jednou.
Stavy pozvánky
Aktivní — platná, ještě nebyla použita.
Použita — uživatel se zaregistroval.
Expirována — platnost vypršela bez použití.
💡 Uživatel zadá token při registraci místo kódu organizace. Token je prioritní — přiřadí konkrétní roli bez nutnosti nastavení adminem.
📋 Záznamy
Přehled všech půjčovních případů (loan records) z celé databáze. Zobrazuje max. 200 záznamů, použij vyhledávání pro filtrování.
Vyhledávání
Funguje přes číslo případu, jméno klienta, naši SPZ nebo zákazníkovu SPZ.
Detail záznamu
Kliknutím na řádek se otevře modální okno se všemi daty záznamu — klient, adresy, vozidla, datumy, částka, status vyzvednutí a archivace.
Stavy záznamu
Čeká nevyzvednuto, aktivní.
Vyzvednuto zákazník převzal vozidlo.
Archiv případ uzavřen.
🚗 Flotila
Přehled všech vozidel ve všech organizacích. Data jsou jen pro čtení — úpravy vozidel se provádějí v mobilní aplikaci.
STK upozornění
Datum STK zobrazené červeně = platnost vyprší do 30 dní nebo již vypršela.
Stav vozidla
Čisté / Špinavé — reflektuje stav z čistírny v mobilní aplikaci.
⛽ Tank / Routex
Záznamy o tankování — Autotyp H+S (nafta a AdBlue) a Routex tankovací doklady. Data vkládají uživatelé v mobilní aplikaci.
Autotyp H+S
Interní čerpací stanice. Zaznamenává SPZ, typ paliva (Nafta / AdBlue) a počet litrů.
Routex
Tankovací karta na veřejných čerpacích stanicích. Zaznamenává SPZ, refakturaci (ANO/NE) a volitelně částku.
💡 Statistické karty nahoře (celkové litry, hodnota Routex) se aktualizují podle nastaveného filtru organizace.
🚿 Myčka
Správa kódů pro automatické myčky. Kódy naskenují uživatelé v mobilní aplikaci z účtenek.
Volný
Kód nebyl ještě použit — k dispozici pro přidělení vozidlu.
Použitý
Kód byl přiřazen konkrétní SPZ a označen jako spotřebovaný.
⚠️ Pokud klesne počet volných kódů pod 3, mobilní aplikace zobrazí upozornění. Při 0 volných kódech se zobrazí kritické varování.
📊 Statistiky
Grafické přehledy dat — grafy se generují při každém přechodu na tuto stránku z aktuálně načtených dat.
Členové / Vozidla per org
sloupcové grafy pro rychlé srovnání velikosti organizací.
Status záznamů
koláčový graf: Čeká / Vyzvednuto / Archivováno.
Tankování (litry) per org
celkový objem natankované nafty a AdBlue per organizace.
Myčka — použití per org
počet použitých kódů per organizace.
Pozvánky
koláč: Použité / Expirované / Aktivní pozvánky.
⚙️ Nastavení
Připojení
Zobrazuje Supabase URL a zkrácený Service Role Key aktuálního sezení. Key je uložen v localStorage tohoto prohlížeče.
Odhlásit (smazat klíč)
Smaže Service Role Key z localStorage a přesměruje na přihlašovací obrazovku. Žádná data v databázi se nemažou.
🔍 Filtr organizace
Dropdown v levém dolním rohu postranního panelu. Pokud je vybrána konkrétní organizace, všechny stránky (Členové, Záznamy, Flotila, Tank, Myčka, Statistiky) zobrazují jen data té organizace. Výchozí stav — Všechny — zobrazuje kompletní data.
Datwrk UCP · Teshari Studio © 2026