# Tanársegéd (tanarseged.hu)

> Magyar fejlesztésű, mesterséges intelligenciával támogatott szakmai felkészülési és feladatkezelő platform általános és középiskolai pedagógusoknak: NAT 2020 tanmenet hivatalos KRÉTA-importra kész XLSX exporttal, kivetíthető interaktív óravázlat (Óravászon), differenciált dolgozat- és feladatlap-készítő javítókulccsal (Próbakő), valós idejű kirándulás-kísérő és jelenléti felügyelet (Lépéselőny), köznevelési jogi döntéstámogató és hivatalos válaszlevél-generátor (KatedraPajzs), valamint órarendtervező (ÓraMátrix).

## Áttekintés

A **Tanársegéd** (https://tanarseged.hu) a magyar köznevelésben tanító pedagógusoknak készült célalkalmazás (böngészőben futó, telepíthető PWA). Célja az órafelkészülés, a tanmenet-adminisztráció, a tanórai differenciálás, az iskolai kirándulások biztonsági koordinációja és a munkajogi védelem támogatása. A tartalmat mesterséges intelligencia (Google Gemini motor) készíti elő, a szakmai felülvizsgálat és a döntés mindig a tanáré.

- **Üzemeltető**: Klára Botond E. V.
- **Nyelv**: magyar
- **Költségmodell**: ingyenes regisztráció, induláskor 100 ajándék Szikra kredit (bankkártyaadatok megadása nélkül); a prémium MI-funkciók Szikrával működnek.
- **Tantervi bázis**: Nemzeti alaptanterv (NAT 2020), Oktatási Hivatal kerettantervek.

---

## Élesben elérhető modulok

### 1. Tervezés — éves tanmenet és KRÉTA-kapcsolat
- Tantárgy, évfolyam, heti óraszám és tanév-időszak alapján órákra bontott éves tanmenet generálása (téma, tanulási célok, módszerek, eszközök, értékelés, házi feladat).
- **Hivatalos KRÉTA-export**: letölthető XLSX fájl a KRÉTA „Tanmenet, tervezett tananyag" import-sablonja szerint (2 oszlop: óraszám és az óra témája, a szünetek kihagyásával és folyamatos sorszámozással); a teljes tanmenet PDF formátumban is letölthető.
- A tanmenet leckéiből közvetlenül egyetlen kattintással indítható Óravászon, feladatlap, röpdolgozat vagy témazáró.

### 2. Óravászon — kivetíthető, interaktív óravázlat
- Projektoron vagy interaktív táblán lépésről lépésre vetíthető digitális tanórai vázlat: ráhangolás, elméleti magyarázat és vezérpélda, feladatok külön megoldás-diával, házi feladat.
- **Vetítő mód**: teljes képernyős, billentyűzettel léptethető diavetítés beépített visszaszámláló időzítővel; a tanári magyarázó jegyzetek nem kerülnek a kivetítőre.
- **3 szintű differenciálás**: a gyakorló és házi feladatok alapszint, standard és kihívás (emelt) nehézségben is megjeleníthetők.
- Párhuzamos osztályok mappáihoz rendelhető; a diákok és szülők számára megosztható nyilvános linken elérhető.

### 3. Próbakő — feladatlap-, röpdolgozat- és témazáró-tervező
- **7 feladattípus**: kifejtős/számolós, hiányos szöveg, feleletválasztós, igaz-hamis, párosítós, keresztrejtvény, egyéni feladat állítható nehézséggel (1–5) és pontszámmal.
- **Beolvasás (OCR)**: meglévő papíralapú feladatlap fényképről vagy PDF-ből digitális, szerkeszthető feladatokká alakítható.
- **Csoportverziók (A/B/C/D)**: azonos pedagógiai szerkezetű és pontozású változatok eltérő adatokkal és számértékekkel — a puskázás megelőzésére.
- **Tömör javítókulcs**: végeredmény + lépésenkénti részpontozás minden feladathoz.
- **Újragenerálás és prompt-történet**: a tanári finomítások láncolatának (`refinementHistory`) megőrzése újrageneráláskor; SVG-LaTeX matematikai ábrák generálása; nyomtatható A4 PDF és külön javítókulcs-PDF export.

### 4. Lépéselőny — kirándulás- és rendezvénykísérő, Létszám-Radar
- Tanulmányi kirándulások, erdei iskolák, színházlátogatások, sportnapok, múzeumlátogatások és külföldi utazások valós idejű, biztonsági felügyelete.
- **Diákélmény regisztráció nélkül**: a diákok nem töltenek le alkalmazást az app store-ból; a tanár által generált QR-kóddal vagy 6 karakteres szobakóddal másodpercek alatt csatlakoznak a telefon böngészőjéből (név és opcionális telefonszám megadásával).
- **Vendég-kísérő szerepkör**: kísérő tanárok és szülői segítők Tanársegéd-fiók nélkül, kísérő-kóddal csatlakozhatnak; látják a radart és a diákok állapotát, hívást kezdeményezhetnek, de a szobát nem zárhatják le.
- **Hibrid szülői hozzájárulás (GDPR megfelelőség)**:
  - *Papíralapú nyilatkozat*: letölthető, korosztály-semleges 2 oldalas nyomtatvány (18 év alatt szülői aláírás a diák egyetértési jogával, 18 év felett diák aláírás).
  - *Digitális szülői jóváhagyás*: SMS-ben vagy üzenetben kiküldhető magic link (`/lepeselony/szulo/[token]`), ahol a szülő belépés nélkül, egy kattintással hozzájárul a helymeghatározáshoz (kriptográfiai SHA-256 token, szülői személyes adatot nem tárolunk).
  - *„Csak SOS mód” / Passzív védőháló*: hozzájárulás hiányában a telefon NEM küld koordinátát a szervernek. A diák ettől függetlenül kapja a tanári körüzeneteket, a telefonja helyben mutatja a távolságot és irányt, és veszély esetén az SOS gomb a GDPR 6. cikk (1) d) pontja (életfontosságú érdek) alapján azonnal továbbítja a koordinátákat.
