Flow: Ulaznice za gostujuće utakmice (nenumerirana mjesta)¶

Actor¶

Navijač koji kupuje ulaznice za gostujuću utakmicu hrvatske reprezentacije; Admin koji upravlja alokacijom ulaznica za gostujuću utakmicu

Preconditions¶

Gostujuća utakmica je zakazana na stranom stadionu (npr. Gibraltar, druge UEFA države)
Hrvatski nogometni savez dobio je alokaciju/kvotu ulaznica od domaćina
Domaćin još nije dostavio točne sektore/sjedala
Ulaznice se moraju prodati unaprijed kako bi se osigurala alokacija za hrvatske navijače
Sustav je konfiguriran za prodaju nenumeriranih mjesta za konkretnu utakmicu
Admin može alocirati kvote sponzorima/partnerima za prisustvo na gostujućoj utakmici

Gostujući stadion (external) - definicija¶

Za gostujuće utakmice, stadion/venue se tretira kao external venue zapis.
U trenutku kreiranja utakmice venue tipično nema seat map (nema konfiguriranih sektora/zona/sjedala u HNS sustavu).
Inventar za prodaju se definira prema alokaciji dobivenoj od domaćina (a ne prema kapacitetu stadiona).
Podaci o sektorima i/ili sjedalicama mogu stići kasnije od domaćina i tada se primjenjuju na već prodane ulaznice.

Flow Steps¶

Part 1: Početna prodaja ulaznica (nenumerirana mjesta)¶

Konfiguracija utakmice od strane admina
- Admin kreira utakmicu koristeći Flow: Upravljanje utakmicom (Admin)
- U obrascu utakmice Admin odabire gostujući stadion (external) (bez seat map-a u trenutku kreiranja)
- Admin konfigurira prodaju za gostujuću utakmicu:
  - Checkbox: Non-numbered seats (away match)
  - Ukupna količina hrvatske alokacije: npr. 500 ulaznica
  - Tip ulaznice: General admission
  - Sektori: TBD (domaćin dostavlja kasnije)
- Postavlja cjenovni razred
- Otvara ulaznice za javnu prodaju
- Sustav kreira inventar veličine alokacije s lokacijom sjedala postavljenom na TBD / pending assignment
Tok kupnje za korisnika - mobilna aplikacija
- Isti kao standardni tok kupnje

Part 1B: Alokacija kvota za gostujuće utakmice (paralelno s javnom prodajom)¶

Admin kreira kvotu za gostujuću utakmicu
- Admin se prijavljuje u admin portal
- Otvara Quota Management
- Klikne "Create New Quota"
- Odabire utakmicu: "Gibraltar vs Croatia" (away match)
- Konfigurira detalje kvote:
  - Quota Owner: npr. "Hrvatski Telekom" (sponsor), "HNS Officials", "Media Partners"
  - Quantity: broj alociranih ulaznica (npr. 20 ulaznica)
  - Type: Non-numbered (automatski za away matches)
  - Sectors: TBD (isto kao javna prodaja)
  - Pricing: Free (gratis), discounted ili full price
  - Deadline: datum do kojeg se kvota mora preuzeti (npr. 7 dana prije zatvaranja prodaje)
  - Payment terms: Immediate ili deferred
- Sustav kreira alokaciju kvote bez konkretnih dodjela sjedala
Proces preuzimanja kvote (nenumerirana mjesta)
- Nositelj kvote klikne "Claim Tickets"
- Odabire količinu za preuzimanje (do 20 dostupnih)
- Nema sučelja za odabir sjedala (isto kao javna prodaja)
- Za svaku ulaznicu unosi podatke o osobi:
  - Ime i prezime
  - Datum rođenja
  - Državljanstvo
  - OIB
  - E-mail adresa
  - Broj telefona
  - Broj putovnice (za međunarodna putovanja)
- Potvrđuje narudžbu
- Sustav obrađuje preuzimanje kvote:
  - Kreira se narudžba sa statusom: "Quota - Pending seat assignment"
  - Dodjeljuje se sekvencijalni broj narudžbe (odvojeno od javne prodaje u početku)
  - Ažurira se stanje kvote (npr. 20 allocated → 15 claimed → 5 remaining)
- Šalje se potvrda e-mailom sa:
  - Brojem narudžbe
  - Detaljima utakmice
  - Brojem preuzetih ulaznica
  - Napomenom: "Seat assignments will be provided closer to match date"
Praćenje kvota u odnosu na javnu prodaju
- Sustav održava dva skupa narudžbi:
  - Quota Orders: narudžbe iz kvota
  - Public Orders: standardne kupnje
- Oba se prate kroz:
  - Order ID
  - Timestamp kupnje/preuzimanja
  - Količinu
  - Podatke o osobama
  - Status: Pending seat assignment
