Role a oprávnění v Domolink

Domolink rozlišuje tři hlavní uživatelské role s různými úrovněmi přístupu a oprávnění.

Přehled rolí

[SCREENSHOT: Srovnání dashboardů jednotlivých rolí]

---

MASTER_ADMIN - Správce platformy

Kdo to je?

• Technický správce celé platformy Domolink
• Zaměstnanec nebo partner Domolink
• Není běžný uživatel z SVJ nebo BD

Co může dělat?

✅ Správa organizací

• Vytvářet nové organizace (SVJ, BD)
• Editovat údaje všech organizací
• Mazat nebo pozastavovat organizace
• Přiřazovat správce k organizacím

✅ Správa předplatných

• Vytvářet a upravovat předplatné plány
• Přiřazovat organizacím konkrétní předplatné
• Sledovat platby předplatného
• Nastavovat limity (max. počet jednotek, uživatelů)

✅ Systémová správa

• Prohlížet audit logy (kdo co udělal)
• Sledovat systémové statistiky
• Spravovat uživatele napříč všemi organizacemi
• Řešit technické problémy a podporu

✅ Přístup k datům

• Vidí všechny organizace
• Vidí všechny jednotky ve všech organizacích
• Vidí všechny poplatky a platby
• Nemá omezenou viditelnost

Co nemůže dělat?

• ❌ Normálně nevstupuje do běžné správy organizací (nechává to na ORG_ADMIN)
• ❌ Neschvaluje poplatky za jednotlivé organizace (to je práce ORG_ADMIN)

Navigace v menu (MASTER_ADMIN)

• 🏠 Admin panel
• 🏢 Organizace
• 💳 Předplatná
• 📋 Šablony předplatných
• 🔧 Systém
• ⚙️ Nastavení

[SCREENSHOT: Admin panel hlavní stránka]

---

ORG_ADMIN - Správce organizace

Kdo to je?

• Správce SVJ nebo BD - osoba zodpovědná za správu bytového domu
• Správcovská firma - zaměstnanec spravující více objektů
• Předseda SVJ - zvolený zástupce vlastníků
• Účetní - osoba vedoucí účetnictví SVJ/BD

Co může dělat?

✅ Správa organizace

Nastavení organizace:

• Upravovat název, IČO, adresu organizace
• Nastavovat bankovní údaje (IBAN, číslo účtu, variabilní symboly)
• Spravovat uživatele v rámci organizace
• Pozvat další správce organizace (více ORG_ADMIN v jedné organizaci)

Správa jednotek:

• Přidávat nové jednotky (byty, nebytové prostory)
• Editovat údaje jednotek (kód, adresa)
• Přiřazovat vlastníky/správce k jednotkám
• Deaktivovat jednotky (např. při prodeji, rekonstrukci)

[SCREENSHOT: Stránka "Má organizace"]

✅ Evidence skutečných nákladů

• Zadávat měsíční faktury od města/obce za svoz odpadu
• Zapisovat: období, částku, datum úhrady, číslo faktury
• Sledovat, které měsíce mají zadané náklady (X / 12)
• Exportovat přehledy nákladů

[SCREENSHOT: Seznam skutečných nákladů]

✅ Generování a správa poplatků

Vytváření poplatků:

• Generovat měsíční poplatky ze skutečných nákladů
• Systém automaticky vypočítá částku podle počtu osob
• Zkontrolovat a upravit poplatky před schválením

Správa poplatků:

• Prohlížet všechny poplatky (všech jednotek)
• Schvalovat poplatky (změna ze stavu "Koncept" na "Vystaveno")
• Stornovat poplatky (označit jako "Zrušeno")
• Filtrovat poplatky podle období, stavu, jednotky

Stavy poplatků:

• DRAFT (Koncept) - poplatek vytvořen, ale ještě neschválen
• ISSUED (Vystaveno) - schválený poplatek, čeká na úhradu
• PAID (Zaplaceno) - uhrazeno
• OVERDUE (Po splatnosti) - nezaplaceno po datu splatnosti
• CANCELLED (Zrušeno) - stornovaný poplatek

[SCREENSHOT: Seznam poplatků s filtry]

✅ Evidence plateb

Zadávání plateb:

• Ručně zadat platbu z bankovního výpisu
• Zadat: částku, variabilní symbol, datum úhrady, poznámku
• Systém automaticky spáruje platbu s poplatkem podle VS

Správa plateb:

• Prohlížet všechny platby
• Vidět spárované vs. nespárované platby
• Ručně přiřadit nespárovanou platbu k poplatku
• Odpojit chybně spárovanou platbu
• Importovat platby z CSV souboru

[SCREENSHOT: Seznam plateb s možností spárování]

✅ Správa obyvatelstva (occupancy)

Prohlížení dat:

• Vidět aktuální počet osob v každé jednotce
• Sledovat historii nahlášení (kdo, kdy, kolik)
• Vidět, které jednotky mají odhady (nebylo nahlášeno)

