Robotpilóta, Szikra-elszámolás és Látlelet: Intelligens javítás és osztálydiagnosztika

A Mérleg nem csupán egy optikai beolvasó felület: a háttérben egy olyan többlépcsős, pedagógusbarát technológiai motor dolgozik, amely egyszerre védi a tanár pénztárcáját (kreditegyenlegét), garantálja az értékelés megbízhatóságát, és a javítás végén átfogó diagnosztikai térképet rajzol az egész osztály tudásszintjéről.

Ez az útmutató részletesen bemutatja a motor működését, az elszámolás szabályait és az osztályszintű Látlelet használatát.

🤖 1. A Robotpilóta Működése és Ütemezése

A dolgozatok feltöltése után a pedagógus kezében marad a döntés, hogy mikor és milyen tempóban szeretné előkészíttetni az értékeléseket.

A Robotpilóta alapértelmezetten KIKAPCSOLVA indul

Az új dolgozatok létrehozásakor a gép a feltöltést követően magától nem kezd el dolgozni, és nem fogyaszt Szikrát. Ezzel kizártuk a véletlen kreditfogyasztást vagy a befejezetlen feltöltések korai elindítását.

Kétféle feldolgozási mód közül választhatsz:

┌─────────────────────────────────────────────────────────────────────────┐
│ 🐢 IDŐZÍTETT MÓD (Ajánlott, Gazdaságos)                                 │
│ Időzítési lehetőségek: 30 perc, 2 óra, 4 óra, 10 óra, Este 20:00, 02:00 │
│ Alacsonyabb szerverterhelés → Kevesebb hiba → FÉLÁRON üzemel!           │
├─────────────────────────────────────────────────────────────────────────┤
│ ⚡ AZONNALI / EXPRESSZ MÓD                                               │
│ Azonnali feldolgozás a szünetben vagy sürgős órai javításkor.           │
│ Csúcsidei azonnali kapacitásigény → Dupla Szikra-díj.                   │
└─────────────────────────────────────────────────────────────────────────┘

• Miért éri meg az időzítés?
  Ha a délelőtt folyamán feltöltött dolgozatcsomagot az „Este 20:00” vagy „2 óra múlva” gombra időzíted, a rendszer a szerverek alacsony terheltségű időszakaiban, egyenletesen és minimális hibaaránnyal futtatja le a felismerést. Ezért a tanárnak feleannyi Szikrába kerül az értékelés.
• Mikor használd az azonnali módot?
  Ha a következő tanóra 15 perc múlva kezdődik, vagy azonnal meg akarod mutatni egy diáknak az eredményt.

✦ 2. Hívásonkénti Szikra-díjszabás: Csak a sikeres valós munkáért fizetsz!

A Mérleg elszámolási rendszere szigorúan a valóban lefutott és sikeres MI-hívásokhoz igazodik. Nincsenek rejtett költségek vagy előre levont fix csomagok.

A Szikra-díjtáblázat

Az elszámolás 4 aranyszabálya:

1. Nincs előre levonás (Zero prepayment): A feldolgozás elindításakor a rendszer nem zárolja a pontjaidat. Csupán egy minimális fedezetellenőrzést végez (feladatonként 1 Flash hívás meglétét ellenőrzi).
2. Levonás a folyamat végén: A Szikrák levonása kizárólag a sikeres értékelés befejeztével, egyetlen tételben történik meg.
3. A sikertelen hívás ingyenes: Ha egy hálózati hiba vagy szerver-megszakadás miatt egy hívás meghiúsul, azért 0 ✦ a díj.
4. Teljes átláthatóság: A dolgozat fejlécében és az ellenőrző asztalon forintra pontosan látható az elszámolás: pl. „Levont Szikra: 9 ✦ (7 Flash, 1 Pro fallback — időzített)”.

✋ 3. Bizonytalanság-kezelés: Amikor a gép nem találgat, hanem a tanárhoz fordul

A pedagógiai hitelesség alapja, hogy az MI soha nem találgathat vagy hallucinálhat egy nehezen kibogarászható diák-kézírás esetén. A Mérleg kétlépcsős biztonsági rendszert alkalmaz:

[ Diák megoldása ] ──> [ 1. Gemini Flash ] ──> Bizonyosság >= 50%? ──> [ SIKERES JAVASLAT ]
                              │ (Bizonytalan / Hiba)
                              ▼
                       [ 2. Gemini Pro ]   ──> Bizonyosság >= 50%? ──> [ SIKERES JAVASLAT ]
                              │ (Még mindig bizonytalan)
                              ▼
                 [ ✋ KÉZI PONTOZÁS SZÜKSÉGES ]
                 (0 pont, átadva a szaktanárnak)

1. Első lépcső (Gemini Flash): A feladatot először a villámgyors és költséghatékony Flash modell elemzi.
2. Második lépcső (Gemini Pro fallback): Ha a Flash bizonyossági mutatója 50% alá esik (pl. elmaszatolt grafit, szokatlan ábra, nehéz kézírás), a rendszer automatikusan, legfeljebb egyszer lefuttatja a mélyebb látási képességű Gemini Pro modellt.
3. Tanári átadás (Nulla találgatás):
   Ha a Pro modell után is 50% alatt marad a bizonyosság:
   • Az MI 0 pontot javasol és nem hoz önkényes döntést.
   • Az indoklás automatikusan a következő felhívással indul:
     „✋ Bizonytalan MI-olvasat… kérjük, a szaktanár pontozza kézzel.”
   • A Tanári Ellenőrző Asztalon jól látható narancssárga jelvény figyelmeztet:
     ✋ Kézi pontozás szükséges (bizonytalan MI)
   • Amint a tanár beírja a saját pontszámát és jóváhagyja, a figyelmeztetés azonnal feloldódik.

