Flow: Preuzimanje kvote u mobilnoj aplikaciji (pozivnica putem emaila)

Actor

Primatelj kvote ili pod-kvote u HNS mobilnoj aplikaciji (deeplink + verifikacija emaila)

Preconditions

• Administrator je kreirao kvotu i dodijelio je na email adresu primatelja, ILI
• Nositelj parent kvote je kreirao pod-kvotu i dodijelio je na email adresu primatelja pod-kvote
• Primatelj ima valjanu email adresu
• Korisnik ima instaliranu HNS mobilnu aplikaciju ili je može preuzeti

Flow Steps

1. Email pozivnica s push notifikacijom

   • Primatelj prima email s personaliziranim detaljima alokacije (količina, sektori, utakmica, isteka)
   • Email uključuje deeplink gumb/URL za preuzimanje putem HNS aplikacije
   • Deeplink format: hnsapp://quota/claim?quota_email={recipient_email}&quota_id={quota_id}
   • Push notifikacija se šalje u HNS aplikaciju (ako je instalirana): "You have [X] tickets allocated for [Match]. Claim by [Date]"

2. Deeplink i verifikacija emaila

   • Primatelj dodirne deeplink → otvara HNS aplikaciju (ili App Store ako nije instalirana)
   • Ako je korisnik već prijavljen:
     • Aplikacija provjerava podudara li se email prijavljenog računa s quota emailom (iz deeplink parametra)
     • Ako se emailovi podudaraju: nastavlja na korak 3 (Quota Dashboard)
     • Ako se emailovi ne podudaraju:
       • Aplikacija prikazuje obavijest: "This quota is assigned to [quota_email]. Please login with the correct account to access your quota allocation."
       • Ponuđene opcije: "Login with Different Account" ili "Cancel"
       • Ako je odabrano "Login with Different Account": korisnik se odjavljuje i preusmjerava na ekran prijave s unaprijed ispunjenim quota_email
   • Ako korisnik nije prijavljen:
     • Aplikacija prikazuje ekran za prijavu/registraciju
     • Polje emaila je unaprijed ispunjeno s quota_email iz deeplinka
     • Korisnik može:
       • Prijaviti se s quota_email ako račun već postoji
       • Kreirati novi račun s quota_email ako je korisnik prvi put
     • Nakon uspješne prijave/registracije, nastavlja na korak 3 (Quota Dashboard)

3. Quota Dashboard

   • Prikazuje brojače Allocated | Claimed | Available i banner s odbrojavanjem do roka
   • Prikazuje sektore, algoritam alokacije (NM ili REDOM), informacije o popustu/cijeni i datum isteka
   • CTA: "Claim Tickets" (onemogućen kada odbrojavanje istekne)
   • Ako je can_create_subquotas = TRUE: oznaka/indikator o mogućnosti delegiranja i link na web portal

4. Pregled dodijeljenih ulaznica (Korak 1 od 3)

   • Sjedala su unaprijed dodijeljena prilikom kreiranja kvote odabranim algoritmom:
     • NM (najbolja mjesta): Najbolja dostupna mjesta u dodijeljenim sektorima
     • REDOM (raspoređeno): Sjedala raspoređena po sektoru
   • Za numerirane utakmice:
     • Sustav prikazuje dodijeljene ulaznice kao kartice u grid rasporedu
     • Svaka kartica ulaznice prikazuje: sektor, red i broj sjedala (npr. "Sektor D1, Red 5, Sjedalo 8")
     • Korisnik dodiruje kartice za odabir ulaznica koje želi preuzeti
     • Odabrane kartice su vizualno istaknute
   • Za nenumerirane utakmice: Korisnik odabire samo količinu
   • Korisnik klikne "Nastavi na podatke o ulaznicama"

