# Úvod do aplikace Hejbni kostrou!

## Co je Hejbni kostrou?

**Hejbni kostrou!** je webová aplikace pro komplexní evidenci a vyhodnocování sportovních výkonů žáků na základních a středních školách. Aplikace vznikla s cílem nahradit papírovou evidenci a složité ruční přepočty bodů jednoduchou a přehlednou online platformou.

### Proč aplikaci používat?

- **Úspora času** – automatické bodování podle oficiálních tabulek
- **Přehlednost** – vše na jednom místě, dostupné odkudkoliv
- **Motivace žáků** – žebříčky, Quest Arena, osobní rekordy, sledování pokroku
- **Bezpečnost** – zálohy dat, audit log všech akcí
- **Flexibilita** – podpora více škol, různých typů (ZŠ, gymnázium, SŠ, SOU)

## Pro koho je aplikace určena?

### 👨‍🏫 Učitelé tělesné výchovy
Hlavní uživatelé aplikace. Zadávají výkony žáků, sledují pokrok, pracují v panelu učitele, exportují data pro vyhodnocení.

### 🏫 Školní administrátoři
Spravují uživatelské účty, importují žáky, zajišťují zálohy dat, spouští onboarding nové školy.

### 🔧 Superadministrátoři
Spravují více škol v systému, konfigurují disciplíny a bodovací tabulky, vidí agregovaná data Quest Areny.

### 👦 Žáci
Prohlížejí své výsledky, sledují osobní rekordy, postavení v žebříčcích a své výzvy v Quest Areně.

## Hlavní funkce aplikace

### Evidence a správa

- ✅ **Správa žáků** – přidávání, import, přesuny mezi třídami
- ✅ **Správa tříd** – automatický výpočet ročníku podle školního roku
- ✅ **Disciplíny** – Atletika, Gymnastika, Olympijský víceboj, Sportovní hry a další
- ✅ **Výkony** – zadávání z Detailu žáka, třídy, skupiny i disciplíny s automatickým bodováním
- ✅ **Mimoškolní aktivita** – nahrání důkazu a učitelské vyhodnocení

### Statistiky a žebříčky

- 📊 **Osobní rekordy** – sekce v menu **Žebříčky**
- 📊 **Třídní statistiky** – průměry a srovnání tříd
- 📊 **Školní rekordy** – nejlepší výkony napříč školou
- 📊 **Srovnání škol** / meziškolní žebříčky – podle oprávnění
- 📊 **Quest Arena žebříčky** – výzvy, soutěže a odznaky v rámci žebříčků

### Motivace — Quest Arena

- 🎯 **Výzvy** – osobní, třídní i meziškolní motivační cíle
- 🏅 **Soutěže** – ligy, poháry, republikové a krajské režimy
- 🎖️ **Odznaky** – odměny, katalog, archiv splněných odznaků
- 📋 **Výsledkový servis** – bonusové žebříčky, tabule, vyhodnocení

### Orientace a pohodlí

- 🔍 **Globální vyhledávání** – rychlý přístup k žákům, třídám, disciplínám
- 📰 **Novinky (news feed)** – badge u modulů s novým obsahem
- ⚙️ **Osobní nastavení** – výchozí stránka, rok, hustota tabulek
- 🚀 **Onboarding wizard** – průvodce prvními kroky pro nové školy

### Exporty a reporty

- 📄 **PDF výpisy** – osobní karty žáků, třídní přehledy
- 📄 **Excel export** – data pro další zpracování
- 📄 **Tisk žebříčků** – pro nástěnky a vyhodnocení

### Administrace

- 🔐 **Správa uživatelů** – role, oprávnění, hesla
- 💾 **Zálohy** – automatické i ruční, obnova dat
- 📝 **Audit log** – sledování všech akcí v systému
- 🏫 **Multi-škola** – izolace dat mezi školami

## Přehled obrazovky

Po přihlášení uvidíte hlavní panel s navigací:

```
┌──────────────────────────────────────────────────────────────┐
│  🦴 Hejbni kostrou!    [Vyhledat…]              [Odhlásit] │
│  ⚙️ NASTAV.                                                  │
├──────────────────────────────────────────────────────────────┤
│  Školní rok [▼]    🏫 Název školy                            │
│                                                              │
│  📚 Menu:                                                    │
│  • Třídy / Žáci / Disciplíny                                 │
│  • Žebříčky         – statistiky a srovnání                  │
│  • Quest Arena      – výzvy, soutěže, odznaky                │
│  • Odkazy           – metodiky, informace                    │
│                                                              │
│  👤 Pro učitele:                                             │
│  • Učitel           – skupiny, poznámky, pořadník, soubory   │
│                                                              │
│  ⚙️ Pro adminy:                                              │
│  • Admin sekce      – správa školy                           │
│  • Správa systému   – (pouze superadmin)                     │
│                                                              │
└──────────────────────────────────────────────────────────────┘
```

## Podporované typy škol

| Typ | Zkratka | Ročníky | Popis |
|-----|---------|---------|-------|
| Základní škola | ZŠ | 6.–9. | 2. stupeň ZŠ |
| Gymnázium | GYM | 1.–8. | Prima až oktáva (interně 6–13) |
| Střední škola | SŠ | 1.–4. | Střední škola (interně 10–13) |
| Střední odborné | SOU | 1.–3. | Učiliště (interně 10–12) |

## Technické požadavky

- **Prohlížeč**: Chrome, Firefox, Edge, Safari (aktuální verze)
- **Mobilní zařízení**: plná podpora responzivního designu
- **Připojení**: stabilní internetové připojení
- **Doporučené rozlišení**: min. 1024×768 (desktop), 320×568 (mobil)

## Quick start

1. **Přihlaste se** na adresu vaší školy
2. **Zadejte přihlašovací údaje** získané od administrátora
3. **Projděte onboarding wizard** (pokud je škola nová)
4. **Nastavte si ⚙️ NASTAV.** podle preference
5. **Začněte zadávat** výkony žáků

> 💡 **Tip**: Pokračujte na [První kroky](02-prvni-kroky.md) pro detailní návod.

---

*Průběžně udržováno spolu s ostatní user-guide dokumentací.*