Uživatelská zóna (PRD-02)

info

Fundament přihlášeného uživatele — registrace, wallet, historie, sdílení. Plné znění najdete níže na této stránce.

Scope

Fáze	Obrazovek
MVP	18 (2 primární, 5 sekundárních, 11 podpůrných)
F1	1 (onboarding dotazník)
Celkem	19

Klíčové obrazovky

ID	Název	Fáze
P7	Moje vstupenky / Wallet	MVP
P9	Uživatelský účet hub	MVP
S4	Přihlášení	MVP
S5	Registrace	MVP
S7	Historie objednávek	MVP
S8	Detail vstupenky	MVP
S6	Onboarding dotazník	F1

Business rules

• OAuth first: Apple ID, Google, Facebook jako preferované metody
• Biometrika: Face ID / Touch ID nabídnuta po prvním login
• Offline wallet: QR kódy dostupné bez internetu
• Session: persistent login (30 dnů refresh token)
• GDPR: consent management, account deletion, data export

Otevřené otázky

Kód	Otázka	Priorita
OQ-02-01	Email editace po registraci	Medium
OQ-02-02	Sdílení = kopie vs. převod	High
OQ-02-03	Guest → registrace migration	High
OQ-02-04	Tablet layout	Medium
OQ-02-05	Dark mode v MVP?	High
OQ-02-06	Onboarding timing (po registraci vs. po nákupu)	Medium

---

Detailní specifikace (Plné znění PRD)

PRD-02: Klientská zóna — Colosseum MA

Verze	1.0
Datum	2026-02-23
Stav	Draft
Vlastník	Symbio — Analýza & Design

---

1. Přehled a cíle

Klientská zóna je „domov" přihlášeného uživatele v aplikaci — pokrývá registraci, přihlášení, správu účtu, offline wallet se vstupenkami, historii objednávek a sdílení vstupenek. Jde o fundament, na kterém staví personalizace (F1), věrnostní program (F1) i další rozvojové funkce.

Mobilní aplikace oproti webu přináší trvale přihlášeného uživatele s biometrickým přístupem, offline dostupnost vstupenek (QR wallet) a push notifikace — tedy výrazně silnější vztah se zákazníkem.

Cíle

Cíl	Metrika	Fáze
Maximalizovat počet registrovaných uživatelů	Registrace / MAU	MVP
Minimalizovat bariéru přihlášení	Čas do prvního přihlášení, OAuth adoption rate	MVP
Zvýšit podíl nákupů přihlášených uživatelů	Poměr logged-in vs. guest nákupů	MVP
Zajistit offline dostupnost vstupenek	% vstupenek dostupných offline	MVP
Zvýšit sdílení vstupenek	Počet sdílení per nákup	MVP

Vazba na další PRD

• PRD-01 (Nákup vstupenek): Late login v checkout flow (S4/S5 z S2). Vstupenky po nákupu v walletu (P7).
• PRD-03 (Notifikace): Permission dialog (X12) se spouští po registraci nebo z onboardingu. Nastavení notifikací přístupné z účtu (P9).
• PRD-04 (Věrnostní program): Sekce věrnost v účtu (P9 → P10). Body a odměny zobrazené v profilu.
• PRD-06 (Obsah a podpora): Podpora přístupná z účtu (P9 → S15).

---

2. User stories

MVP