- **Kétféle gyülekezési mód**:
  - *Statikus gyülekezőhely*: fix koordinátájú találkozási pont (pl. buszparkoló) érkezési sugárral (méter) és találkozó-időponttal.
  - *Dinamikus „Engem kövessetek!” mód*: a mozgásban lévő csoportnál a célpont maga a túravezető tanár pillanatnyi GPS koordinátája; a lemaradó diák így a haladó csoportot éri utol.
- **Létszám-Radar felület**:
  - Valós idejű számláló: hány diák tartózkodik a gyülekező zónában (pl. 26/28 fő).
  - Hiányzók listája távolság szerint növekvő sorrendben, utolsó jelzés idejével és akkumulátor töltöttségi szinttel (Android).
  - Egykattintásos telefonhívás közvetlenül a radarról (`tel:` hivatkozás).
  - Térképnézet (OpenStreetMap / Leaflet) a diákok és kísérők pozíciójával.
- **Mobiltechnikai korlátok kezelése**:
  - *Screen Wake Lock API*: meggátolja a kijelző elalvását aktív használat közben.
  - *„Alszik” állapot*: a képernyőzár vagy háttérbe tett böngészőlap esetén jelzi a radaron: „📴 a telefonja alszik”, megelőzve a téves riadalmat.
  - *Ébresztő Ping (Wake-up Ping)*: néma vagy zárolt képernyőjű telefonok felrezegtetése Web Push értesítéssel soronként („📍 Hol vagy?”), tömegesen („Mindenki jelentkezzen!”), vagy 10 perc inaktivitás után automatikusan; a diák koppintására a megnyíló oldal azonnal frissíti a koordinátákat.
- **Biztonsági SOS és Offline SMS Fallback**:
  - 3 másodperces nyomvatartással védett vészhívó gomb (véletlen érintés kizárva), azonnali hang- és vizuális riasztással a tanári radaron.
  - *Internetmentes SMS tartalék*: mobilnet hiányában (erdő, hegyvidék) a gomb megnyitja a telefon előre címzett SMS küldőjét a legutóbbi GPS koordinátákkal és Google Maps linkkel a tanár telefonszámára.
- **Kétirányú gyorskommunikáció**: tanári körüzenetek (Broadcast) olvasási visszaigazolással; diák gyorsgombok („Értettem, indulok!”, „Késem 5 percet”, „Mosdóban vagyok”, „Segítségre van szükségem”).
- **Zero-Data Privacy és Automatikus TTL**: a kirándulás lezárásakor (vagy legkésőbb 16 óra elteltével) minden név, telefonszám, koordináta és üzenet automatikusan és visszavonhatatlanul törlődik a rendszerből.
- Letölthető hozzájáruló nyilatkozat: https://tanarseged.hu/Lepeselony_Hozzajarulo_Nyilatkozat.pdf

