Áttekintés
A Sípszó telefonra telepíthető webapp (PWA) a Jász-Nagykun-Szolnok Vármegyei Kosárlabda Szövetség játékvezetőinek: figyeli a szövetség küldési oldalát, és mindenkinek csak a saját mérkőzéseiről szól. Több felhasználós; mindenki a saját fiókjával lép be, és csak a saját adatait látja.
Az app egy helyre gyűjti, ami eddig hét külön felületen volt:
- Küldések: a JNKSZ oldalát 15 percenként nézi, új küldésről, módosult időpontról vagy helyszínről, lekerülésről azonnal értesít.
- Eredmények: végeredmény, negyedek és jegyzőkönyv (PDF) automatikusan az mkosz.hu-ról.
- Eredményfeltöltés: megyei meccsnél egy gombnyomással a JNKSZ felületére, előnézettel és visszaellenőrzéssel.
- Tesztek: a jatekvezeto.hu határidői visszaszámlálóval, emlékeztető 7, 3, 1 nappal előtte és aznap.
- Tudósítás: AI írja a jegyzőkönyvből, Word fájlként a szövetségi sablon szerint.
- Bevétel és számla: díjtáblázat szerinti bruttó és nettó díj, kitöltött MKOSZ versenybírói elszámolás (xlsx és PDF).
- Naptár, statisztika, havi összefoglaló: feliratkozható naptár, szezonösszesítő, havi diagram, minden hónap elején összefoglaló e-mail.
A futó verzió a Beállítások alján látszik, az újdonságok a Változásnapló részben.
Felhasználói útmutató
Az app meghívó linkkel kezdődik; belépés után az Útmutató oldal végigvezet a beállításokon, a főoldali „Első lépések” kártya pedig addig látszik, amíg a kötelező lépések nincsenek kész.
Első lépések
- Meghívó beváltása. A link 7 napig érvényes, egyszer használható. Add meg a neved pontosan úgy, ahogy a küldési táblázatban áll, majd felhasználónevet és jelszót. A szezonod értesítések nélkül betöltődik.
- Telepítés a telefonra. Böngészőben nyisd meg az appot, majd „Főképernyőhöz adás”. Alkalmazásbolt nem kell.
- Push értesítés bekapcsolása. Beállítások → Értesítések. iPhone-on csak a kezdőképernyőre telepített appból működik (iOS 16.4+).
- jatekvezeto.hu belépés a tesztekhez (nem kötelező; tesztet kézzel is fel lehet venni).
- JNKSZ eredményfeltöltő belépés a megyei meccsek egy gombos feltöltéséhez.
- Számlasablon a saját személyes adataiddal; titkosítva tárolódik.
- Naptár feliratkozás a Beállításokban látható titkos címre.
- Passkey a jelszó nélküli, ujjlenyomatos belépéshez.
Elfelejtett jelszó vagy felhasználónév
A belépő oldalon az „Elfelejtetted a jelszavad vagy a felhasználóneved?” linkre kattintva add meg az értesítési e-mail címedet (Beállítások → Értesítések). Ha a cím egy fiókhoz tartozik, levelet kapsz a felhasználóneveddel és egy linkkel, amivel új jelszót állíthatsz be. A link 60 percig érvényes, egyszer használható; új kéréskor a régi érvényét veszti, óránként legfeljebb 3 kérés. Az oldal mindig ugyanazt válaszolja, így nem derül ki, kinek van fiókja. Az új jelszó után a többi eszközön újra be kell lépni, és minden eszközre értesítés megy a változásról.
Akinek nincs e-mail címe megadva, annak az adminisztrátor készít visszaállító linket (Beállítások → Felhasználók → „Elfelejtett jelszó: visszaállító link”): 24 óráig érvényes, QR kóddal, egyszer használható.
Beállítások oldal
| Szakasz | Mit állítasz itt |
|---|---|
| Fiók | név a küldésekben, felhasználónév, jelszó |
| Megjelenés | sötét, világos vagy automatikus (eszközönként) |
| Navigáció a helyszínre | Google Maps, Waze vagy „Mindig kérdezzen”: ebben indul az útvonalterv, ha a helyszínre koppintasz |
| Tesztek | jatekvezeto.hu felhasználónév és jelszó |
| Eredményfeltöltő | JNKSZ admin belépés |
| Számla | saját számlasablon feltöltése |
| Értesítések | push eszközök, értesítési e-mail (ezzel kérhető új jelszó is), „E-mail a meccseimről” ki/be, esti emlékeztető ki/be, ntfy téma, havi összefoglaló |
| Naptár | a titkos naptárcím, újragenerálás |
| Belépés az appba | jelszó, passkey-k kezelése |
| A szövetségi oldal figyelése | utolsó szinkron állapota |
| Kapcsolódások | AI tudósításíró, Számlák, Útmutató, Súgó |
| Adatmentés | csak adminisztrátornak: napi mentések, letöltés, heti mentés e-mailben |
| Rendszerállapot | csak adminisztrátornak: az önellenőrzés eredménye |
| Igénylések a weboldalról | csak adminisztrátornak: a bemutató weboldal űrlapjáról érkezett app-igények |
| Felhasználók | csak adminisztrátornak: meghívók, fiókok, jelszó-visszaállító link |
A külső jelszavakat az app titkosítva tárolja, és a böngészőnek sosem küldi vissza.
Funkciók oldalanként
Telefonon az alsó menü hat fülével (Főoldal, Meccsek, Tesztek, Tudósítás, Bevétel, Beállítás) lehet váltani; 1024 px felett bal oldali menü van, és az oldalak két oszlopba rendeződnek.
| Oldal | Mit mutat, mit lehet tenni |
|---|---|
| Főoldal | következő mérkőzés narancs kártyán, útvonal gombbal a csarnokba; teendők (feltöltendő eredmény, írandó tudósítás); közelgő tesztek; heti küldések; négy szám (szezonban fújt, e havi, kiírt, függő nettó bevétel); legutóbbi értesítések |
| Meccsek | a szezon összes küldése; meccsoldalon a helyszínre koppintva útvonalterv (Google Maps vagy Waze), végeredmény és negyedek, jegyzőkönyv, MKOSZ link, küldött személyzet („Te” jelöléssel), eredményfeltöltés, naptárfájl (.ics), számla PDF-ben és Excelben, előzmények |
| Tesztek | kitöltendő tesztek határidővel, „még N nap” jelzés, „Megcsináltam” gomb, kézi felvétel, a jatekvezeto.hu kapcsolat állapota, korábbi tesztek |
| Tudósítás | csak a Vármegyei Felnőtt Férfi és Női meccsek tudósítása (máshol nincs „Tudósítás írása” gomb): szerkeszthető fejléc, AI szöveg, „Ellenőrizendő” lista, Word letöltés |
| Bevétel | megkeresett nettó és bruttó, megérkezett / függőben / várható összeg, havi diagram, szűrés, „megérkezett” jelölés, kézi összeg-felülírás |
| Számlák | a szezon számlái időrendben, sorszámmal; a díj itt és a számla oldalán is átírható (a számla az új összeggel készül) |
| Statisztika | hivatalos szezonösszesítő típusonként, havi diagram, szerepkörök |
| Értesítések | az appon belüli értesítési lista (csengő), olvasott/olvasatlan |
| Útmutató | a beállítás lépései állapottal |
| Súgó | ez a leírás: használat, gyakori kérdések, újdonságok |
Tudósítás két módban
- API kulccsal: a jegyzőkönyv megérkezése után a tudósítás automatikusan megíródik, meccsenként egyszer (hiba esetén kézzel újraírható; az önellenőrzés egyszer magától is újrapróbálja).
- Ingyenes mód (nincs API kulcs): jegyzőkönyv letöltése, az utasítás kimásolása a claude.ai-ba, majd a válasz visszamásolása. Az app ebből ugyanúgy elkészíti a fejlécet és a Word fájlt.
A fejlécet (eredmény, negyedek, helyszín, dátum, játékvezetők lakóhellyel) a program tölti ki; az AI csak a jegyzőkönyvben, az MKOSZ adatokban és a megjegyzéseidben szereplő tényeket használja. Beküldés előtt mindig nézd át.
Bevétel és számla
- A díjat az osztály neve, a szerepkör és a nap (hétköznap/hétvége) alapján keresi ki a JNSZ vármegyei 2025/26 és az MKOSZ 2026/27 díjtáblázatból. Ahol a táblázat nem egyértelmű, a díj „becsült”, és felülírható.
- Nettó = bruttó − bruttó × 0,9 × 0,335 (felfelé kerekített levonás). Például 14 500 Ft bruttóból 10 128 Ft nettó.
- A számla a küldés megérkezésekor elkészül (a még le nem játszott meccsé is, „Közelgő meccs” jelöléssel), a kelte és a sportesemény ideje a meccs napja. Minden megnyitáskor a küldés aktuális adataiból áll össze, így ha a küldés módosul (időpont, helyszín, szerepkör), a számla is; a visszavont küldés számlája eltűnik.
- Egy számla = egy mérkőzés, akkor is, ha egy nap egy helyen több meccs volt. A sorszám a szezon számlái időrendben, 1-től. Az útiköltség szakasz mindig üres marad.
Esti emlékeztető
A meccs előtti estén 19 óra után push értesítés jön a holnapi meccs(ek)ről: kezdés, helyszín, szerepkör és hogy kivel fújsz. Ha egy napra több meccsed van, egy értesítésben látod mindet (eltérő helyszínnél a várossal). Koppintásra a meccs oldala nyílik, onnan egy gombbal indul a navigáció. E-mail nem megy róla. Beállítások → Értesítések → „Esti emlékeztető a holnapi meccsről”: ki-be kapcsolható.
Havi összefoglaló
Minden hónap elején (reggel 8 után) e-mail az előző hónapról az értesítési címre: meccsek bajnokságonként és szerepkörönként, bruttó és nettó bevétel (megérkezett és függő), havi nettó diagram, a szezon állása, tudósítások és eredményfeltöltések állapota, közelgő tesztek, jövő havi küldések. Üres hónapról (nyári szünet) nem megy levél. Beállítások → Értesítések: ki-be kapcsolható, előnézet és próbaküldés.
Gyakori kérdések
A legtöbb hiba egy hiányzó beállításból jön; először az Útmutató oldal lépéseit érdemes megnézni.
| Tünet | Ok | Megoldás |
|---|---|---|
| Nem látszanak a meccseim | a név nem egyezik a küldési táblázatéval | Beállítások → Fiók: a nevet pontosan úgy, ahogy a táblázatban áll |
| iPhone-on nincs push | csak telepített appból működik | Főképernyőhöz adás (iOS 16.4+), majd értesítés bekapcsolása az appból |
| Google Naptárban későn frissül | a Google néhány óránként olvassa a feliratkozott naptárt | az azonnali jelzés a push; vagy e-mailes naptármeghívó |
| Duplán látszik a meccs a naptárban | feliratkozás és e-mailes meghívó egyszerre | az egyiket kapcsold ki: a feliratkozást a naptárban, vagy a meccsekről szóló e-maileket a Beállítások → Értesítések alatt |
| Nem jön meg az e-mail / havi összefoglaló | nincs értesítési cím megadva, vagy a Spam mappába került | Beállítások → Értesítések: add meg a címed; nézd meg a Spam mappát is |
| Nincs eredmény a lejátszott meccsnél | még nincs fent az MKOSZ oldalán (felkészülési meccsnél általában nem is lesz) | az app óránként újranézi |
| „Nem sikerült belépni” a teszteknél | hibás vagy lejárt jatekvezeto.hu jelszó | Beállítások → Tesztek, majd mentés és ellenőrzés |
| Elfelejtett jelszó vagy felhasználónév | – | belépő oldal → „Elfelejtetted…?”, levél az értesítési címre; e-mail cím nélkül az admintól kérj linket |
| Nem jön meg a visszaállító levél | nincs (vagy más) értesítési cím a fiókban, vagy a Spam mappában van | nézd meg a Spamet; vagy kérj linket az admintól |
Miért nem tűnt el egy törölt meccs? Egy meccs csak akkor számít „lekerültnek”, ha a dátuma a letöltött oldalak időszakába esik, és már nincs rajta. Ha az oldal teljesen üres (hiba), az app semmit nem töröl.
Mi az „(x)” a névnél? Az első számú játékvezetőt jelöli a táblázatban; az app nem jeleníti meg.
Mennyibe kerül az AI tudósítás? Neked semmibe: ha az appban be van állítva az automatikus írás, magától elkészül; ha nincs, az ingyenes móddal a claude.ai-ban egy perc alatt megvan.
Változásnapló
A verziószám három részes: új funkciónál vagy egy funkció kivezetésénél a középső szám nő (0.2.0 → 0.3.0), hibajavításnál az utolsó (0.2.0 → 0.2.1). A futó verzió és a build azonosítója (GitHub commit) a Beállítások alján és asztali gépen a bal menü alján látszik.
0.10.0 – 2026. október 14.
- Esti emlékeztető: a meccs előtti estén 19 óra után push értesítés a holnapi meccs(ek)ről (kezdés, helyszín, szerepkör, társak); koppintásra a meccs oldala nyílik. Beállítások → Értesítések alatt kikapcsolható.
- Automatikus adatmentés (admin): minden éjjel mentés a szerverre (az utolsó 14 nap marad), hetente e-mailben is az adminnak; a Beállítások → Adatmentés alatt letölthető, a teljes mentés (titkos kulccsal) is. Az önellenőrzés pótolja az elmaradt mentést.
0.9.1 – 2026. október 14.
- Új cím: app.sipszo.app. Az app saját domainre költözött (a weboldal: sipszo.app, a demó: demo.sipszo.app). A régi cím egy ideig még működik. Az új címen egyszer újra be kell kapcsolni a push értesítést, és ha használtál passkey-t, azt is újra be kell állítani (Beállítások); a telepített appot érdemes az új címről újra a főképernyőre tenni. A feliratkozott naptárad tovább frissül.
0.9.0 – 2026. október 14.
- Navigáció a csarnokba: a meccs helyszínére koppintva útvonaltervezés indul a jelenlegi helyedről, a Google Maps-ben vagy a Waze-ben. Melyikben, azt a Beállítások → Navigáció a helyszínre alatt választod ki; „Mindig kérdezzen” esetén mindkettő gombként látszik. A keresés a küldésben szereplő helyszínből (a várossal együtt) és az országból áll, így nem talál azonos nevű csarnokot máshol. A főoldali „Következő mérkőzésed” kártyán is van útvonal gomb.
0.8.0 – 2026. október 14.
- Dokumentáció helyett Súgó: az appban (bal menü, Beállítások → Kapcsolódások) mostantól csak a felhasználóknak szóló rész látszik: használat, gyakori kérdések, újdonságok. A telepítési és fejlesztői leírás kikerült az appból (a forráskód mellett van). A régi Dokumentáció link a Súgóra visz.
0.7.0 – 2026. október 14.
- E-mail a meccseimről ki/be: Beállítások → Értesítések. Kikapcsolva a küldésekről (naptármeghívóval együtt), az eredményekről és a tudósításokról nem megy levél; a push értesítés, a csengő, a jelszó-visszaállítás és a havi összefoglaló marad.
- Díj javítása a számlánál is: a meccs bruttó díja a Számlák listában és a számla oldalán is átírható (közelgő meccsnél is), és a számla azonnal az új összeggel készül; üresen hagyva visszaáll a díjtáblázat szerintire. A díj a díjtáblázatból jön, nem a számlasablonból, így díjváltozáskor elég átírni az összeget.
- Tudósítás csak ahol kell: a „Tudósítás írása” gomb csak a Vármegyei Felnőtt Férfi és Női meccseknél jelenik meg; a Tudósítások oldalon nincs már „Írj a többi meccsedről is” ajánló. Más meccsről korábban megírt tudósítás továbbra is megnyitható.
- Javítás: a demó automatikus beléptetése után a böngésző a konténer belső címére (0.0.0.0) ugrott; most a látogató által használt címre tér vissza.
0.6.0 – 2026. október 14.
- Számla rögtön: a számla már a küldés megérkezésekor elkészül (nem csak a meccs napjától), a meccs napjának dátumával. A Számlák listában „Közelgő meccs” jelzi a még le nem játszottakat; a küldés módosulása a számlán is megjelenik.
- Az automatikus frissítés megbízhatóbb: az image építése átmeneti hálózati hibánál többször újrapróbálja a csomagok letöltését.
- A demó címe
sipszo-demo.designfirst.hu(Cloudflare mögött egyszintű aldomain kell a tanúsítványhoz).
0.5.0 – 2026. október 14.
- Kipróbálható demó: külön konténer kitalált adatokkal; a weboldal „Próbáld ki” gombjáról regisztráció nélkül belenézhetsz az appba. Minden nap visszaáll, semmi nem kerül ki belőle; ami kifelé hatna, le van tiltva.
0.4.0 – 2026. október 14.
- Igénylések a weboldalról: a bemutató weboldal igénylő űrlapja egyenesen az appba küld; az admin értesítést kap, a Beállításokban listában látja, válaszolhat, kezeltnek jelölheti vagy törölheti. Kéretlen küldések elleni védelem, egy év utáni automatikus törlés.
- A Számlák listában telefonon rendezettebbek a gombok: felül „Megnézem”, alatta a PDF és az Excel.
0.3.0 – 2026. október 14.
- Elfelejtett jelszó vagy felhasználónév: a belépő oldalon e-mailben kérhető a felhasználónév és egy jelszó-visszaállító link (60 perc, egyszer használható); jelszócsere után értesítés minden eszközre.
- Admin: jelszó-visszaállító link QR kóddal azoknak, akiknek nincs e-mail címük (24 óra).
- A saját levelek (havi összefoglaló, jelszó) közös arculatot használnak.
0.2.0 – 2026. október 13.
- Havi összefoglaló e-mail minden hónap elején az előző hónapról, az app arculatával; ki-be kapcsolható, előnézet és próbaküldés.
- Dokumentáció az appban (
/dokumentacio), változásnaplóval. - Önellenőrzés és önjavítás óránként, Rendszerállapot az adminisztrátornak, értesítés új hibáról;
/api/healthéletjel, autoheal. - Verziószám a Beállítások alján és a bal menüben.
- Az ütemező lépései elszigetelve: egy hiba nem állítja le a szervert.
- Kikerült: a számlázz.hu számlázás (teszt fázis). A tárolt kulcsok és beállítások frissítéskor törlődnek; a számla az MKOSZ elszámolásból (Excel/PDF) készül.
0.1.0 – 2026. október 12.
Az első, GitHubról automatikusan frissülő változat: küldésfigyelés és értesítések, eredmények és jegyzőkönyvek, JNKSZ eredményfeltöltés, jatekvezeto.hu tesztek, AI tudósítás, bevételek, MKOSZ számla (Excel és PDF, meccsenként, sorszámmal, a kód a jegyzőkönyvből is), számlázz.hu számlázás (teszt fázis), több felhasználó meghívóval, passkey, asztali nézet, Útmutató.