Ruční zadání:

• Zadat počet osob za libovolnou jednotku
• Opravit chybně nahlášené údaje
• Doplnit chybějící data za minulé měsíce

[SCREENSHOT: Přehled obyvatelstva všech jednotek]

✅ Roční uzávěrka

Provádění uzávěrky:

• Spustit průvodce roční uzávěrkou
• Systém porovná celkové zálohy vs. skutečné náklady
• Zobrazí přeplatek nebo nedoplatek
• Vygeneruje vyrovnávací poplatky pro jednotky

Po uzávěrce:

• Vidět historii uzávěrek minulých let
• Exportovat výsledky uzávěrky (PDF, CSV)
• Znovu otevřít uzávěrku (pokud je potřeba opravit chybu)

[SCREENSHOT: Průvodce roční uzávěrkou]

✅ Reporty a statistiky

• Dashboard s přehledem klíčových metrik
• Roční report jednotky (pro vlastníka)
• Export dat do CSV/Excel
• Grafické přehledy plateb a nákladů

✅ Nastavení účtu

• Změna osobních údajů (jméno, telefon)
• Změna hesla
• Nastavení notifikací (budoucí funkce)

Co nemůže dělat?

• ❌ Vidět data jiných organizací (pouze své SVJ/BD)
• ❌ Měnit předplatné (to dělá MASTER_ADMIN)
• ❌ Přistupovat k systémové administraci

Přístup k datům

ORG_ADMIN vidí pouze data své organizace:

• ✅ Všechny jednotky v rámci organizace
• ✅ Všechny poplatky všech jednotek
• ✅ Všechny platby v organizaci
• ❌ Nevidí data jiných SVJ nebo BD

Navigace v menu (ORG_ADMIN)

• 🏠 Dashboard
• 🏢 Má organizace
• 🏘️ Jednotky
• 💰 Skutečné náklady
• 📄 Poplatky
• 💳 Platby
• 📊 Roční uzávěrky
• ⚙️ Nastavení

[SCREENSHOT: Sidebar ORG_ADMIN]

---

UNIT_MANAGER - Vlastník/správce jednotky

Kdo to je?

• Vlastník bytu v SVJ
• Člen bytového družstva s přiděleným bytem
• Nájemník s pověřením od vlastníka
• Rodinný příslušník vlastníka (manžel/ka, děti)

Co může dělat?

✅ Prohlížení své jednotky

Informace o jednotce:

• Vidět adresu a kód jednotky
• Vidět aktuální počet nahlášených osob
• Zobrazit historii nahlášení

[SCREENSHOT: Stránka "Moje jednotka"]

✅ Nahlašování počtu osob

Měsíční nahlášení:

• Nahlásit počet osob v domácnosti (1-99)
• Potvrdit předchozí počet (pokud se nezměnil)
• Nahlásit přes magic link z emailu (bez přihlášení)
• Nahlásit po přihlášení v sekci "Moje jednotka"

Historie nahlášení:

• Vidět, kdy a kolik osob bylo nahlášeno
• Kontrolovat, zda je vše správně

[SCREENSHOT: Formulář nahlášení počtu osob]

✅ Zobrazení poplatků

Viditelné poplatky:

• Vidí poplatky ve stavu: ISSUED (Vystaveno), PAID (Zaplaceno), OVERDUE (Po splatnosti)
• Nevidí poplatky ve stavu: DRAFT (Koncept), CANCELLED (Zrušeno)

💡 Proč nevidím koncepty? Správce organizace nejprve vytváří poplatky jako koncepty, kontroluje je a pak je schvaluje. Koncepty se nezobrazují, aby nedošlo ke zmatení.

Co vidí u poplatku:

• Období (měsíc/rok)
• Částka k úhradě
• Variabilní symbol
• Datum splatnosti
• Stav (zaplaceno/nezaplaceno)

[SCREENSHOT: Seznam poplatků pro UNIT_MANAGER]

✅ Historie plateb

• Vidět všechny platby spárované s poplatky své jednotky
• Kontrolovat, že platba byla správně připsána
• Exportovat historii plateb (PDF)

✅ Roční přehled

• Zobrazit roční přehled za svou jednotku
• Vidět celkové náklady za rok
• Vidět výsledek vyúčtování (doplatek/přeplatek)

✅ Nastavení účtu

• Změnit osobní údaje (jméno, telefon)
• Změnit heslo
• Aktualizovat email (s potvrzením)

Co nemůže dělat?

• ❌ Vidět data jiných jednotek
• ❌ Vidět skutečné náklady organizace (faktury od města)
• ❌ Schvalovat nebo rušit poplatky
• ❌ Zadávat platby (to dělá správce organizace)
• ❌ Provádět roční uzávěrku
• ❌ Spravovat organizaci

Přístup k datům

UNIT_MANAGER vidí pouze data své vlastní jednotky:

• ✅ Své poplatky (pouze schválené)
• ✅ Své platby
• ✅ Svá nahlášení obyvatelstva
• ❌ Nevidí data jiných jednotek (ani v rámci téhož domu)
• ❌ Nevidí koncepty poplatků (dokud nejsou schváleny)

Navigace v menu (UNIT_MANAGER)

• 🏠 Moje jednotka
• ⚙️ Nastavení

[SCREENSHOT: Sidebar UNIT_MANAGER (zjednodušené menu)]

---

Přehledová tabulka oprávnění

---

Změna role uživatele

Jak získat roli ORG_ADMIN?

1. MASTER_ADMIN vás přidá jako správce organizace
2. Nebo vás stávající ORG_ADMIN pozve jako dalšího správce (v sekci "Uživatelé")

📧 Poznámka: Jedna organizace může mít více správců (více ORG_ADMIN). Všichni mají stejná oprávnění.

Jak získat roli UNIT_MANAGER?

1. ORG_ADMIN vás přiřadí jako správce konkrétní jednotky
2. Obdržíte pozvánku na email s odkazem na registraci
3. Po dokončení registrace získáte přístup ke své jednotce

Může mít uživatel více rolí?

Ano! Jeden uživatel může být:

• ORG_ADMIN v jedné organizaci a zároveň UNIT_MANAGER v jiné organizaci
• UNIT_MANAGER ve více jednotkách (např. vlastní 2 byty)
• ORG_ADMIN ve více organizacích (správcovská firma)

Přepínání mezi organizacemi:

• Pokud máte přístup k více organizacím, můžete mezi nimi přepínat v horní liště
• Každá organizace má oddělený dashboard a data

[SCREENSHOT: Přepínač organizací v headeru]

---

Bezpečnost a kontrola přístupu

Jak Domolink chrání vaše data?

🔒 Izolace dat mezi organizacemi

• Multi-tenant architektura - každá organizace má zcela oddělená data
• ORG_ADMIN z organizace A nevidí nic z organizace B
• Databázové dotazy jsou automaticky filtrovány podle organizace

🔑 Ochrana heslem

• Silné heslo (min. 8 znaků, 1 velké písmeno, 1 číslo)
• Hesla jsou hashována (bcrypt, 12 rounds) - nikdo nezná vaše původní heslo
• Dvoufaktorová autentizace (připravujeme)

🛡️ Ochrana proti útokům

• Rate limiting - max. 10 pokusů o přihlášení za minutu
• Account lockout - po 5 neúspěšných pokusech se účet zamkne na 15 minut
• HTTPS šifrování - veškerá komunikace je šifrovaná
• CSRF ochrana - ochrana proti podvrhnutým požadavkům

📜 Audit log

• Všechny důležité akce jsou zaznamenávány (kdo, kdy, co)
• Typy záznamů:
  • Přihlášení / odhlášení
  • Změna hesla
  • Vytvoření / úprava poplatku
  • Zadání platby
  • Roční uzávěrka

💡 Tip: Audit log je dostupný pouze pro MASTER_ADMIN a slouží k řešení sporů nebo technické podpoře.

---

Časté dotazy k rolím

Můžu převést UNIT_MANAGER na ORG_ADMIN?

Ano, ale musí to udělat:

• MASTER_ADMIN v admin panelu
• Nebo stávající ORG_ADMIN v sekci "Uživatelé" → "Přidat správce"

Co se stane, když prodám byt?

1. ORG_ADMIN odebere vaše přiřazení ke jednotce
2. Nový vlastník je přiřazen místo vás
3. Váš účet zůstane, ale ztratíte přístup k té konkrétní jednotce
4. Pokud nemáte jinou jednotku, nebudete moci do systému vstoupit

⚠️ Důležité: Data o poplatcích a platbách vaší jednotky zůstávají v systému (patří organizaci, ne vám osobně).

Jak pozvat další správce organizace?

Postup (pro ORG_ADMIN):

1. V menu klikněte na "Má organizace" → "Uživatelé"
2. Klikněte "Pozvat správce"
3. Zadejte email nového správce
4. Zvolte roli: ORG_ADMIN
5. Klikněte "Odeslat pozvánku"
6. Nový správce obdrží email s odkazem na registraci

[SCREENSHOT: Formulář pozvání správce]

Co když vlastník jednotky neumí používat internet?

Řešení:

• ORG_ADMIN může nahlašovat počet osob za vlastníka (ruční zadání v sekci "Obyvatelstvo")
• Vlastník může telefonicky říct správci počet osob a správce to zadá do systému
• Vlastník nemusí mít účet v systému, pokud správce vše zadává sám

---

Další kroky

• Začínáme - První přihlášení a orientace
• Správa organizace - Pro ORG_ADMIN
• Správa jednotek - Jak přidat byty
• FAQ - Časté dotazy

[VIDEO: Role v Domolink - Kompletní přehled - 7 minut]