🛑 4. Ciklusvédelem és Token-optimalizáció

Hogy a rendszer soha ne fusson felesleges köröket és ne terhelje túl a felhasználó fiókját:

• Szigorú kísérletkorlát (Circuit Breaker):
  A feldolgozás fázisai (a lapok részeinek behatárolása, illetve a feladatok pontozása) legfeljebb 3 kísérletet kapnak. Ha egy rendkívül homályos vagy sérült kép miatt 3 próbálkozás után sem sikerül az elemzés, a rendszer leáll és tiszta hibaüzenettel értesíti a tanárt – kizárva a végtelen újrapróbálkozási hurkokat.
• Intelligens képfelbontás-optimalizáció (1400 px):
  A behatárolási lépésnél a nagy felbontású mobilfotók mérete 1400 képpontos leghosszabb oldalra skálázódik. Ez 50-60%-kal csökkenti a képfelismerő tokenek számát és felgyorsítja a folyamatot anélkül, hogy a kézírás részletgazdagsága sérülne.

📊 5. A Látlelet Modul: Osztálydiagnosztika és Megoldókulcs

Amikor a dolgozatok javítása befejeződött, a tanárnak nem kell kézzel statisztikát készítenie a szülői értekezletre vagy a szakmai munkaközösségnek. A dolgozat fejlécében a „📊 Látlelet (statisztika & megoldások)” gombra kattintva azonnal elérhető az osztály mélydiagnosztikai elemzése.

A Látlelet 5 pillére:

I. Összkép & Alapstatisztika

• Osztályátlag a legkisebb és legnagyobb elért pontszámmal.
• Legjobban sikerült feladat (zöld kártya) és a legnehezebb feladat (korallpiros kártya) kiemelése.

II. Jegyeloszlás és Görbe-diagnózis

A rendszer automatikusan felméri a jegyek eloszlását és pedagógiai diagnózist ad a dolgozat nehézségéről és az osztály állapotáról:

• Kiegyensúlyozott haranggörbe (Gauss): A dolgozat optimális nehézségű volt, a jegyek többsége a középmezőnybe (3-as, 4-es) esik.
• Bimodális (kétpúpú) görbe:
  Ha az 1–2-esek és a 4–5-ösök aránya is legalább 30%, míg a 3-asoké legfeljebb 15%.
  Jelzés: Az osztály kettészakadt! Egy erős élmezőnyre és egy lemaradó rétegre. Itt differenciált felzárkóztatásra van szükség.
• Balra tolt görbe:
  Ha az 1–2-esek aránya eléri az 55%-ot.
  Jelzés: Túl nehéz dolgozat, vagy a tananyag mélyebb átbeszélése szükséges a továbblépés előtt.
• Jobbra tolt görbe:
  Ha a 4–5-ösök aránya eléri a 60%-ot.
  Jelzés: Kiemelkedően sikeres témaelsajátítás.

III. Feladatonkénti eredményesség

Színes sávdiagramok mutatják minden feladatra:

• Eredményességi arány (🟢 75% felett kiváló, 🟡 50–75% közepes, 🔴 50% alatt kritikus).
• Átlagpontszám, hibátlan megoldások és 0 pontos dolgozatok pontos darabszáma.

IV. Típushibák (Konkrét pontvesztési okok)

Az 50% alatti feladatoknál a rendszer kigyűjti a leggyakoribb botlóköveket (pl. „b) részfeladat: 14 dolgozatban hibás, összesen 9 pont veszett el itt”). Ez felbecsülhetetlen segítség az órai közös javítás előkészítésekor.

V. Hivatalos megoldókulcs verzióváltóval és KaTeX képletekkel

• Az A és B csoportos feladatok és megoldások egy helyen lapozhatók.
• A matematikai és természettudományos levezetések nyomdai minőségű KaTeX képletekkel jelennek meg.
• A feladatokhoz tartozó ábrák megtisztított, biztonságos vektoros grafikaként (inline SVG) jelennek meg.

🖨️ Nyomtatás és Adatvédelem (Zero-PII)

• Egykattintásos nyomtatás (Ctrl + P / Cmd + P):
  A felület automatikusan átvált tiszta, fekete-fehér papírformátumra. A sötét háttér eltűnik, a navigációs gombok elrejtőznek, a kártyák nem törnek ketté a laphatárokon, és csak az éppen kiválasztott feladatcsoport megoldókulcsa kerül a papírra.
• Szigorú Zero-PII Garancia:
  A Látlelet kizárólag összesített statisztikai mutatókat tartalmaz. Egyetlen diák neve, oktatási azonosítója vagy személyes adata sem kerül be a statisztikába, így az összkép munkaközösségi értekezleten vagy hospitáláson is aggálytalanul megosztható.