# 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 |
| **Quest Arena** | Výzvy, ligy, poháry, odznaky |
| **Učitel** (panel) | Skupiny, poznámky, pořadník, soubory, č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).

### 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).

### Režim v TV

U žáka s úlevou uvidíte badge **TV úleva** / **Cvičí s úlevou**. Nastavení: detail žáka → Upravit → **Režim v TV: cvičí s úlevou** (+ poznámka, platnost). Viz [03-sprava-zaku.md](03-sprava-zaku.md#režim-v-tv-úleva).

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

- **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,
- 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