5. Unos identiteta po ulaznici

   • Važna obavijest:

     • Sustav prikazuje banner: "Email Required: Each ticket will be delivered to the HNS mobile app linked to the email address you provide. All tickets with the same email must enter the stadium together on the same device."
     • Dodatna napomena: "If someone doesn't have a mobile phone or email address, use the email of the person who will accompany them and have both tickets on the same device."

   • Za svaku ulaznicu korisnik može:

     • Odabrati iz spremljenih profila: odabir prethodno spremljenih profila (obitelj, prijatelji)
     • Unijeti nove podatke: ručno unosi ime, datum rođenja, nacionalnost, OIB (za Hrvate) ili putovnicu (za strance), email, telefon

   • Opcija spremanja novih podataka kao profila za buduće kupnje

   • Opcije polja za email:

     • Opcija A – unos emaila odmah (zadano, preporučeno):
       • Polje email adrese je vidljivo
       • Zadano je email unaprijed ispunjen s emailom nositelja kvote
       • Sustav validira format emaila
       • Sustav dopušta isti email za više ulaznica uz upozorenje: "These tickets will be on the same device and must enter together"
       • Nositelj kvote može dodijeliti ili promijeniti email za bilo koju ulaznicu prije utakmice kako bi ulaznica bila dostupna primatelju

   • Validacija u realnom vremenu: provjere formata, obvezna polja, provjera OIB kontrolne znamenke

   • Provjera blacklist u realnom vremenu prema HNS sigurnosnoj bazi za sve osobe (svi odabrani profili)
   • Indikator napretka prikazuje status (npr. "2 od 5 ulaznica dovršeno")

6. Plaćanje i checkout

   • Ako kvota ima popust: prikaz izvorne cijene, primijenjenog popusta i konačne cijene
   • Ako je kvota besplatna (discount_code = GR): preskače se plaćanje i ide se izravno na potvrdu
   • Ako je potrebno plaćanje: integracija s payment gateway-em uz primjenu popusta
   • Ekran zahvale nakon uspješnog plaćanja
   • PDF račun generira e-racuni.com i vidljiv je u mobilnoj aplikaciji, a prima se i putem e-pošte

7. Potvrda i izdavanje

   • Korisnik potvrđuje preuzimanje; narudžba se kreira/finalizira
   • Ulaznice se odmah isporučuju u in-app wallet s rotirajućim QR kodovima
   • Ekran potvrde s detaljima utakmice, brojevima sjedala i pristupom QR kodovima
   • Potvrdni email (receipt) se šalje s detaljima ulaznica

8. Radnje nakon preuzimanja

   • Ako je dio dodijeljenih ulaznica i dalje nepreuzet, aplikacija prikazuje trajni banner s odbrojavanjem
   • Ako je can_create_subquotas = TRUE:, korisnik prima link za pristup web portalu putem emaila za delegiranje pod-kvota

Alternative Flows

A3: Odbijanje zbog blackliste

• Tijekom unosa identiteta (korak 5), sustav detektira osobu na blacklisti
• Aplikacija prikazuje: "Identity verification failed. Unable to complete ticket claim."
• Konkretna ulaznica(e) s identitetom na blacklisti ne može biti preuzeta
• Korisnik može dovršiti unos identiteta za preostale ulaznice (ako preuzima više)
• Odbijene ulaznice se vraćaju u dostupni saldo nositelja kvote
• Prikazuju se kontakt podaci korisničke podrške za žalbeni proces

A4: Neuspješno plaćanje

• Tijekom plaćanja (korak 6), payment gateway vraća grešku (odbijena kartica, nedovoljno sredstava, itd.)
• Aplikacija prikazuje poruku o grešci plaćanja s razlogom
• Korisnik može pokušati ponovno s drugom metodom plaćanja

A5: Rok je prošao

• Nepreuzete ulaznice se automatski oslobađaju u trenutku isteka
• Aplikacija prikazuje stanje "Expired" s porukom objašnjenja
• Nakon toga više nije moguće preuzimanje za ovu alokaciju
• Ako je napravljeno djelomično preuzimanje, prethodno preuzete ulaznice ostaju važeće

A6: Djelomično preuzimanje

• Korisnik preuzima samo dio ulaznica sada (npr. 2 od 5)
• Preostali dio alokacije ostaje dostupan u quota dashboardu
• Može se vratiti kasnije i preuzeti ostatak prije roka
• Svako djelomično preuzimanje slijedi puni flow: unos identiteta → plaćanje → izdavanje ulaznica
• Dashboard se ažurira: "Claimed: 2 | Available: 3 | Allocated: 5"

A7: Workflow za nositelja pod-kvota

• Ako nositelj kvote ima can_create_subquotas = TRUE
• Prima email s linkom za pristup web portalu
• Otvara web portal na desktopu i kreira pod-kvote
• Web portal se autentificira istim vjerodajnicama kao korisnički račun u HNS mobilnoj aplikaciji
• Korisnik koristi portal: vidi Quota Holder Web Delegation
• Primatelji pod-kvota dobivaju email pozivnicu
• Primatelji pod-kvota preuzimaju putem HNS mobilne aplikacije koristeći ovaj isti flow
• Parent može pratiti status pod-kvota i povući nepreuzete pod-kvote putem web portala

---