# První kroky v aplikaci

Tento průvodce pokrývá aktuální přihlášení, základní orientaci, onboarding nové školy a bezpečné první nastavení účtu.

## První přihlášení

### 1. Otevřete aplikaci

Použijte adresu nasazenou vaší školou nebo správcem systému.

### 2. Vyplňte přihlašovací údaje

Na přihlašovací stránce typicky zadáváte:

- uživatelské jméno,
- heslo,
- typ školy,
- konkrétní školu.

Poznámka:

- `superadmin` může mít odlišný login flow bez výběru školy,
- běžní uživatelé se mají přihlašovat v kontextu své školy.

### 3. Po prvním přihlášení změňte heslo

Doporučený postup:

1. vlevo nahoře otevřete **⚙️ NASTAV.**,
2. dole v okně vyplňte **Změna hesla** (současné + dvakrát nové, min. 8 znaků),
3. klikněte **Změnit heslo** (ne Uložit u vzhledu),
4. přihlaste se znovu novým heslem.

## Onboarding wizard (nové školy)

Pokud škola ještě nemá žádné výkony, na domovské stránce se zobrazí **průvodce prvními kroky** se 4 úkoly:

| Krok | Úkol | Kdo ho řeší |
|------|------|-------------|
| 01 | Nastavit školu (název, kód) | Admin / superadmin ve **Správě systému** |
| 02 | Importovat žáky (CSV/XLSX) | Admin; lze vložit i **ukázková (demo) data** |
| 03 | Zadat první výkony | Učitel přes **Třídy** |
| 04 | Zobrazit žebříčky | Po zadání výkonů odkaz na **Žebříčky** |

Průvodce ukazuje průběh `X/4 dokončeno` a vede vás k prvnímu nedokončenému kroku. Po zadání výkonů zmizí automaticky.

> Demo data lze později smazat — při vkládání systém zobrazí potvrzovací dialog.

## Jak poznat, že jste ve správném kontextu

Po přihlášení si zkontrolujte:

- název školy v horní části rozhraní (badge školy u školního roku),
- svou roli (u odhlašovacího tlačítka: UČITEL, ADMIN, ŽÁK…),
- aktivní školní rok (select **Školní rok**),
- že vidíte očekávané třídy, žáky a moduly.

Pokud ne, nejde obvykle o chybu prohlížeče, ale o špatný účet, školu nebo oprávnění.

## Hlavní navigace

Většina uživatelů pracuje hlavně s těmito oblastmi:

| Položka menu | Účel |
|--------------|------|
| Domů (logo) | Dashboard, onboarding, přehled |
| Vyhledat… | Globální vyhledávání (omnisearch) |
| Třídy / Žáci / Disciplíny | Evidence a výkony |
| Žebříčky | Statistiky a klasické žebříčky |
| **Quest Arena** | Výzvy, soutěže, odznaky |
| Odkazy | Metodiky, soubory, aktuality |
| Panel učitele | Skupiny, poznámky, příprava (učitelé) |
| Admin / Systém | Správa školy (dle role) |

Podle role navíc můžete vidět:

- panel učitele (`/ucitel`),
- admin sekci,
- správu systému (superadmin).

Podrobný rozcestník Domů (centrála, horní lišta podle role, karty Aktualit): [Domovská stránka](12-domovska-stranka.md).

## Globální vyhledávání

V horní liště je pole **Vyhledat…** (omnisearch). Po zadání alespoň 2 znaků se zobrazí návrhy:

- žáci, třídy, disciplíny a další entity,
- Enter nebo klik přejde na výsledek,
- šipky nahoru/dolů procházejí návrhy.

Úplné vyhledávání je také na stránce **Globální vyhledávání** (`/globalni-vyhledani`).

## Uživatelská nastavení (⚙️ NASTAV.)

Vlevo u loga je odkaz **⚙️ NASTAV.**, který otevře modal **Nastavení aplikace**. Nastavení je **osobní** — ovlivní jen váš účet, ne oprávnění ani data ostatních.

| Nastavení | Co dělá |
|-----------|---------|
| Výchozí stránka po přihlášení | Domů, Učitel, Admin, Můj profil žáka… |
| Preferovaný školní rok | Poslední zvolený nebo vždy aktuální |
| Výchozí sekce žebříčků | Kam vás žebříčky otevřou po vstupu |
| Hustota tabulek | Pohodlná / kompaktní |
| Kompaktnější karty a panely | Menší mezery v UI |
| Omezit animace a pohyb | Pro citlivost na pohyb nebo slabší zařízení |
| Pamatovat si poslední filtry | Obnoví filtry při návratu na stránku |
| Potvrzovat citlivé akce | Např. odhlášení |

Tlačítko **Výchozí hodnoty** obnoví tovární nastavení.

## Novinky a news feed

Aplikace sleduje nový obsah v modulech (Quest Arena, Admin, Třídy, Odkazy…). U položek menu s neprečteným obsahem se může zobrazit badge. Po kliknutí na modul se obsah označí jako přečtený.

Na domovské stránce je blok **Nový obsah** s odkazy na **Odkazy a informace**. Modal **Novinky** (`newsFeedModal`) zobrazuje souhrn změn — načítá se automaticky z API `/api/news-feed`.

> Klasický notifikační zvonek v navbaru aplikace aktuálně nepoužívá — místo toho slouží news feed a badge u modulů.

## Doporučený první checklist

1. Ověřte, že jste ve správné škole.
2. Ověřte aktivní školní rok.
3. Změňte heslo.
4. Nastavte si **⚙️ NASTAV.** podle preference (volitelné).
5. Otevřete jednu známou třídu nebo jednoho známého žáka.
6. Zkontrolujte, že vidíte očekávané menu podle role.
7. Pokud jste nová škola, projděte **onboarding wizard** na domovské stránce.

## Co dělat, když něco nesedí

### Nevidím správnou školu nebo třídy

- odhlaste se a přihlaste znovu,
- zkontrolujte, že jste vybrali správnou školu,
- pokud problém trvá, kontaktujte admina školy.

### Nepamatuji si heslo

V aplikaci aktuálně není self-service tlačítko pro reset hesla. Obraťte se na školního administrátora nebo superadmina.

### Po přihlášení vidím málo položek v menu

To bývá správně: menu je role-based. Ověřte svou roli v [roles.md](roles.md).

### Nevidím onboarding wizard

Průvodce se zobrazí jen školám bez výkonů. Jakmile zadáte první výkon, zmizí.

## Kam pokračovat dál

- učitel: [teacher-guide.md](teacher-guide.md)
- admin školy: [06-admin-funkce.md](06-admin-funkce.md)
- Quest Arena: [08-vyzvy-souteze-odznaky.md](08-vyzvy-souteze-odznaky.md)
- řešení problémů: [troubleshooting.md](troubleshooting.md)