ID	Role	Story	Akceptační kritéria
US-02-01	Nový uživatel	Chci se zaregistrovat rychle pomocí Apple/Google/Facebook účtu	OAuth registrace na 1–2 tapy. Po autorizaci doplnění povinných údajů (telefon, GDPR souhlas).
US-02-02	Nový uživatel	Chci se zaregistrovat pomocí emailu a hesla	Formulář: jméno, příjmení, email, telefon, heslo, GDPR souhlas, newsletter opt-in. Inline validace.
US-02-03	Registrovaný uživatel	Chci se přihlásit pomocí biometriky	Po prvním přihlášení nabídnout Face ID / Touch ID. Biometrika jako primary login metoda.
US-02-04	Registrovaný uživatel	Chci vidět své vstupenky v offline walletu	P7 zobrazuje QR vstupenky dostupné i bez připojení. Timeline: nadcházející → minulé.
US-02-05	Registrovaný uživatel	Chci sdílet vstupenku s přítelem	Detail vstupenky (S8) → „Sdílet" CTA → deep link přes systémový share sheet. Příjemce dostane odkaz ke stažení vstupenky.
US-02-06	Registrovaný uživatel	Chci vidět historii svých objednávek	S7 zobrazuje seznam objednávek se statusy (zaplaceno/rezervováno/čeká/zrušeno).
US-02-07	Registrovaný uživatel	Chci upravit své osobní údaje	S14: editace jména, kontaktů, fakturační adresy, hesla, GDPR nastavení.
US-02-08	Registrovaný uživatel	Chci smazat svůj účet	X14: potvrzovací dialog s informacemi o důsledcích (GDPR). Nevratná akce po potvrzení.
US-02-09	Nový uživatel	Chci vidět, co aplikace nabízí, při prvním spuštění	X20: 3–4 welcome slides s value propositions před přihlášením/registrací.
US-02-10	Registrovaný uživatel	Chci přidat vstupenku do systémového kalendáře	S8 → „Přidat do kalendáře" → systémový kalendář s datem, místem a časem akce (X16 potvrzení).
US-02-11	Registrovaný uživatel	Chci obnovit zapomenuté heslo	S4 → „Zapomenuté heslo" → email s reset linkem.

F1

ID	Role	Story	Akceptační kritéria
US-02-12	Nový uživatel	Chci si při registraci nastavit preference	Onboarding dotazník (S6): oblíbené žánry, lokalita, oblíbené scény/pořadatelé, notifikace permission. Skip option.
US-02-13	Registrovaný uživatel	Chci vidět sekci věrnosti v účtu	P9 rozšířen o menu položku „Colosseum Premium" → P10 (viz PRD-04).
US-02-14	Registrovaný uživatel	Chci mít přístup k watchdogům a notifikacím z účtu	P9 rozšířen o „Moje hlídače" → S10 a „Notifikace" → S9 (viz PRD-03).

F2+

ID	Role	Story	Akceptační kritéria
US-02-15	Registrovaný uživatel	Chci používat aplikaci ve svém jazyce	Vícejazyčnost — přepnutí jazyka v nastavení (scope TBD).

---

3. Funkční specifikace

3.1 MVP scope

S4 — Přihlášení

Klíčové prvky:

• OAuth first layout — Apple, Google, Facebook jako prominentní tlačítka nahoře
• Email + heslo form — pod OAuth, s „zapamatovat si mě" toggle
• Zapomenuté heslo — odkaz pod heslem → reset flow (email)
• Biometrics toggle — po prvním úspěšném přihlášení nabídnout Face ID / Touch ID
• Late login varianta — v checkout flow (z S2): zkrácená verze bez welcome textu, s „Pokračovat jako host" CTA
• Přepnutí na registraci — „Nemáte účet? Zaregistrujte se" → S5

Interakce:

• Tap OAuth → nativní autorizační dialog → úspěch / chyba
• Tap „Přihlásit se" → validace → úspěch (redirect zpět) / chyba (inline error)
• Biometrics prompt → automatický login po potvrzení

S5 — Registrace

Klíčové prvky:

• OAuth registrace — Apple, Google, Facebook (preferované)
• Email + heslo formulář:
  • Jméno + příjmení (povinné)
  • Email (povinný, validace formátu + unikátnost)
  • Telefon (povinný, validace formátu)
  • Heslo (povinné, min. 8 znaků, síla indikátor)
• GDPR souhlas — povinný checkbox s odkazem na podmínky
• Newsletter opt-in — volitelný checkbox (předvyplněný)
• CTA „Zaregistrovat se"

Business rules:

• OAuth registrace: po autorizaci doplnit chybějící povinné údaje (telefon, GDPR)
• Email musí být unikátní — pokud existuje → „Tento email je již registrován. Přihlásit se?"
• Po úspěšné registraci → redirect na předchozí screen (checkout, home) nebo X20 → onboarding (F1: S6)

P7 — Moje vstupenky / Wallet

Hlavní tab „Vstupenky" v bottom navigation.

Klíčové prvky:

• Timeline layout: nadcházející akce nahoře, minulé dole (toggle „Zobrazit minulé")
• Ticket karta: event thumbnail, název, datum + čas, místo, sedadlo (pokud adresné), QR kód preview, status badge
• Offline indikátor — zelená tečka „Dostupné offline" u každé vstupenky
• Apple/Google Wallet CTA — „Přidat do Apple Wallet" / „Přidat do Google Wallet"
• Sdílení CTA — ikona sdílení na kartě
• Empty state (X7) — pokud žádné vstupenky: ilustrace + „Zatím nemáte žádné vstupenky" + CTA „Prozkoumat akce"
• Pull-to-refresh pro synchronizaci

Interakce:

• Tap na kartu → S8 (Detail vstupenky)
• Long press → quick actions (sdílet, přidat do kalendáře)
• Offline: vstupenky dostupné i bez připojení (QR lokálně cachované)

S8 — Detail vstupenky

Plný detail jedné vstupenky.

Klíčové prvky:

• QR kód — velký, čitelný, funguje offline. Jas obrazovky automaticky zvýšen.
• Event info: název, datum + čas, pořadatel
• Venue info: název sálu, adresa
• Sedadlo: řada, číslo, kategorie (pokud adresné)
• Cenová kategorie — typ vstupného
• Akce:
  • „Sdílet vstupenku" → systémový share sheet s deep linkem (X17 potvrzení)
  • „Přidat do kalendáře" → systémový kalendář (X16 potvrzení)
  • „Přidat do Apple/Google Wallet"
• Barcode fallback — pokud QR nelze zobrazit, zobrazit čárový kód nebo číslo vstupenky

P9 — Uživatelský účet (hub)

Tab „Profil" v bottom navigation.

Klíčové prvky:

• Profilová karta — avatar (iniciály nebo fotka), jméno, email
• Menu navigace:
  • Moje objednávky → S7
  • Osobní údaje → S14
  • Změna hesla → S14 (sekce)
  • Podpora → S15
  • GDPR nastavení → inline nebo S14
  • Biometrics toggle — Face ID / Touch ID on/off
  • F1 položky (coming soon nebo skryté): Věrnostní program, Notifikace, Moje hlídače, Onboarding
• Odhlášení — CTA dole
• Smazání účtu — odkaz (červený) → X14
• App verze — v patičce

Interakce:

• Tap na menu položku → navigace na příslušnou obrazovku
• Nepřihlášený uživatel → zobrazí se „Přihlásit se / Zaregistrovat" místo profilu

S7 — Historie objednávek

Klíčové prvky:

• Status legenda: barevné badges (zaplaceno = zelená, rezervováno = žlutá, čeká na platbu = oranžová, zrušeno = červená)
• Seznam objednávek: číslo, event info, datum, status badge, celková cena
• Toggle „Zobrazit zrušené" — defaultně skryté
• Detail objednávky inline — expand na tap: jednotlivé vstupenky, platební metoda, datum platby

Empty state (X8): „Zatím nemáte žádné objednávky" + CTA „Najít akci"

S14 — Editace profilu

Klíčové prvky:

• Osobní údaje: jméno, příjmení, email (readonly?), telefon
• Fakturační adresa: volitelná, collapsible
• Změna hesla: stávající heslo + nové heslo + potvrzení
• GDPR nastavení: marketing souhlas toggle, odkaz na podmínky
• Smazání účtu: odkaz → X14
• CTA „Uložit změny" — disabled dokud nejsou změny

Interakce:

• Inline validace per field
• Úspěch → success toast „Údaje uloženy"
• Chyba → inline error messages

X7 — Empty state — Vstupenky

• Ilustrace prázdného walletu
• „Zatím nemáte žádné vstupenky"
• CTA: „Prozkoumat akce" → P1

X8 — Empty state — Objednávky

• Ilustrace
• „Zatím nemáte žádné objednávky"
• CTA: „Najít akci" → P1

X10 — Splash / Loading

• App launch screen s Colosseum logem
• Skeleton loading states pro každý tab (P1, P7, P9)
• Max 2s zobrazení splash, pak transition na obsah

X11 — Offline režim

• Indikátor — persistent banner nahoře: „Jste offline — některé funkce jsou omezené"
• Co funguje offline: wallet (P7, S8) s QR kódy, cachované detaily akcí
• Co nefunguje: nákup, search, refresh feedu, sdílení
• Auto-recovery — banner zmizí po obnovení připojení

X14 — Smazání účtu

• Potvrzovací dialog — „Opravdu chcete smazat účet?"
• GDPR info — co se stane s daty (smazání do 30 dnů)
• Důsledky: ztráta vstupenek, historie, bodů
• Dvojité potvrzení — zadání hesla nebo emailu pro potvrzení
• CTA: „Smazat účet" (červená) / „Zrušit"

X15 — GDPR souhlas

• Detail souhlasu s obchodními podmínkami
• Opt-out marketing komunikace
• Odkaz na plné podmínky (webview)
• „Souhlasím" / „Nesouhlasím" (nesouhlasím = nelze dokončit registraci)

X16 — Přidáno do kalendáře

• Toast / bottom sheet potvrzení
• „Akce přidána do kalendáře"
• Dismiss po 3s nebo tap

X17 — Vstupenka sdílena

• Toast / bottom sheet potvrzení
• „Vstupenka sdílena" + deep link preview
• Dismiss po 3s nebo tap

X19 — Force update

• Full-screen blocker (nelze obejít)
• „Je dostupná nová verze aplikace"
• Vysvětlení proč (bezpečnost, kompatibilita)
• CTA: „Aktualizovat" → App Store / Play Store
• Žádná „Přeskočit" možnost

X20 — Welcome slides

• 3–4 intro obrazovky při prvním spuštění
• Slide 1: „Vstupenky vždy po ruce" (wallet)
• Slide 2: „Nákup na pár tapů" (Apple Pay, snadný checkout)
• Slide 3: „Nenechte si nic ujít" (notifikace, personalizace)
• Slide 4 (volitelný): „Přihlaste se a začněte" (login CTA)
• Skip button na každém slidu
• Dot indicator pro pozici
• CTA na posledním: „Přihlásit se" / „Prozkoumat" (skip login)

3.2 F1 rozšíření

S6 — Onboarding (dotazník)

Zobrazuje se po registraci (nebo z účtu pro pozdější nastavení).

Klíčové prvky:

• 3–4 kroky s progress indicator:
  1. Oblíbené žánry — multi-select chips (Musical, Divadlo, Hudba, Festival, Kino, Děti, Sport…)
  2. Lokalita — výběr města/měst (Praha, Brno, Ostrava…)
  3. Oblíbené scény/pořadatelé — searchable multi-select (top pořadatelé)
  4. Notifikace — permission prompt (custom pre-prompt → systémový dialog)
• Skip option na každém kroku
• „Dokončit" CTA na posledním kroku
• Data ukládána do profilu → využívá personalizace (PRD-03)

Rozšíření P9:

• Nové menu položky: „Colosseum Premium" (→ P10), „Notifikace" (→ S9), „Moje hlídače" (→ S10)

3.3 F2+ rozšíření

• Vícejazyčnost — přepnutí jazyka v nastavení (scope závisí na počtu jazyků)
• Geolokační personalizace — automatická detekce města, preference v profilu

3.4 K diskusi

— (žádné TBD položky specifické pro klientskou zónu)

---

4. Business rules

Pravidlo	Popis
Registrace povinné údaje	Jméno, příjmení, email, telefon, GDPR souhlas. OAuth registrace: provider dodá jméno + email, doplnit telefon a GDPR.
Session management	Persistent login — uživatel zůstává přihlášen. Expirace refresh tokenu: 30 dnů (konfigurovatelné).
Biometrika	Nabídnuta po prvním úspěšném přihlášení. Uživatel může zapnout/vypnout v P9. Fallback na heslo.
Offline wallet	QR kódy vstupenek staženy a cachovány lokálně. Dostupné i bez internetu. Synchronizace při obnovení připojení.
Sdílení vstupenek	Deep link s tokenem → příjemce otevře v app (pokud má) nebo v prohlížeči. Sdílená vstupenka = kopie, ne převod (obě strany mají přístup).
Smazání účtu	GDPR compliance: žádost o smazání → data smazána do 30 dnů. Aktivní vstupenky zůstávají platné do data akce.
Force update	Vynuceno při breaking API changes. Verze kontrolována při app startu.
Guest omezení	Guest (nepřihlášený) může prohlížet a nakupovat. Nemá wallet (vstupenky na email), nemá historii, nemá personalizaci.
Apple/Google Wallet	Integrace přes PassKit (iOS) / Google Pay API (Android). Vstupenka jako boarding pass s QR, datem, místem.

---

5. Data model

Klíčové entity

Entita	Zdroj	Klíčové atributy
UserAccount	API	id, first_name, last_name, email, phone, auth_provider (email/apple/google/facebook), biometrics_enabled, created_at
UserProfile	API + lokální	avatar_url, billing_address, gdpr_consent, newsletter_opt_in, preferred_genres[], preferred_cities[], favorite_organizers[]
Ticket	API + lokální cache	id, order_id, event_date_id, seat (row, number, category), qr_code, qr_data (cached offline), status (active/used/expired/shared)
Order	API	id, user_id, items[], payment_method, status, total, created_at
Session	Lokální	access_token, refresh_token, expires_at, biometrics_key
OnboardingPreferences	API	genres[], cities[], favorite_organizers[], completed_at

Lokální stav

• Session tokens (secure storage: Keychain / Keystore)
• Cached QR kódy (encrypted local storage)
• Onboarding completion flag
• Welcome slides shown flag
• Biometrics enrollment flag

---

6. Edge cases a error states

Scénář	Řešení
OAuth provider nedostupný	Fallback na email+heslo login. Toast „Přihlášení přes [provider] momentálně nefunguje".
Duplicitní email při registraci	Inline error: „Tento email je již registrován" + CTA „Přihlásit se".
Biometrics selhání (3x)	Fallback na zadání hesla.
Expired refresh token	Tichý redirect na S4 (přihlášení) s vysvětlením „Session vypršela, přihlaste se znovu".
Force update při otevření app	X19 blocker — nelze obejít. Offline: zobrazí se při dalším spuštění s připojením.
Sdílení vstupenky — příjemce nemá app	Deep link otevře web fallback s QR kódem a CTA „Stáhnout app".
Offline + expirovaný QR	QR kód obsahuje data pro offline validaci (podepsaný payload). Expirace řešena na straně scaneru, ne v app.
Smazání účtu s aktivními vstupenkami	Warning: „Máte X aktivních vstupenek. Po smazání účtu budou stále platné, ale nebudete je moci spravovat."
Změna emailu	Ověření nového emailu přes potvrzovací link. Starý email platný do potvrzení nového.

---

7. Screen mapping

Screen ID	Název	Typ	Fáze
P7	Moje vstupenky / Wallet	Primární	MVP
P9	Uživatelský účet (hub)	Primární	MVP
S4	Přihlášení	Sekundární	MVP
S5	Registrace	Sekundární	MVP
S7	Historie objednávek	Sekundární	MVP
S8	Detail vstupenky	Sekundární	MVP
S14	Editace profilu	Sekundární	MVP
S15	Podpora / Kontakt	Sekundární	MVP
X7	Empty state — Vstupenky	Podpůrná	MVP
X8	Empty state — Objednávky	Podpůrná	MVP
X10	Splash / Loading	Podpůrná	MVP
X11	Offline režim	Podpůrná	MVP
X14	Smazání účtu	Podpůrná	MVP
X15	GDPR souhlas	Podpůrná	MVP
X16	Přidáno do kalendáře	Podpůrná	MVP
X17	Vstupenka sdílena	Podpůrná	MVP
X19	Force update	Podpůrná	MVP
X20	Welcome slides	Podpůrná	MVP
S6	Onboarding (dotazník)	Sekundární	F1

Poznámka: S15 (Podpora/Kontakt) je detailně specifikována v PRD-06. Zde zahrnuta v screen mapping protože je přístupná z P9.

---

8. Otevřené otázky

#	Otázka	Fáze	Dopad
OQ-02-01	Email editace — Může uživatel změnit email po registraci? Pokud ano, jak probíhá ověření?	MVP	Ovlivňuje S14
OQ-02-02	Sdílení = kopie vs. převod — Je sdílení vstupenky kopie (obě strany mají přístup) nebo převod (odesílatel ztrácí přístup)?	MVP	Ovlivňuje S8, X17 a business rules
OQ-02-03	Guest → registrace migration — Pokud guest nakoupí a pak se zaregistruje, propojí se jeho objednávky s novým účtem?	MVP	Ovlivňuje backend i UX flow
OQ-02-04	Tablet layout — Řešíme tablet verzi klientské zóny?	MVP	+20–30 % na adaptivní layouty
OQ-02-05	Dark mode — Je dark mode součástí MVP?	MVP	Ovlivňuje design system a validaci variant
OQ-02-06	Onboarding timing — Zobrazuje se S6 ihned po registraci, nebo až po prvním nákupu?	F1	Ovlivňuje conversion funnel