Tesztállomás regisztráció
Ez a dokumentáció segít megismerni a regisztráció folyamatát és alkotóelemeit.
A regisztráció a https://regisztracio.tesztallomas.hu weblapon érhető el.
MAX_SEATS_PER_APPOINTMENT = 5
Ez az érték mutatja, hogy maximum hány Seat tartozhat egy Appointmenthez.
A regisztráció első lépése, a tesztelésre jelentkező elfogadja mind az ÁSZF-et, mind az Adatvédelmi Szabályzatot.
Az ÁSZF és Adatvédelmi Szabályzat elfogadása az Appointment összes Seat-jére vonatkozik, így az egyes embereknek nincs szükség külön-külön elfogadni ezeket, mert automatikusan megtörténik.
Ezzel együtt egy kapcsolattartási email címet is szükséges megadni. Erre az email címre küldjük ki a regisztráció befejeztével a QR kódot az összes megadott személy után. Továbbá ezt az email címet használjuk fel online fizetés esetén a befizetélést igazoló blokkot és az adóügyi nyugtát vagy áfás számálát. Ez az email cím közvetlenül nem kerül felhasználásra a teszt eredményéről való tájékoztatás során (erről később a Seat Detail alatt).
Az Appointment magyar megfelelője az Foglalás (fontos, hogy az Időpont a későbbiek értelmében más dologra vonatkozik, ezért szorítkozzunk az Appointment kifejezés használatára).
Az Appointment fogja össze a tesztelésre érkező embereket.
A valóságban előfordulhat, hogy több ember csoport külön-külön regisztrál, ugyanarra a helyszínre, idősávra és rendszámra. Ebben az esetben egy autóban ülő 4 fő, adott esetben két egymástól - a rendszer szempontjából - független Appointmentből áll össze.
Az Appointment létrejötte után közvetlenül szükség van az email cím megerősítésére. Ennek során a regsztráció elején megadott, Appointmenthez tartozó email címre küldünk egy emailt, amiben található linkre kattintva a cím megerősítésre kerül. Erre a linkre egyszer lehet kattintatni, további próbálkozásoknál a megerősítés sikertelen, hiszen a link a sikeres megerősítés során deaktiválódott. Ismételten fontos, hogy ez az email cím az Appointmenthez tartozik, nem pedig az egyes Seatekhez (emberekhez). A megerősítő email újraküldése hatástalan, amennyiben az email cím már megerősítésre került.
Minden Appointment egy Locationre (helyszínre) vonatkozik.
Annak a járműnek a rendszámát kell megadni, amellyel a helyszínre érkeznek majd. A rendszám a felületen elfogad minden karaktert, azokat nagybetűssé alakítva. Ezzel a felhasználó nem ütközik kimaradó karakterekbe, pl. "-" esetén ez a karakter beíródik, nem pedig nem történik semmi. A felhasználó által megadott rendszámot tároljuk, a normalizált párjával együtt. A normalizáció során a karakterek "egyszerűsödnek", azaz Á-ból A, Ű-ből U lesz, minden betűt nagybetűvé alakítunk, és csak A-Z és 0-9 karakterek maradnak. Pl: Áb!+#$c-1 2^3 -> ABC123. Ez a formátum megfelelő a rendszámfelismerő kamerák számára egyeztetés céljából.
Amennyiben a Checkoutról jön ide vissza a felhasználó, a rendszámot kicserélni, az eredeti screentől az alábbiakban tér el:
- a helyszín ki van töltve a korábbi választással
- a helyszín disabled, azaz nem lehet módosítani
- a rendszám ki van töltve a korábbi választással
- a Seat helyett, a Checkoutra irányít a Tovább gomb megnyomása után
A Seat jelenti az adott embert, aki a tesztelésre jelentkezik. Ezek a Seat-ek az Appointmentekhez tartoznak. Elsősorban a képen látható tulajdonságokkal rendelkeznek, ezeknek a kitöltése többnyire kötelező.
A születésnap nem lehet a múltban.
A személyi szám (vagy azt helyettesítő hivatalos irat száma, pl jogosítvány vagy útlevél) a helyszínen a beléptetés során kerül majd ellenőrzésre. Ezen a rendszer semmiféle érvényességet nem ellenőriz.
Az értesítési telefonszám és email cím kerül felhasználásra a teszt eredményének tájékoztatása során.
Alapértelmezetten a Seat email címe kitöltésre kerül az Appointmenthez megadott email címre, feltételezve, hogy Appointmentenkként egy ember intézi az egész folyamatot, beleértve a tesztek eredményének kézhezkapását. A Seat telefonszámával és email címével a mi rendszerünk semmit sem kezd.
A TAJ kártyaszám megadása opcionális, mert csak beutaló esetén kötelező megadni. A TAJ mező csak számokat tartalmazhat. Amennyiben kitöltésre kerül, úgy 9 számjegyet kell tartalmaznia (/[0-9]{9}/g).
Jelenleg a beutaló funkció inaktív!
A Seat rögzítése után egy kérdőívet is ki kell tölteni, mely a rendszeren belül Survey-nek nevezünk.
A Surveyhez tartozó SurveyQuestionök (kérdések) mind adatbázisból jönnek. Azokat a kérdéseket mutatjuk csak, amik az admin felületen active-ra vannak állítva.
SurveyQuestion-öket sosem kell törölni, elég csak az is_active kapcsolót kell üresen hagyni, amennyiben egy kérdésre nincs már/még szükség
Egy kérdés lehet kötelező, vagy opcionális. Ezt az is_required mezővel lehet állítani.
A kérdéseknek 3 típusa lehet:
- string: Szöveges
- integer: Számos
- boolean: Igaz/Hamis. Ebben az esetben a válaszok a képen is látható 'toggle' formában adhatóak meg
A kérdésekre adott válaszok is külön elmentésre kerülnek SurveyAnswer néven. Ezek mind egy-egy Seathez tartoznak.
Fontos, hogy maga a Survey (Kérdőív), mint olyan nem kerül tárolásra. Egyszerűen csak Kérdések és a hozzájuk tartozó Válaszok léteznek
A Seat és a hozzátartozó Survey kitöltése után a rögzítést végző személynek lehetősége van újabb Seatek felvételére.
Amennyiben az adott Appointmenthez tartozó Seatek száma eléri a MAX_SEATS_PER_APPOINTMENT-et, úgy az új személy hozzáadása gomb disableddé válik.
Amennyiben a Seat és a Survey nem létrehozás, hanem módosítás "módban" van, ami a Checkout screenről érhető el, úgy ez a screen nem látható, hanem a Survey mentése után egyből a Checkoutra irányít vissza.
Nincs limitáció az Appointmenthez tartozó Seat-ek számára vonatkozóan.
A Time Slot (magyarul idősáv (törekedjünk idősávnak nevezni, ne időpontnak, mert az könnyen összekerhető a foglalással)) az a helyszín specifikus periódus, amikor a Seateknek meg kell érkeznie.
A Time Slot, nevéből adódóan egy periódus, nem pedig időpont. Azaz külön eleje (start) és vége (end) van.
A Time Slot az Appointmenthez tartozik.
A Time Slot helyszín specifikus, így más-más helyszín kiválasztása esetén (még a korábbi screenen) más-más Time Slotokat lát a felhasználó.
A Time Slot capacity mezője határozza meg, hogy hány Seat tartozhat hozzá.
A már elkezdődött (vagy akár be is fejeződött) vagy elég szabad kapacitással nem rendelkező Time Slotokat nem mutatjuk a legördülő menüben, ezek kiválasztása nem megengedett. Ez azt jelenti, ha valaki kiválaszt egy 5 perc múlva kezdődő Time Slotot, majd vár 6 percet, akkor hibaüzenetet fog kapni, mert a Time Slot már elkezdődött. Szintén hiba lehet, hogyha kiválaszt egy időpontot, de mire rányom a Tovább gombra, addig már más is kiválasztotta ugyanazt az Time Slotot, emiatt az már nem rendelkezik elég szabad kapcitással. Ebben az esetben is hibát mutatunk a felhasználónak és egy másik Time Slotot kell választania.
A Time Slot usage értékét megnöveljük az Appointmenthez tartozó Seatek számával. Ezt az értéket kézzel sosem módosítjuk, ezért az admin felületen le is van tiltva.
Seat törlése során a Time Slot usage-ét csökkentjük 1-gyel.
A Time Slot usage minimum értéke 0.
A rögzítést végző felhasználónak vállalnia kell, hogy a kiválasztott helyszínen és időszakban megjelenik.
A webes vásárlásokhoz hasonlóan a Checkout screen a "vásárlást" összegző oldal.
A képpel ellentétben, nem írjuk ki az egyesz személyekhez tartozó összeget.
A ceruzára kattintva az adott Seatet és a hozzátartozó SurveyAnswereket is módosítani lehet. Ebben az esetben a Survey screen Tovább gombja egyből a Checkoutra irányítja vissza a felhasználót.
A törtlésre kattintva egy már rögzített Seatet és a hozzátartozó SurveyAnswereket is töröljük. Seat törlése során a Time Slot usage-ét csökkentjük 1-gyel.
Minumum 1 Seatnek maradnia kell. Ennek megfelelően Seatek törlésére csak akkor van lehetőség, ha az adott Seat nem az utolsó Seat a hozzá tartozó Appointmentnél. Amennyiben összesen 1 Seat van, ezen a screenen a Seat törlése gomb nem elérhető.
A fizetendő összeg megállapítása ezen a screenen történik.
A legördülő listából ki lehet választani a fizetendő terméket. Ez az összes olyan Seatre vonatkozik, aki nem beutalóval érkezik. Külön termék van a helyszíni és az online fizetésre.
Jelenleg csak helyszíni fizetés létezik
Ezen az oldalon a Tovább gomb véglegesíti az Appointmentet, azaz regisztrációt.
Ennél a lépésnél állítjuk be az egyes Seat-ekhez a fizetendő terméket és annak összegét.
Ezen felül, véglegesítjük az Appointmentet, amely az is_registration_complete mezőt állítja true-ra. Ennek során küldjük ki az Appointmenthez (nem a Seatekhez egyesével) megadott email címre az összes QR kódot kép csatolmányként. A kép tartalmazza magát a QR kódot is, illetve az azt helyettesítő számsort, ami a Seatet azonosítja és adott esetben a QR kódot helyettesítheti.
Ez az oldal a felhasználónak visszajelzés arra, hogy minden rendben megtörtént. További teendője nincs.
A tovább gomb visszairányít a https://tesztallomas.hu-ra.