✨ Szorzótábla Mester

Szorzótábla- és bennfoglalás-gyakorló web-app alsósoknak, tabletre és telefonra. Kitehető a kezdőképernyőre, és telepítés után internet nélkül is működik. Ingyenes. Fiók nélkül semmilyen adatot nem küld sehova.

▶ Az app megnyitása: https://vmynick.github.io/matek-gyakorlo/

👨‍👩‍👧 Szülői / tanári felület: https://vmynick.github.io/matek-gyakorlo/szulo.html (csak meghívóval)

Mit tud?

• Szorzás és osztás (bennfoglalás) a 0–10-es táblákból. A szorzás a tankönyv szerinti sorrendben jelenik meg: a 4-es tábla 1 × 4, 2 × 4 … 10 × 4.

• Hiányzó tényező (? × 7 = 56) és maradékos osztás (38 : 7 = 5, maradék 3) a 100-as körben, külön mezővel a maradéknak.

• A műveletek tetszőlegesen kombinálhatók: egyszerre több is kiválasztható, és egy tesztben mindegyikből nagyjából ugyanannyi feladat jön.

• ☀️ Mai gyakorlás: egy gombnyomásra 10 feladat a gyerek eddigi eredményeiből:

  • előbb a hibásak;
  • aztán az esedékes ismétlések: a sorozatban elsőre jó válaszok számától függően 1, 2, 4, 7 vagy 14 nap után kerül elő újra egy feladat;
  • végül néhány új feladat, előbb a már gyakorolt táblákból, utána a következő táblából.

• Segítség rossz válasz után:

  • csontnál egy tipp, ami nem árulja el az eredményt, csak egy lépést mutat (pl. 9 × 7 = 10 × 7 − 7, és 10 × 7 = 70);
  • végleges hibánál a teljes levezetés, egy pöttyös ábrával. A gyerek a „Tovább” gombbal lép tovább.

  A szülői kikérdező szigorú marad: ott nincs tipp.

• Gyakorló mód: 3 „csont” jár, vagyis három rossz válasz egyszer javítható.

• Szülői kikérdező: szigorú teszt csont nélkül, a kiválasztott táblák minden feladata pontosan egyszer szerepel.

• Hibák gyakorlása: a korábban rontott vagy csonttal javított feladatokat kérdezi újra. Egy feladat akkor kerül le a listáról, ha kétszer egymás után elsőre jó.

• Eredménykimutatás szülőknek: a rontott és a csonttal javított feladatok listája, valamint az eltelt idő.

• Fejlődés fül: grafikon az eddigi tesztekről, és egy feladat-térkép. A térkép 11×11-es rácsán színnel látszik, melyik feladat megy biztosan és melyik nem. A lassú válaszokat is jelzi, egy mezőre koppintva pedig megjelennek a részletek.

• A statisztikát csak a szülő törölheti, szülői PIN-nel.

• Sötét mód, és magától frissül, ha új változat jelenik meg (teszt közben nem).

Szülőknek és tanároknak (felhő, nem kötelező)

• A szülő vagy tanár meghívóval kap hozzáférést, és e-mailes belépő linkkel lép be, jelszó nélkül.
• Szülői mód a saját eszközön:
  • a gyakorló app tetején, a cím alatti „👨‍👩‍👧 Szülői mód” gombbal az app ezen az eszközön mindig a szülői felülettel indul;
  • a felület tetején lévő „🎮 Gyakorló mód” gomb kapcsolja vissza;
  • a gomb csak nem összekötött eszközön látszik, a gyerekek eszközén nem.
• Szerepek:
  • 🏠 Szülő: családot hoz létre a gyerekeinek; a másik szülőt, nagyszülőt családtagként hívja meg;
  • 🏫 Tanár: osztályt hoz létre, tanártársat és szülőket hív meg;
  • 🛡️ Admin: szülőket és tanárokat hív meg, és a szerepüket is állítja.
