# Správa žáků Tento průvodce popisuje prohlížení žáků a jejich správu. **Prohlížení** je v menu **Žáci**; **přidání, úprava, import a mazání** probíhá v **Admin sekce** (správa žáků) podle oprávnění. ## Přehled žáků ### Zobrazení seznamu žáků 1. V hlavním menu klikněte na **Žáci** 2. Zobrazí se **Seznam žáků** rozdělený na dva sloupce: **Chlapci** a **Dívky** (jméno + třída) 3. Filtrujte nahoře podle jména ``` ┌────────────────────────────────────────────────────────────────────────┐ │ Seznam žáků 🔍 Filtrovat žáky podle jména... │ ├─────────────────────────────┬──────────────────────────────────────────┤ │ Chlapci (N) │ Dívky (N) │ │ Horák Jakub — 6.A │ Dvořáková Tereza — 6.A │ │ Novák Petr — 6.A │ Krejčí Marie — 6.B │ │ ... │ ... │ └─────────────────────────────┴──────────────────────────────────────────┘ ``` Kliknutím na jméno otevřete **Detail žáka** (výkony, statistiky, mimoškolní aktivita). > 💡 **Tip:** Rychlejší cesta k žákovi je globální vyhledávání v záhlaví. ### Kde se žáci spravují (CRUD) Na stránce **Žáci** se nepřidávají ani needitují účty — to je v **Admin sekce** → správa žáků (přidání, úprava, import, mazání podle role). ## Přidání nového žáka ### Krok za krokem 1. Otevřete **Admin sekce** → správa žáků 2. Zvolte akci pro přidání žáka a vyplňte formulář: ``` ┌──────────────────────────────────────────────────────────────┐ │ ➕ Přidat nového žáka │ ├──────────────────────────────────────────────────────────────┤ │ │ │ Základní údaje │ │ ─────────────────────────────────────────────────────────── │ │ │ │ Jméno: * │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ Petr │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ Příjmení: * │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ Novák │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ Třída │ │ ─────────────────────────────────────────────────────────── │ │ │ │ Ročník: * Písmeno třídy: * │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ 6 ▼ │ │ A ▼ │ │ │ └──────────────┘ └──────────────┘ │ │ │ │ Rok nástupu (na 2. stupeň): * │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ 2025 │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ Pohlaví: * │ │ ○ Chlapec ○ Dívka │ │ │ │ [ Zrušit ] [ Uložit ] │ │ │ └──────────────────────────────────────────────────────────────┘ ``` 3. Klikněte **Uložit** ### Povinná pole | Pole | Popis | Příklad | |------|-------|---------| | Jméno | Křestní jméno žáka | Petr | | Příjmení | Příjmení žáka | Novák | | Ročník | Číslo ročníku (6–9 pro ZŠ) | 6 | | Písmeno třídy | Označení třídy (A, B, C...) | A | | Rok nástupu | Školní rok nástupu na 2. stupeň | 2025 | | Pohlaví | Pro správné bodování | Chlapec | > ⚠️ **Důležité**: Pohlaví ovlivňuje bodovací tabulky! Zadejte správně. ## Import žáků z Excelu Pro hromadné přidání více žáků využijte import z Excel souboru. ### Požadovaný formát souboru Připravte Excel soubor (.xlsx nebo .xls) s těmito sloupci: | Sloupec | Povinný | Formát | Příklad | |---------|:-------:|--------|---------| | Jméno | ✅ | text | Petr | | Příjmení | ✅ | text | Novák | | Třída | ✅ | text/číslo | 6.A nebo 6A | | Pohlaví | ✅ | text | chlapec/dívka nebo M/Ž | | Rok nástupu | ✅ | číslo | 2025 | ### Vzorový soubor ``` ┌──────────┬──────────┬───────┬─────────┬────────────┐ │ Jméno │ Příjmení │ Třída │ Pohlaví │ Rok nástupu│ ├──────────┼──────────┼───────┼─────────┼────────────┤ │ Petr │ Novák │ 6.A │ chlapec │ 2025 │ │ Marie │ Horská │ 6.A │ dívka │ 2025 │ │ Jakub │ Krejčí │ 6.B │ chlapec │ 2025 │ │ Tereza │ Dvořáková│ 6.B │ dívka │ 2025 │ └──────────┴──────────┴───────┴─────────┴────────────┘ ``` ### Postup importu 1. V menu **Admin sekce** vyberte **Import žáků** 2. Klikněte na **Vybrat soubor** a zvolte připravený Excel 3. Systém zobrazí **náhled** importovaných dat: ``` ┌────────────────────────────────────────────────────────────────┐ │ 📥 Import žáků – Náhled │ ├────────────────────────────────────────────────────────────────┤ │ │ │ ✅ Nalezeno 45 žáků k importu │ │ ⚠️ 2 záznamy s varováním (duplicity) │ │ ❌ 1 záznam s chybou (chybí pohlaví) │ │ │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ ✅ Novák Petr, 6.A – OK │ │ │ │ ✅ Horská Marie, 6.A – OK │ │ │ │ ⚠️ Krejčí Jakub, 6.B – možná duplicita (ID: 123) │ │ │ │ ❌ Dvořáková, 6.B – chybí pohlaví │ │ │ │ ... │ │ │ └──────────────────────────────────────────────────────────┘ │ │ │ │ ☐ Importovat i záznamy s varováním │ │ │ │ [ Zrušit ] [ Importovat 44 žáků ] │ │ │ └────────────────────────────────────────────────────────────────┘ ``` 4. Zkontrolujte náhled a klikněte **Importovat** ### Řešení chyb při importu | Chyba | Příčina | Řešení | |-------|---------|--------| | "Chybí povinný sloupec" | Excel nemá požadovaný sloupec | Doplňte sloupec nebo opravte název | | "Duplicitní žák" | Žák se stejným jménem již existuje | Ověřte, zda se jedná o stejnou osobu | | "Neplatná třída" | Nerozpoznaný formát třídy | Použijte formát "6.A" nebo "6A" | | "Neplatné pohlaví" | Nerozpoznané označení | Použijte: chlapec/dívka/M/Ž | ## Úprava údajů žáka ### Postup úpravy 1. Otevřete **Admin sekce** → správa žáků (nebo upravte žáka z dostupného admin workflow) 2. Vyberte žáka a akci **Upravit** 3. Změňte potřebné údaje a uložte Na stránce **Žáci** jsou jen odkazy na detail — ikony 📝/🗑️ v seznamu nejsou. ### Co lze typicky upravit - ✅ Jméno a příjmení (oprava překlepů) - ✅ Třída / ročník (přesun) - ⚠️ Pohlaví (změna ovlivní bodování!) - ✅ **Režim v TV** (cvičí / cvičí s úlevou) — viz níže ## Přesun žáka do jiné třídy ### Přesun jednotlivce 1. V **Admin sekce** otevřete úpravu žáka 2. Změňte **Ročník** a/nebo **Písmeno třídy** 3. Uložte změny > 💡 **Poznámka:** Historie výkonů zůstává u žáka; bodování se řídí ročníkem a pohlavím v době výkonu. ### Hromadný posun ročníku (nový školní rok) Posun žáků do dalšího ročníku zajišťuje administrátor: 1. **Admin sekce** → akce pro posun ročníku / přechod školního roku (podle aktuálního UI) 2. Systém typicky: - povýší žáky o jeden ročník, - označí vycházející ročník jako absolventy ``` ┌────────────────────────────────────────────────────────────────┐ │ 🗓️ Přechod na nový školní rok 2026/2027 │ ├────────────────────────────────────────────────────────────────┤ │ │ │ Aktuální rok: 2025/2026 │ │ Nový rok: 2026/2027 │ │ │ │ Změny: │ │ ─────────────────────────────────────────────────────────────│ │ • 6. ročník → 7. ročník (62 žáků) │ │ • 7. ročník → 8. ročník (58 žáků) │ │ • 8. ročník → 9. ročník (55 žáků) │ │ • 9. ročník → Absolventi (51 žák) │ │ │ │ ⚠️ Tato akce je nevratná! │ │ │ │ [ Zrušit ] [ Provést přechod ] │ │ │ └────────────────────────────────────────────────────────────────┘ ``` ## Mazání a absolventi Samostatné tlačítko **Archivovat** na Detailu žáka v běžném UI není. Žáci vycházejícího ročníku se při **posunu ročníku** stávají absolventy a mizí z běžného seznamu aktivních žáků. ### Mazání žáka Mazání je admin akce (**Admin sekce** → správa žáků) a má být výjimečné — obvykle stačí posun / absolventský stav. | Akce | Popis | Poznámka | |------|-------|----------| | **Posun ročníku / absolvent** | Žák opustí aktivní seznam | Preferovaný postup na konci roku | | **Smazání** | Trvalé odstranění (admin) | Jen při chybě / duplicitě; pozor na vazby na výkony | Absolventi / neaktivní žáci: - Neobjevují se v běžném seznamu **Žáci** - Správu absolventů a obnovu řeší administrátor podle dostupných admin nástrojů ### Smazání žáka > ⚠️ **POZOR:** Smazání je admin akce a má být výjimečné. 1. **Admin sekce** → správa žáků 2. Vyberte mazání žáka a potvrďte podle UI Checkboxové „Hromadné akce“ na stránce **Žáci** nejsou. ## Propojení žáka s účtem Žákům lze vytvořit vlastní přihlašovací účet pro prohlížení výsledků. ### Vytvoření / generování účtů Účty se spravují v **Admin sekce** (generování přihlašovacích údajů pro třídu / žáky, tisk nebo export údajů). Postup a názvy tlačítek se řídí aktuálním admin UI — ne tlačítkem „Vytvořit účet“ přímo na seznamu **Žáci**. ## Tipy a doporučení ### Doporučený postup na začátku roku 1. ✅ Importujte nové žáky z Excelu (**Admin sekce**) 2. ✅ Zkontrolujte data (jména, třídy, pohlaví) 3. ✅ Proveďte posun ročníku / přechod školního roku 4. ✅ Ověřte absolventy 5. ✅ Podle potřeby vygenerujte žákovské účty ## Režim v TV (úleva) Aplikace eviduje **pedagogický signál**, ne zdravotní dokumentaci. Účel: učitel vidí, že žák cvičí s úlevou / má dočasné omezení při zadávání a v seznamech. ### Kde se nastavuje 1. Otevřete úpravu žáka (typicky **Admin sekce** / editační modal žáka). 2. Zaškrtněte **Režim v TV: cvičí s úlevou**. 3. Volitelně vyplňte **Poznámka pro učitele** (např. „bez doskoků“ — bez diagnóz). 4. Volitelně **Platí od / Platí do**. 5. Uložte. ### Kde se zobrazuje | Místo | Jak | |-------|-----| | Detail žáka | Řádek **Režim v TV** (pro učitele/admin): **Bez omezení** (zeleně) / **S omezením** (červeně); klik otevře detail (stav, poznámka, platnost). | | Seznamy / skupiny | Badge u žáka (podle místa v UI) | | **Učitel** | Badge u žáka ve skupinách | Nezadávejte diagnózy ani citlivé zdravotní údaje — jen krátkou provozní poznámku pro TV. Role bez oprávnění úlevu nevidí / neupraví. ### Časté chyby | Chyba | Důsledek | Prevence | |-------|----------|----------| | Špatné pohlaví | Chybné bodování | Kontrola při importu | | Duplicitní žák | Rozptýlené výkony | Hledání před přidáním | | Chybný rok nástupu | Špatný výpočet ročníku | Ověření u třídního | --- ## Import z CSV Kromě Excelu lze žáky importovat i z **CSV souboru**: ### Formát CSV šablony ```csv příjmení;jméno;třída;pohlaví Novák;Jan;3.A;M Svobodová;Eva;3.A;F ``` - **Oddělovač:** středník (`;`) - **Kódování:** UTF-8 (s BOM pro kompatibilitu s Excelem) - **Pohlaví:** `M` = chlapec, `F` = dívka ### Řešení problémů s CSV importem | Problém | Příčina | Řešení | |---------|---------|--------| | Chybná diakritika | Špatné kódování | Uložte soubor jako UTF-8 | | Duplicitní žáci | Opakovaný import | Systém nabídne přeskočit/aktualizovat | | Import selhává | Špatný oddělovač | Použijte středník, ne čárku | --- ## Řazení a filtrování - **Řazení:** Klikněte na záhlaví sloupce (jméno, třída, ročník) - **Stránkování:** Při velkém počtu žáků se seznam automaticky stránkuje - **Kombinace filtrů:** Můžete kombinovat vyhledávání jménem + filtr třídy --- *Průběžně udržováno; při nejasnostech ověřujte workflow proti aktuálnímu UI.*