- Quota narudžbe mogu imati prioritet u dodjeli sjedala (konfigurira admin)
Provedba roka (deadline) za kvotu
- Ako kvota nije u potpunosti preuzeta do roka:
  - Sustav označava nepreuzete ulaznice kao istekle
  - Nepreuzete ulaznice vraćaju se u javni inventar (ali nisu automatski u prodaji; ručno)
- Preuzete kvota ulaznice nastavljaju u proces dodjele sjedala

Part 2: Zatvaranje prodaje i usklađivanje inventara¶

Zatvaranje prodajnog perioda
- Admin prati prodaju
- Prodaja završava (tipično 1-2 tjedna prije utakmice):
  - Ručno zatvaranje od strane admina ili
  - Automatsko zatvaranje na deadline
- Sustav generira sažetak prodaje:
  - Public Sales Orders: 150 narudžbi, 435 ulaznica
  - Quota Orders: 17 narudžbi, 50 ulaznica (iz 3 kvote)
  - Total orders: 167
  - Total tickets sold: 485
  - Remaining allocation: 15 (unsold)
- Sustav zaključava narudžbe (nove kupnje/preuzimanja kvota nisu dopuštena)
Komunikacija s domaćinom
- Admin izvozi finalnu listu putnika/posjetitelja:
  - Ukupan broj ulaznica
  - Podaci o osobama (imena, brojevi putovnica, državljanstva)
- Admin šalje listu domaćinu/savez-u
- Čeka dodjelu sektora od domaćina
- Timeline: 3-10 dana prije utakmice
Zaprimanje dodjele sektora od domaćina
- Domaćin potvrđuje sektore za hrvatske navijače
- Detalji dodjele mogu biti na različitim razinama:
  - Samo sektor (često): npr. "Away Stand Block C" (bez redova/sjedala)
  - Sektor + raspon redova/sjedala (najbolji slučaj): npr. Rows 1-15, Seats 1-35 po redu
- Primjer dodjele (sektor + raspon redova/sjedala):
  - Section: Away Stand Block C
  - Rows: 1-15
  - Seats: 1-35 po redu (ukupno: 525 mjesta)
- Admin dobiva mapu/plan sektora
- Admin provjerava da kapacitet pokriva prodane ulaznice (485 ≤ 525 ✓)

Part 3: Dodjela sektora / sjedala (opcionalno)¶

Ako domaćin dostavi samo sektor, ulaznice se finaliziraju kao general admission unutar dodijeljenog sektora (Row/Seat ostaju prazni) i proces se nastavlja na Part 4.

Ako domaćin dostavi raspone redova/sjedala, Admin može pokrenuti korake numeracije i dodjele ispod.

Admin učitava informacije o sektorima
- Admin se prijavljuje u admin portal
- Otvara utakmicu: "Gibraltar vs Croatia"
- Klikne "Assign Seats to Non-Numbered Orders"
- Sustav prikazuje:
  - Total orders awaiting assignment: 167
  - Total tickets awaiting assignment: 485
  - Available sectors: Away Stand Block C, Rows 1-15
- Admin potvrđuje da je kapacitet dovoljan
Konfiguracija algoritma numeracije
- Admin odabire metodu dodjele:
  - Sequential by Order Priority (preporučeno)
  - Random assignment
  - Manual assignment
- Za sekvencijalnu metodu:
  - Admin postavlja prioritet narudžbi:
    - Option 1: prvo quota narudžbe, zatim public (prioritet sponzorima/partnerima)
    - Option 2: ujedinjeni kronološki red (quota i public zajedno po timestampu)
  - Admin postavlja početnu poziciju: Row 1, Seat 1
  - Primjer: Row 1 Seats 1-35, zatim Row 2 Seats 1-35, itd.
- Admin vidi preview logike:
  - Ako "Quota first": 17 quota narudžbi (50 ulaznica) → 150 public narudžbi (435 ulaznica)
  - Ako "Unified": svih 167 narudžbi sortirano po timestampu

Izvršenje automatske dodjele sjedala

Admin klikne "Execute Seat Assignment"
Primjer: odabran prioritet "Quota orders first"
Sustav obrađuje narudžbe po konfiguriranom redoslijedu:

Phase 1: Quota Orders (17 orders, 50 tickets)

- **Quota Order #1** - Hrvatski Telekom (4 tickets, claimed 09:30:00):
    - Assigned: Row 1, Seats 1-4
- **Quota Order #2** - HNS Officials (3 tickets, claimed 09:45:12):
    - Assigned: Row 1, Seats 5-7
- **Quota Order #3** - Media Partners (2 tickets, claimed 10:02:33):
    - Assigned: Row 1, Seats 8-9
- ... nastavlja kroz svih 17 quota narudžbi
- **Quota Order #17** - Sponsor VIP (3 tickets, claimed last):
    - Assigned: Row 2, Seats 13-15
- **Quota phase complete**: 50 ulaznica dodijeljeno (Rows 1-2, do Seat 15)

Phase 2: Public Orders (150 orders, 435 tickets)