### 5. KatedraPajzs — tanári jogi döntéstámogató és munkajog
- **Jogi intelligencia**: a Google Gemini 2.5 Pro modelljére épülő, 2 millió tokenes kontextusablakkal dolgozó szakmai döntéstámogató pedagógusoknak szülői konfliktusok, fegyelmi helyzetek és intézményi eljárások kezelésére.
- **Jogszabályi bázis**: Nkt. (2011. évi CXC. törvény), 20/2012. (VIII. 31.) EMMI rendelet, Státusztörvény (Púétv., 2023. évi LII. törvény), Okostelefon-rendelet (245/2024. Korm. rendelet), GDPR, Ptk. képmás- és hangfelvételi szabályok, Btk. pedagógus elleni erőszak védelme.
- **Multimodális bevitel**: gépelt szöveg, mikrofonos diktálás (Web Speech API), Iskolai Házirend és SZMSZ PDF feltöltése, valamint Iskolai honlap automatikus feltérképezése (Web Crawler).
- **Kettős jogi réteg**: összeveti a hatályos jogszabályokat az iskola helyi házirendjével, kiszűrve az esetlegesen jogellenes intézményi házirendi pontokat.
- **Taktikai védelem és KRÉTA válaszlevél-sablon**: nem általános tanácsot ad, hanem rideg jogi tények alapján kikezdhetetlen, hivatalos KRÉTA üzenetet / válaszlevelet fogalmaz meg pontos jogszabályi hivatkozásokkal.
- Regisztrációval 1 ingyenes kérdés tehető fel kipróbálásra.

### 6. ÓraMátrix — intelligens órarendkészítő
- Ütközésmentes heti órarend-tervezés, tantárgyfelosztás és tanterem-allokáció támogatása pedagógusok és iskolavezetők részére.
- Tanári névhasználati hozzájárulás kezelése e-mailes magic linken keresztül (`/oramatrix/hozzajarulas/[token]`).

### Szakmai tudástár (tanarseged.hu/blog)
- 30+ tudományos igényű szakcikk a kognitív pszichológiáról és tanításmódszertanról: kognitív terheléselmélet (Sweller), kívánatos nehézségek és aktív felidézés (Bjork), munkamemória kapacitása, differenciálás nagy létszámú osztályokban, tanári kiégés megelőzése.

---

## Tantárgyak és évfolyamok

- A Tanársegéd a NAT 2020 összes tantárgyát támogatja: matematika, magyar nyelv és irodalom, történelem, biológia, fizika, kémia, földrajz, idegen nyelvek (angol, német stb.), digitális kultúra, állampolgári ismeretek, etika, alsós és felsős tantárgyak 1–12. évfolyamon.
- **Nukleusz tantárgyi tudásbázis**: több ezer előre ellenőrzött lecke és didaktikai tananyag-atom áll rendelkezésre Matematika (5–12. évfolyam), Történelem (5–12. évfolyam), Magyar nyelv és irodalom (5–12. évfolyam), Természettudományok és Digitális kultúra tantárgyakból.

---

## Pedagógiai és technikai alapelvek

1. **Emberi felülvizsgálat (Human-in-the-loop)**: a mesterséges intelligencia előkészíti az anyagokat, de minden óravázlatot, feladatot és javítókulcsot a tanár ellenőriz és hagy jóvá.
2. **Kognitív terhelés minimalizálása**: tiszta, egy lépés = egy gondolat szerkezet az Óravásznon; a megoldások külön dián jelennek meg.
3. **Méltányosság és adatvédelem**: tiltott a diákok kézírásán vagy személyes jellemzőin alapuló automatikus következtetés. A kirándulások lezárásakor minden jelenléti és helyadat azonnal megsemmisül (Zero-Data TTL).

---

## Hivatalos linkek

- Főoldal: https://tanarseged.hu
- Regisztráció (100 ajándék Szikrával): https://tanarseged.hu/register
- Szakmai tudástár: https://tanarseged.hu/blog
- Nyilvános feladatbank: https://tanarseged.hu/feladatok
- Adatvédelem és GDPR: https://tanarseged.hu/adatvedelem
- Általános Szerződési Feltételek: https://tanarseged.hu/aszf
- Impresszum (Klára Botond E. V.): https://tanarseged.hu/impresszum
- Kapcsolat: https://tanarseged.hu/kapcsolat

## Részletes rendszerdokumentáció MI-modelleknek

- Részletes műszaki leírás, adatmodellek, GYIK és demonstrációs példák: https://tanarseged.hu/llms-full.txt