# Návod pro učitele

Praktický průvodce pro každodenní práci učitele v aktuálním UI aplikace.

## Typický denní workflow

### Před hodinou

1. Přihlaste se do správné školy.
2. Zkontrolujte aktivní školní rok.
3. Otevřete **Učitel** (panel učitele) nebo třídu/disciplínu, se kterou budete pracovat.
4. Ujistěte se, že vidíte správné žáky.
5. Pokud je na panelu sekce **Čeká na vyhodnocení**, projděte nahrané důkazy mimoškolní aktivity.

### Po hodině

1. Zadejte nebo zkontrolujte výkony.
2. Ověřte, že se propsaly body a disciplíny.
3. Podle potřeby otevřete žebříčky, **Quest Arena** nebo reporty.
4. Zkontrolujte odznaky nebo výsledky výzev ve **Výsledkovém servisu**.

## Kde učitel nejčastěji pracuje

| Oblast | K čemu |
|--------|--------|
| **Žáci** / Detail žáka | Jednotlivé výkony (inline), cíle, mimoškolní aktivita |
| **Třídy** / Detail třídy | Hromadné inline zadávání pro celou třídu, přehled |
| **Disciplíny** / Detail disciplíny | Jedna disciplína + vybraná třída, **BODOVÁNÍ** |
| **Učitel** / Detail skupiny | Hromadné zadávání pro vlastní sestavu žáků |
| **Žebříčky** | Motivace, kontrola dat; u jména **＋** → fronty do soupisky |
| **Quest Arena** | Výzvy, ligy, poháry, odznaky |
| **Učitel** (panel) | Skupiny, pořadník, Režim v TV, soupisky, prezenční listiny, Olympijský víceboj, tabulky a pavouky, Školní atletický čtyřboj, poznámky, soubory, import, čekající důkazy |
| Odkazy a informace | Metodiky, soubory |

Podrobný popis Quest Areny: [08-vyzvy-souteze-odznaky.md](08-vyzvy-souteze-odznaky.md).

## Učitel — panel (`/ucitel`)

Položka menu **Učitel** otevírá váš **soukromý pracovní prostor**. Vidí ho učitelé s vlastním účtem (`editor`). Sdílený účet „Učitel“ má omezené funkce — jen metodiku a prohlížení dat.

### Skupiny

Uložte si často používané kombinace žáků:

- celá třída, chlapci, dívky, vlastní výběr,
- rychlý přístup z panelu bez opakovaného filtrování,
- přejmenování a organizace skupin,
- z detailu skupiny: výkony, přehled známek, export, import výkonů ze šablony.

**Tip:** Vlastní skupinu vytvoříte tlačítkem pro přidání; žáky do skupiny přidáváte z detailu skupiny.

### Pořadník disciplín

Osobní seznam disciplín, které chcete ve skupině řešit příště:

- přidání disciplíny do pořadníku,
- označení jako hotové,
- vrácení nebo odebrání položky,
- změna pořadí (posun nahoru/dolů).

Pořadník vidíte jen vy — ostatní učitelé ne.

### Poznámky

Krátké textové poznámky k hodinám:

- zůstávají jen ve vašem účtu,
- vhodné pro záznam „co jsme dělali" a „co příště",
- přidání a smazání přímo na panelu.

### Soukromé soubory

Vaše materiály (nejsou veřejné):

- nahrání souboru,
- stažení,
- smazání.

### Metodika bodování

Tlačítko otevře modal s bodovacími tabulkami pro všechny disciplíny — užitečné při přípravě hodiny nebo kontrole bodů.

### Čeká na vyhodnocení

Pokud žáci nahráli důkazy **mimoškolní aktivity**, zobrazí se:
- položka v **novinkách** v horní liště (modul Žáci) — např. „Čeká důkaz mimoškolní aktivity“,
- souhrn v sekci **Čeká na vyhodnocení** na panelu učitele.

Vyhodnocení probíhá v modalu u výkonu — viz [09-mimoskolni-aktivita.md](09-mimoskolni-aktivita.md).

### Moje pomůcky (select)

Na panelu **Učitel** pod nadpisem **Moje pomůcky** je select **Vyberte sekci**. Pořadí:

1. **Moje skupiny**
2. **Pořadník disciplín**
3. **Režim v TV**
4. **Soupisky/ přihlášky na soutěže**
5. **Prezenční listiny**
6. **Olympijský víceboj**
7. **Tabulky a pavouky**
8. **Školní atletický čtyřboj**
9. **Poznámky**
10. **Soukromé soubory**
11. **Import výkonů z Excelu** (na konci; stejnou funkci má i tlačítko Import nahoře)

U každé sekce je ikona **ℹ️** s krátkým vysvětlením.

### Režim v TV (na panelu)

V selectu **Moje pomůcky** → **Režim v TV** označíte žáky, kteří cvičí s úlevou. Změna se hned projeví na detailu žáka, třídy, skupiny i disciplíny. Jde o pedagogický signál — bez zdravotní dokumentace. Úpravu lze i z detailu žáka → Upravit. Viz [03-sprava-zaku.md](03-sprava-zaku.md#režim-v-tv-úleva).

### Soupisky / přihlášky na soutěže

V selectu **Moje pomůcky** otevřete **Soupisky/ přihlášky na soutěže**:

1. Vyplňte hlavičku soutěže (název, kolo, kategorie, místo, datum, vedoucí, škola).
2. **Uložit předvyplnění** uloží školu a vedoucího k vašemu účtu (funguje i v jiném prohlížeči).
3. Vyberte až **16 žáků** (stejný výběr jako u vlastní skupiny); ročník narození lze doplnit u vybraných. Po **uložení soupisky** se ročník u stejných žáků předvyplní i příště (zůstává jen na soupiskách, ne v žebříčcích ani na kartě žáka).
4. **Uložit soupisku** / **Stáhnout Excel** podle vzoru AŠSK.

**Fronty ze žebříčků:** na stránce **Žebříčky** klikněte u jména na **＋** (jen u **osobního** učitelského účtu — u sdíleného „Učitel“ ikonu neuvidíte):

1. V modalu zvolte existující frontu nebo vytvořte **novou** (název = např. „Atletika – chlapci / sprint 60 m“).
2. Ve frontě uvidíte náhled žáků; **Na soupisky** otevře panel Učitel.
3. Limity: až **12** pojmenovaných front, ve frontě až **32** žáků.
4. U karty fronty: **Do soupisky** (úspěšně přidaní se z fronty odeberou), **Přejmenovat**, **Vyprázdnit**, **Smazat**; u žáka ve frontě **Odebrat**.

**Historie:** po **Uložit soupisku** nebo **Stáhnout Excel** se záznam uloží k vašemu účtu (max. **50**). Ze selectu nebo karty: **Načíst**, znovu stáhnout, **Smazat**.

Ikona **＋** je napříč sekcemi žebříčků (body, disciplíny, rekordy, bonusy…), kde je u jména zobrazena.

### Prezenční listiny

V selectu **Moje pomůcky** → **Prezenční listiny** sestavíte flexibilní listinu (TV, sportovní den, kroužek, kurz) — **není** to školní docházka:

1. Zvolte žáky stejně jako u soupisek (třída / filtr / fronty ze žebříčků).
2. Nastavte vlastní sloupce (např. přítomnost, poznámka, body).
3. Zapisujte online přímo v tabulce.
4. **Uložit** listinu k vašemu účtu; ze historie ji znovu **Načíst**, přejmenovat nebo smazat.
5. **Excel** stáhne aktuální listinu pro tisk / archiv.

KPI box **Prezenční listiny** nahoře ukáže počet uložených listin a odkaz do sekce.

### Olympijský víceboj

V selectu **Moje pomůcky** → **Olympijský víceboj**:

1. Vyberte třídu nebo konkrétní žáky (stejný výběr jako u soupisky / vlastní skupiny).
2. **Stáhnout Excel (víceboj)** — soubor ve formátu odznaku Olympijského víceboje.
3. Do souboru se vyplní nejlepší výkony z **aktivního školního roku**; sloupce ID, jméno, příjmení a hash kód zůstávají prázdné.
4. Skoky uložené v centimetrech se při exportu přepočítají na metry.

### Tabulky a pavouky

V selectu **Moje pomůcky** → **Tabulky a pavouky** vytvoříte jednorázový turnajový podklad (ne sezónní ligu):

1. Zvolte **Formát**:
   - **Tabulka** — každý s každým, 3–8 týmů (křížová matice + rozpis kol),
   - **Pavouk — 1 porážka** — 8 / 16 / 32 / 64 týmů,
   - **Pavouk — 2 porážky** — 8 / 16 / 32 týmů.
2. Vyplňte **Název** a **Názvy týmů** (prázdné buňky = bez výchozího „Tým N“ v náhledu).
3. U tabulky vytvořte rozpis; u pavouka se strom generuje automaticky. **Nalosovat** náhodně rozmístí vyplněná jména.
4. Zapisujte skóre přímo v matici / boxech — postup a pořadí se dopočítají.
5. **Uložit tabulku / Uložit pavouka** uloží záznam jen k vašemu účtu (neukládá se samo při změně formátu).
6. **Pdf** stáhne tisknutelný A4 landscape podklad.
7. Vpravo / dole **Uložené**: načíst, přejmenovat, smazat, přeuspořádat tažením za **⋮⋮** nebo název (na mobilu scrollujte přes kartu; tah jen za úchyt/název).

KPI box **Tabulky a pavouky** ukáže počet uložených turnajů.

### Školní atletický čtyřboj

V selectu **Moje pomůcky** → **Školní atletický čtyřboj**:

1. **Stáhnout šablonu** — prázdný Excel AŠSK (bez předvyplněných žáků).
2. **Importovat data z vyplněné šablony** — nahrání vyplněného Excelu uloží výkony do aktivního školního roku (párování podle jména a třídy).
3. **Stáhnout výsledky** — vyberte žáky (6.–9. ročník); do kategoriálních listů se doplní nejlepší výkony ze systému. Sloupce body a součty zůstávají Excel vzorce; pořadí na každém listu podle součtu bodů.

Bodování v Hejbni kostrou se nemění — AŠSK vzorce platí jen v Excelu.

### Import výkonů z Excelu

V selectu **Moje pomůcky** (poslední položka) nebo tlačítkem **Import** nahoře: stáhněte šablonu pro skupinu, vyplňte výkony a nahrajte zpět. Bez alespoň jedné skupiny import z panelu nejde otevřít.

### Grafy na panelu

Ikona 📊 u nadpisu zobrazí grafy související s vaším učitelským přehledem (pokud jsou k dispozici data).

## Zadávání výkonů

Výkony se zapisují **inline** do tabulky (1. / 2. pololetí) na jednom ze čtyř míst:

1. **Detail žáka** — jednotlivé opravy a doplnění,
2. **Detail třídy** — celá třída, jedna disciplína,
3. **Detail skupiny** — vlastní sestava z panelu **Učitel**,
4. **Detail disciplíny** — jedna disciplína, vybraná třída.

Uložení probíhá po opuštění pole; tlačítko „Hromadné zadání“ / modal „Přidat výkon“ v UI není. Podrobně: [04-zadavani-vykonu.md](04-zadavani-vykonu.md).

Při zapisování dbejte na správného žáka, disciplínu, školní rok a formát hodnoty. Formát ověřte u **BODOVÁNÍ** nebo v **Odkazy a informace**.

## Práce s třídou a skupinou

Doporučený postup:

1. otevřít **Detail třídy** (nebo **Detail skupiny** na panelu **Učitel**),
2. vybrat disciplínu,
3. zadat výkony do tabulky (případně **IMPORT** z Excelu),
4. po zadání projít **Žebříčky** nebo statistiky nahoře jako kontrolu.

## Quest Arena pro učitele

Typický postup po zadání výkonů:

1. Otevřete **Quest Arena** z menu.
2. Zkontrolujte **Aktivní výzvy** nebo **Aktivní soutěže**.
3. Ve **Výsledkovém servisu** ověřte pořadí a případně vytiskněte tabuli.
4. U odznaků zkontrolujte, zda se po splnění podmínek propsaly odměny.

S oprávněním můžete vyhodnocovat výzvy, zapisovat účastníky a spravovat kampaně.

### Zápis účastníků (rychle)

1. **Quest Arena** → **Aktivní výzvy** (nebo soutěže) → **Zapsat účastníky**.
2. Termín od/do + filtry třídy → přesun žáků do výběru → uložit.
3. Žák se může sám **Zapojit se / Odhlásit se**, pokud to výzva povoluje.

Detail včetně **Měsíční rulety** a režimů vyhodnocení: [08-vyzvy-souteze-odznaky.md](08-vyzvy-souteze-odznaky.md).

### Známky u žákovských účtů

Vy známky na detaily vždy vidíte. Žákovské účty je výchozí **nevidí** (ikona kroků + motivační citát místo rozmezí). Zapnutí pro žáky řeší admin školy: **Admin sekce → Statistiky školy → Povolit žákům zobrazovat známky**.

## Co je nové a důležité v aktuální verzi

- **Soupisky / přihlášky** na panelu Učitel + ikona **＋** u jmen v žebříčcích (pojmenované fronty), předvyplnění ročníku narození z uložených soupisek,
- **Prezenční listiny** — flexibilní listiny s vlastními sloupci, online zápis a Excel,
- **Školní liga** — týmy, soupisky, rozpis, zápis, tabulka; ve zápisu **Handicap** (gól do skóre, ne do kanadského); Word u Propozic; Excel/PDF/import v horní liště; import výsledků,
- **Tabulky a pavouky** — tabulka 3–8 nebo pavouk 1/2 porážky, skóre, uložení a PDF,
- **Olympijský víceboj** — export Excelu (odznak) z panelu Učitel,
- **Školní atletický čtyřboj** — šablona AŠSK, import výkonů a stažení výsledků z panelu Učitel,
- **Režim v TV** přímo v selectu Moje pomůcky (hromadné označení úlevy),
- **Quest Arena** v menu nahrazuje dřívější stručný název „Výzvy",
- **news feed** — badge u modulů s novým obsahem (Quest Arena, Admin, Třídy…),
- **osobní nastavení** v **⚙️ NASTAV.** — výchozí stránka, rok, hustota tabulek,
- **onboarding wizard** na domovské stránce pro nové školy,
- **globální vyhledávání** v horní liště,
- **mimoškolní aktivita** — nahrání důkazu žákem, vyhodnocení učitelem,
- **skrytí známek před žáky** (výchozí) — admin může zapnout zobrazení,
- reporty a diplomy mají JSON i PDF výstupy,
- část rankingových a dashboard dat se načítá lazy přes JSON endpointy.

Tyto prvky nevyžadují technické znalosti, ale vysvětlují, proč se některé bloky po otevření stránky dotahují asynchronně.

## Doporučené návyky

1. Po větším zadávání výkonů ověřte jeden nebo dva konkrétní žáky v detailu.
2. Průběžně kontrolujte **Čeká na vyhodnocení** na panelu učitele.
3. Před veřejným sdílením exportů myslete na anonymizaci.
4. Když něco nevidíte, nejdřív zkontrolujte školu, rok a roli.
5. Pokud pracujete na sdíleném zařízení, vždy se odhlaste.

## Kdy kontaktovat admina školy

- nevidíte správné třídy nebo žáky,
- nemůžete změnit heslo nebo se přihlásit,
- potřebujete vlastní učitelský účet místo sdíleného „Učitel",
- potřebujete vytvořit nebo upravit účet,
- potřebujete řešit import, hromadný export nebo školní nastavení,
- potřebujete oprávnění ke správě Quest Areny (katalog, vyhodnocení).

## Viz také

- [02-prvni-kroky.md](02-prvni-kroky.md) — nastavení, novinky, onboarding
- [04-zadavani-vykonu.md](04-zadavani-vykonu.md) — formáty výkonů
- [08-vyzvy-souteze-odznaky.md](08-vyzvy-souteze-odznaky.md) — Quest Arena
- [09-mimoskolni-aktivita.md](09-mimoskolni-aktivita.md) — důkazy aktivity
- [reports.md](reports.md) — exporty a reporty