- **Public Order #1** (3 tickets, purchased 10:05:23):
    - Assigned: Row 2, Seats 16-18
- **Public Order #2** (2 tickets, purchased 10:07:45):
    - Assigned: Row 2, Seats 19-20
- **Public Order #3** (4 tickets, purchased 10:08:12):
    - Assigned: Row 2, Seats 21-24
- ... nastavlja kroz svih 150 public narudžbi
- **Public Order #150** (1 ticket, purchased last):
    - Assigned: Row 14, Seat 15

Sustav osigurava:
- Da su ulaznice iste narudžbe susjedne
- Da je prioritetni redoslijed poštovan (quota pa public po timestampu)
- Nema rupa ni preklapanja
- Quota narudžbe dobivaju najbolja preostala mjesta (prednji redovi)

Admin pregled i potvrda
- Sustav prikazuje sažetak dodjele:
  - Quota Orders: 17 narudžbi, 50 ulaznica (Rows 1-2, Seats 1-15)
  - Public Orders: 150 narudžbi, 435 ulaznica (od Row 2 Seat 16 nadalje)
  - Total orders assigned: 167
  - Total tickets assigned: 485
  - Sector: Away Stand Block C
  - Rows used: 1-14
  - Remaining unassigned seats in allocation: 40
- Admin provjerava nekoliko uzoraka:
  - Quota Order #1 (Hrvatski Telekom): Row 1, Seats 1-4 ✓
  - Quota Order #17: Row 2, Seats 13-15 ✓
  - Public Order #1: Row 2, Seats 16-18 ✓
  - Public Order #150: Row 14, Seat 15 ✓
- Admin potvrđuje da je dodjela ispravna
- Admin klikne "Finalize and Publish Seat Assignments"
Sustav ažurira narudžbe i ulaznice
- Sustav mijenja sve narudžbe iz "Pending seat assignment" u "Confirmed"
- Sustav generira digitalne ulaznice sa sektorom i (ako je dostupno) mjestima:
  - Event: Gibraltar vs Croatia
  - Venue: Victoria Stadium, Gibraltar
  - Sector: Away Stand Block C
  - Row: [assigned ako je dostupno]
  - Seat: [assigned ako je dostupno]
  - QR code: [unique per ticket]
- Sustav povezuje ulaznice s korisničkim računima u HNS mobilnoj aplikaciji
- Ulaznice su spremne za isporuku

Part 4: Obavijesti korisnicima i isporuka ulaznica¶

Automatska e-mail obavijest
- Sustav šalje e-mail kampanju za svih 167 narudžbi
- Sadržaj e-maila:
  - Subject: "Your Croatia Away Match Tickets - Details Confirmed!"
  - Broj narudžbe i detalji utakmice
  - Detalji ulaznica sada su dostupni:
    - Sector: Away Stand Block C
    - Row/seat brojevi (ako ih je dostavio domaćin)
  - Upute za pristup ulaznicama u HNS mobilnoj aplikaciji
  - Važne putne informacije:
    - Datum i vrijeme utakmice
    - Adresa stadiona
    - Uvjeti ulaska (putovnica, ulaznica)
    - Meeting point za gostujuće navijače (ako je primjenjivo)
  - Kontakt korisničke podrške
- E-mail uključuje PDF ulaznice u privitku (backup)
Push obavijest u mobilnoj aplikaciji
- Sustav šalje push obavijest svim korisnicima:
  - "Your tickets for Gibraltar vs Croatia are ready!"
- Obavijest vodi (deeplink) na "My Tickets" u aplikaciji
Korisnik pregledava dodijeljene ulaznice
- Navijač otvara HNS mobilnu aplikaciju
- Otvara "My Tickets"
- Odabire narudžbu "Gibraltar vs Croatia"
- Prikazuju se detalji ulaznica:
  - QR kod (dinamički/rotirajući)
  - Informacije o utakmici
  - Sector: Away Stand Block C
  - Row: 1 (ako je dostupno)
  - Seats: 1, 2, 3 (ako je dostupno; za narudžbu s 3 ulaznice)
  - Barcode za skeniranje
- Navijač može dodati ulaznice u Apple Wallet / Google Pay
- Navijač je spreman za put i prisustvo utakmici

Alternative Flows¶

A6: Nositelj kvote traži promjenu mjesta nakon dodjele

Nositelj kvote (npr. kontakt sponzora) šalje e-mail adminu
Zahtjev: "Can our 4 tickets be moved to better seats?" ili "Can we sit with another group?"
NEED TO CHECK IF THIS IS POSSIBLE

Post-Flow Actions¶

Koordinacija na dan utakmice:

Admin dostavlja finalnu listu posjetitelja sigurnosti domaćina
Sustav validacije ulaznica sinkronizira se s kontrolom ulaza domaćeg stadiona
QR kodovi se validiraju na ulazu

Last Updated: January 2026