• A tanári funkciók (osztályok) az Admin fülön kapcsolhatók, és alapból ki vannak kapcsolva.
  • Kikapcsolva csak szülők és családok vannak. Nem lehet tanárt meghívni, osztályt létrehozni és csatlakozási kódot használni; ezt az adatbázis is ellenőrzi.
  • A meglévő osztályok megmaradnak, és visszakapcsoláskor újra látszanak.
• Csoportok: a család vagy az osztály; gyerekeket ad hozzá (csak becenév és avatar).
• A gyerek eszközét egy 6 jegyű kód köti össze a gyerek profiljával. A gyereknek nem kell fiók. Ezután az eredményei minden eszközén közösek, és a felnőttek látják a grafikonját és a feladat-térképét.
• Internet nélkül is lehet gyakorolni: az eredmények megvárják a következő kapcsolatot.
• Közös tablet: több gyerek is használhatja ugyanazt az eszközt. Induláskor „Ki gyakorol most?”, a gyerek-PIN nem kötelező.
• Szülő és tanár külön nézet:
  • a szülő a gyerekeit látja elöl;
  • a tanár az osztályait, közös feladat-térképpel. Ezen egy mezőre koppintva látszik, kinek kell még gyakorolnia;
  • fülek: 🏠 Családom / 🏫 Osztályaim / 🛡️ Admin / 👤 Fiók. Elöl a gyerekek és az eredmények, a beállítások összecsukható listában;
  • a fejlécben látszik, milyen szerepben (admin, szülő, tanár) vagy belépve.
• Osztály:
  • a tanár csatlakozási kódot ad, a szülő azzal teszi be a gyerekét az osztályba;
  • a tanár szülőket is meghívhat;
  • a családi gyerek eszközeit, PIN-jét és törlését továbbra is a család kezeli.
• Kiosztott feladatok:
  • például „7-es tábla, szorzás és osztás, 20 db, péntekig”;

Adatok

• Összekötés nélkül minden eredmény csak az eszköz böngészőjében tárolódik (localStorage), semmi nem megy ki az eszközről.
• Összekötött eszközön az eredmények a Supabase adatbázisba kerülnek, az EU-ba (Írország).
  • Gyerekekről csak becenevet és avatart tárolunk.
  • Hogy ki mit láthat, azt az adatbázis szabályai (RLS) biztosítják (supabase/migrations).
  • Részletek a szülői felületen, a „Milyen adatot tárolunk?” résznél.

Fejlesztés

Build lépés nincs, a fájlok:

• szorzotabla.html: a gyakorló app oldala; a stílusa és a kódja témánként az app/ mappában:
  • app.css: a stílus;
  • app.js: állapot, hangok, indulás, sötét mód;
  • setup.js: a kezdőképernyő beállításai;
  • deck.js: a feladatok összeállítása, a feladatonkénti eredmények és a mai gyakorlás;
  • quiz.js: a teszt menete és az eredmény;
  • progress.js: a Fejlődés fül;
  • pin.js: szülői és gyerek-PIN;
  • update.js: offline működés, frissítés, verzió;
  • cloud-ui.js: összekötés, kiosztott feladatok, csillagok;
• szulo.html és szulo.js: a szülői / tanári felület;
• stats.js és common.css: közös statisztika és színek;
• hints.js: a tippek és a levezetések rossz válasz után;
• cloud.js: a gyerek eszközének szinkronja;
• sw.js: offline működés.

A Chart.js, a canvas-confetti és a supabase-js helyi másolata a vendor/ mappában van.

npm install                # playwright-core a tesztekhez
npm test                   # böngészős tesztek a gépen lévő Chrome-mal (BROWSER=msedge is jó)
node tests/cloud.test.mjs  # felhő teszt a teszt projekten (titkos kulcs kell hozzá)

• Adatbázis és beállítások: a scripts/supabase.mjs kezeli (migrate / auth / status), a titkok a gépen, környezeti változóban vannak (scripts/set-secrets.ps1).
• Közzététel: a main ágra küldött minden változtatás után a GitHub Actions lefuttatja a teszteket, és ha mind átmegy, közzéteszi az appot a GitHub Pages-en.

Licenc

MIT. A felhasznált könyvtárak: Chart.js (MIT), canvas-confetti (ISC), supabase-js (MIT).