SportBuddy/USER_STORIES.md

# SportBuddy - User Stories

---

## US-001: Registrácia a prihlásenie

**Status:** ✅ HOTOVÉ

Ako nový používateľ
chcem sa zaregistrovať a prihlásiť
aby som mohol používať aplikáciu

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ Setup Next.js projekt + Tailwind + BetterAuth
- ✅ PostgreSQL databáza
- ✅ Prisma schema: User model
- ✅ BetterAuth konfigurácia (credentials provider)
- ✅ Registračný formulár (/register)
- ✅ Prihlasovací formulár (/login)
- ✅ Validácia (email formát, heslo min 8 znakov)
- ✅ Hash hesla (scrypt via Better Auth)
- ✅ Session management (localStorage)
- ✅ Responzívny dizajn formulárov
- ✅ Podmienené zobrazenie "Vytvoriť účet" button (skrytie pre prihlásených) - Jozef Kovalčín

### Výsledné funkcie:
- ✅ Fungujúca registrácia
- ✅ Fungujúce prihlásenie
- ✅ Session persistence
- ✅ Redirect na /dashboard po prihlásení
- ✅ Homepage nezobrazuje CTA button pre prihlásených používateľov

---

## US-002: Používateľský profil & Dashboard

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem vidieť a upraviť môj profil a dashboard s mojimi aktivitami
aby som mohol prezentovať svoje športové záujmy a mať prehľad o mojich udalostiach

**Vývojár:** Jozef Kovalčín

### Tasky:
#### Profil sekcia
- ✅ Profil stránka (/profile) 
- ✅ Zobrazenie: meno, email, mesto, bio, obľúbené športy
- ✅ Formulár na editáciu profilu (/profile/edit)
- ✅ Upload profilovej fotky
- ✅ API: GET /api/profile
- ✅ API: PUT /api/profile
- ✅ Validácia formulára
- ✅ Responzívny dizajn

#### Dashboard sekcia
- ✅ Dashboard stránka (/dashboard)
- ✅ API: GET /api/activities/my (filtrovanie podľa userId)
- ✅ Dve sekcie: "Moje aktivity" (vytvorené) a "Prihlásený na" (joined)
- ✅ Používanie Activity card komponentu
- ✅ Loading state
- ✅ Empty states
- ✅ Quick actions: "Vytvoriť aktivitu", "Hľadať aktivity"
- ✅ Štatistiky: počet aktivít, počet prihlásení
- ✅ Responzívny layout

### Výsledné funkcie:
- ✅ Zobrazenie profilu
- ✅ Editácia profilu
- ✅ Upload fotky
- ✅ Dashboard so zoznamom
- ✅ Filtrovanie funguje
- ✅ Štatistiky sa zobrazujú

**Poznámka:** Profil model existuje v databáze (User + Profile), ale žiadne UI stránky nie sú implementované. Dashboard stránka existuje s navigáciou a základnou štruktúrou (3 štatistické karty), ale neobsahuje žiadne reálne dáta ani zoznam aktivít.

---

## US-003: Vytvorenie aktivity

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem vytvoriť novú športovú aktivitu
aby som našiel spoluhráčov

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ Prisma schema: Activity model
- ✅ API: POST /api/activities
- ✅ Automatické pridanie tvorcu ako účastníka
- ✅ Validácia (dátum v budúcnosti, cena >= 0)
- ✅ Formulár na vytvorenie (/activities/create)
- ✅ Polia: názov, šport (dropdown), dátum, čas, miesto, max hráčov, úroveň, cena, popis
- ✅ React Hook Form + Zod validácia
- ✅ Loading state pri submit
- ✅ Redirect na detail po vytvorení
- ✅ Responzívny formulár
- ✅ Google Maps LocationPicker pre výber adresy - Jozef Kovalčín
- ✅ Automatické uloženie GPS súradníc a názvu miesta - Jozef Kovalčín
- ✅ Rozšírenie formulára o filter polia (pohlavie, min vek, max vek, cena) - Jozef Kovalčín
- ✅ Custom input tlačidlá s +/- tlačidlami - Jozef Kovalčín
- ✅ Pravidelne opakované aktivity (DAILY, WEEKLY, MONTHLY) - Jozef Kovalčín
- ✅ Výber dní v týždni pre týždenné opakovanie - Jozef Kovalčín
- ✅ Dátum ukončenia opakovania (voliteľný, default 2 mesiace) - Jozef Kovalčín
- ✅ Automatické generovanie budúcich inštancií pri vytvorení (max 20 inštancií alebo 2 mesiace) - Jozef Kovalčín
- ✅ Auto-join na všetky inštancie s možnosťou zadať počet hostí - Jozef Kovalčín
- ✅ Parent-child vzťah medzi opakovanými aktivitami - Jozef Kovalčín

### Výsledné funkcie:
- ✅ API endpoint funguje
- ✅ Funkčná validácia na BE
- ✅ Aktivita sa uloží do DB
- ✅ Frontend formulár implementovaný a funkčný
- ✅ Automatické načítanie venues
- ✅ Validácia na FE a BE
- ✅ Google Maps autocomplete pre adresu
- ✅ Uloženie lokácie, GPS súradníc a názvu miesta
- ✅ Všetky US-012 filter polia v create forme
- ✅ Pravidelné opakovanie aktivít (denné, týždenné, mesačné)
- ✅ UI pre výber dní v týždni
- ✅ Automatické vytváranie budúcich aktivít (max 20 inštancií alebo 2 mesiace)
- ✅ Auto-join pre organizátora na všetky inštancie s počtom hostí
- ✅ Parent-child vzťah s badge "Opakovaná" na kartách aktivít
- ✅ Sekcia "Nadchádzajúce termíny" na detail stránke (collapsible)
- ✅ Smart delete logic - pri zmazaní parent sa prvá child aktivita stane novým parentom

---

## US-004: Zoznam a detail aktivít

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem vidieť zoznam aktivít a ich detail
aby som vedel, čo je k dispozícii

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ API: GET /api/activities (pagination 20/page)
- ✅ API: GET /api/activities/[id]
- ✅ Filtrovanie podľa športu, mesta, statusu
- ✅ Stránka zoznamu (/activities)
- ✅ Card komponenta pre aktivitu
- ✅ Zobrazenie: názov, šport, dátum, čas, miesto, voľné miesta
- ✅ Loading skeleton
- ✅ Empty state ("Žiadne aktivity")
- ✅ Detail stránka (/activities/[id])
- ✅ Kompletné info + mapa (Google Maps embed)
- ✅ Zoznam účastníkov
- ✅ Progress bar obsadenosti
- ✅ Responzívny grid/detail
- ✅ Zobrazenie všetkých US-012 filter polí  - Jozef Kovalčín
- ✅ Google Maps iframe s názvom miesta - Jozef Kovalčín
- ✅ "Otvoriť v Mapách" tlačidlo s deep linking - Jozef Kovalčín

### Výsledné funkcie:
- ✅ API endpoints fungujú
- ✅ Zoznam aktivít (UI) s kartami
- ✅ Detail aktivity s kompletnou informáciou
- ✅ Mapa športoviska s názvom lokality
- ✅ Progress bar a zoznam účastníkov
- ✅ Loading states a empty states
- ✅ Zobrazenie pohlavia, vekového rozpätia a ceny
- ✅ Deep linking do Google Maps/Apple Maps

---

## US-005: Prihlasovanie na aktivity

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem sa prihlásiť na aktivitu
aby som rezervoval miesto

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ Prisma schema: Booking model (many-to-many User-Activity)
- ✅ API: POST /api/activities/[id]/join
- ✅ Kontrola voľnej kapacity
- ✅ Kontrola duplicity (už prihlásený)
- ✅ Aktualizácia počtu hráčov
- ✅ Tlačidlo "Prihlásiť sa" na detaile
- ✅ Tlačidlo "Odhlásiť sa" ak som prihlásený
- ✅ API: DELETE /api/activities/[id]/join
- ✅ Optimistic updates (TanStack Query)
- ✅ Toast notifikácie
- ✅ Badge "Prihlásený" na karte aktivity

### Výsledné funkcie:
- ✅ Prihlásenie funguje (API + UI)
- ✅ Odhlásenie funguje (API + UI)
- ✅ Počet hráčov sa aktualizuje
- ✅ UI komponenty implementované
- ✅ Automatický refresh dát po akcii
- ✅ Vizuálna indikácia stavu (organizátor/účastník)

---

## US-006: Vyhľadávanie aktivít

**Status:** 🔄 WIP (Work In Progress)

Ako používateľ
chcem vyhľadávať aktivity
aby som rýchlo našiel, čo ma zaujíma

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ API: GET /api/activities?search=... (full-text cez názov, popis)
- ✅ Prisma search
- ⏸️ Search bar
- ⏸️ Search input na /activities
- ⏸️ Loading spinner pri searchi
- ⏸️ Highlighting výsledkov (optional)
- ⏸️ Clear search button
- ⏸️ "Žiadne výsledky" state
- ⏸️ Query params v URL (?search=futbal)

### Výsledné funkcie:
- ✅ Vyhľadávanie funguje (API)
- ⏸️ Real-time výsledky (UI)
- ⏸️ URL synchronizácia

**Poznámka:** API podporuje search, ale UI komponenty nie sú implementované.

---

## US-007: Základný UI/UX

**Status:** 🔄 WIP (Work In Progress)

Ako používateľ
chcem pekné a funkčné rozhranie
aby som mal dobrý zážitok

**Vývojár:** Všetci spoločne

### Tasky:
- ✅ Responzívny dizajn (mobile/tablet/desktop)
- ✅ Header s navigáciou (logo, links, user menu)
- ✅ Footer (copyright, links)
- ✅ Dark mode toggle
- ⏸️ Loading states všade (skeleton, spinner)
- ⏸️ Notifikácie (react-hot-toast)
- ⏸️ Error states a error boundaries
- ⏸️ 404 stránka
- ✅ Konzistencia písma a farebných schém
- ✅ Tailwind configurácia
- ✅ Mobilné menu (hamburger)

### Výsledné funkcie:
- ✅ Responzívny dizajn
- ✅ Konzistentný UI
- ⏸️ Loading/Error states

**Poznámka:** Základný design a theme switching je hotový, ale chýbajú loading states, error handling a notifikácie.

---
## US-008: OAuth prihlásenie

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem sa prihlásiť pomocou Google, Facebook alebo iných platforiem
aby som nemusel vytvárať nové heslo a prihlásenie bolo rýchlejšie

<<<<<<< HEAD
**Vývojár:** - Jozef Kovalčín
=======
**Vývojár:** Jozef Kovalčín
>>>>>>> ad142ec (feat: recurring activities, my activities page, map view with markers)

### Tasky:
- ✅ BetterAuth konfigurácia OAuth providers (Google, Facebook, Apple)
- ✅ Google OAuth setup (Client ID, Secret)
- ✅ Facebook OAuth setup (App ID, Secret)
- ✅ Apple OAuth setup (Client ID, Secret)
- ✅ Prisma schema: rozšírenie Account modelu (accessTokenExpiresAt, refreshTokenExpiresAt, scope)
- ✅ Account linking konfigurácia (trustedProviders)
- ✅ API: OAuth callback handling (redirect na frontend URL)
- ✅ Error page redirect (na frontend signin page)
- ✅ Tlačidlá "Prihlásiť cez Google/Facebook" na login/register stránke
- ✅ OAuth callback URLs (/api/auth/callback/google, /facebook)
- ✅ Mapovanie OAuth dát na User profil (email, meno, avatar)
- ✅ Session management pre OAuth users
- ✅ Responzívne OAuth tlačidlá
- ⏸️ Handling existujúceho účtu (merge alebo error) - funkčné s account linking

### Výsledné funkcie:
- ✅ Google login funguje
- ✅ Facebook login funguje (vyžaduje konfiguráciu Facebook Developer App)
- ✅ Apple login funguje (vyžaduje konfiguráciu Apple Developer Account)
- ✅ Automatické vytvorenie profilu
- ✅ Account linking medzi providers (trusted: Google, Facebook, Apple)


---

## US-009: Mapa s lokalitami aktivít

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem vidieť polohu aktivít na Google Maps
aby som vedel, kde sa aktivita koná a ako ďaleko to mám

**Vývojár:** Jozef Kovalčín

### Tasky:
- ✅ Google Maps API setup (API key)
- ✅ Prisma schema: pridať lat/lng do Activity modelu
- ✅ Prisma schema: location, locationName
- ✅ LocationPicker komponenta s Google Maps Autocomplete
- ✅ Geocoding pri vytváraní aktivity (adresa → súradnice)
- ✅ API: GET /api/activities s lat/lng dátami
- ✅ React komponenta: LocationPicker s Google Maps autocomplete SDK
- ✅ Mapa na detail stránke (/activities/[id]) s iframe embed
- ✅ Mapa zobrazuje názov miesta namiesto GPS súradníc
- ✅ Tlačidlo "Otvoriť v Mapách" s deep linking
- ✅ Responzívna mapa (mobile/desktop)
- ✅ Custom styling pre autocomplete dropdown
- ✅ Stránka /venues s full-screen mapou (premenovaná na "Mapa aktivít")
- ✅ Google Maps integrácia (useLoadScript hook namiesto LoadScript)
- ✅ Markery pre všetky open aktivity na mape
- ✅ Custom marker ikony pre každý šport (emoji SVG)
- ✅ User location marker (modrý kruh SVG)
- ✅ Centrovanie mapy na user location (geolocation API)
- ✅ InfoWindow pri kliknutí na marker
- ✅ InfoWindow s inline styling (fix pre white background)
- ✅ InfoWindow zobrazuje: názov, šport, dátum, čas, účastníci, lokácia, cena
- ✅ "Zobraziť detail" button v InfoWindow s linkom na aktivitu
- ✅ Legenda s vysvetlením markerov (user location + športy)
- ⏸️ Prepínanie medzi zoznam view a mapa view na /activities

### Výsledné funkcie:
- ✅ Google Maps autocomplete pri vytváraní aktivity
- ✅ Automatické uloženie GPS súradníc
- ✅ Mapa na detaile aktivity s názvom miesta
- ✅ "Otvoriť v Mapách" button (funguje na PC aj mobile)
- ✅ Deep linking do Google Maps/Apple Maps
- ✅ Custom styled autocomplete dropdown
- ✅ Full-screen mapa na /venues s všetkými aktivitami
- ✅ Klikateľné markery s custom ikonami pre každý šport
- ✅ InfoWindow s kompletnou informáciou a správnym štýlovaním
- ✅ User location detection a zobrazenie
- ✅ Legenda pre orientáciu
- ⏸️ Toggle medzi listom a mapou

---

## US-010: Zdieľanie aktivít

**Status:** 📋 PLANNED

Ako používateľ
chcem zdieľať aktivitu na sociálnych sieťach
aby som mohol pozvať priateľov

**Vývojár:** -

### Tasky:
- ⏸️ Share API implementácia (Web Share API)
- ⏸️ Fallback pre desktopové prehliadače (Copy link + social share buttons)
- ⏸️ Share buttons: Facebook, Instagram, WhatsApp, Twitter/X, Email
- ⏸️ Generovanie share URL s UTM parametrami
- ⏸️ Open Graph meta tags pre aktivitu (og:title, og:image, og:description)
- ⏸️ Twitter Card meta tags
- ⏸️ Preview image generátor (optional - dynamický OG image)
- ⏸️ Share button na detail stránke
- ⏸️ Share button na activity card (optional)
- ⏸️ Toast notifikácia "Link skopírovaný"
- ⏸️ Analytics tracking pre shares (optional)

### Výsledné funkcie:
- ⏸️ Web Share API na mobile
- ⏸️ Social share tlačidlá
- ⏸️ Copy link funkcia
- ⏸️ Rich previews na sociálnych sieťach

---

## US-011: Pridanie do kalendára

**Status:** 📋 PLANNED

Ako používateľ
chcem pridať aktivitu do môjho Google/Apple kalendára
aby som nezabudol na termín

**Vývojár:** -

### Tasky:
- ⏸️ Generovanie .ics súboru (iCalendar formát)
- ⏸️ API: GET /api/activities/[id]/calendar (vracia .ics)
- ⏸️ Google Calendar link generátor
- ⏸️ Apple Calendar kompatibilita
- ⏸️ Outlook Calendar link
- ⏸️ Tlačidlo "Pridať do kalendára" na detaile
- ⏸️ Dropdown menu s možnosťami (Google, Apple, Outlook, Download .ics)
- ⏸️ ICS súbor obsahuje: názov, popis, lokácia, začiatok, koniec, alarm (1h pred)
- ⏸️ Automatické nastavenie časového pásma
- ⏸️ Responzívne tlačidlo

### Výsledné funkcie:
- ⏸️ Google Calendar export
- ⏸️ Apple Calendar export
- ⏸️ Outlook Calendar export
- ⏸️ .ics download

---

## US-012: Pokročilé filtrovanie a preferencie

**Status:** 🔄 WIP (Work In Progress)

Ako používateľ
chcem filtrovať aktivity podľa skúseností, pohlavia, veku, ceny a ďalších kritérií
aby som našiel aktivity, ktoré mi vyhovujú

**Vývojár:** Jozef Kovalčín

### Tasky:
#### Rozšírenie databázového modelu
- ✅ Prisma schema: rozšírenie Activity (skillLevel, gender, minAge, maxAge, price)
- ✅ Prisma schema: UserPreferences model (preferredSports, skillLevel, maxDistance, maxPrice)
- ✅ Migrácia databázy

#### Backend
- ✅ API: GET /api/activities s rozšíreným filtrovaním
- ✅ Filtrovanie: skillLevel (začiatočník, stredne pokročilý, pokročilý, expert)
- ✅ Filtrovanie: gender (muži, ženy, zmiešané)
- ✅ Filtrovanie: vekové rozpätie (minAge-maxAge)
- ✅ Filtrovanie: cena (od-do)
- ⏸️ API: GET/PUT /api/preferences (uloženie používateľských preferencií)

#### Frontend - Filter panel
- ⏸️ Bočný filter panel na /activities
- ⏸️ Dropdown/Select pre úroveň (skillLevel)
- ⏸️ Radio buttons pre pohlavie
- ⏸️ Slider/Input pre vek (range)
- ⏸️ Slider/Input pre cenu (range)
- ⏸️ Checkbox pre športy
- ⏸️ "Použiť filtre" a "Resetovať" tlačidlá
- ⏸️ Uložené preferencie v /profile/preferences
- ⏸️ Quick filter badges (zobrazenie aktívnych filtrov)
- ⏸️ Mobile-friendly filter (bottom sheet/modal)

#### Formulár na vytvorenie aktivity
- ✅ Pridať polia: skillLevel, gender, minAge, maxAge, price do create formu
- ✅ Custom styled number inputs s +/- tlačidlami
- ✅ Validácia (minAge <= maxAge, price >= 0)
- ✅ Backend validácia všetkých polí
- ✅ Zobrazenie nových polí na detail stránke

### Výsledné funkcie:
- ✅ Databázový model rozšírený
- ✅ Backend API podporuje filtrovanie
- ✅ Rozšírený create form s všetkými poliami
- ✅ Custom UI controls (duration, participants, age, price)
- ✅ Detail stránka zobrazuje všetky nové polia
- ⏸️ Filter panel UI na /activities
- ⏸️ Uloženie preferencií
- ⏸️ Responzívny filter UI

---

## US-013: Verejný používateľský profil

**Status:** 📋 PLANNED

Ako používateľ
chcem vidieť profily ostatných používateľov s ich predošlými aktivitami
aby som vedel, s kým budem hrať

**Vývojár:** - Jozef Kovalčín

### Tasky:
#### Backend
- ⏸️ API: GET /api/users/[id] (verejné dáta)
- ⏸️ API: GET /api/users/[id]/activities (absolvované aktivity)
- ⏸️ Prisma query: počet aktivít, hodnotenie (optional)
- ⏸️ Privacy nastavenia (ktoré dáta sú verejné)

#### Frontend - Verejný profil
- ⏸️ Stránka /users/[id]
- ⏸️ Zobrazenie: meno, avatar, bio, mesto
- ⏸️ Štatistiky: počet aktivít, obľúbené športy
- ⏸️ Zoznam predošlých aktivít (completed)
- ⏸️ Badge systém (optional: "Častý hráč", "Organizátor" atď.)
- ⏸️ Hodnotenie/Recenzie od ostatných (optional)
- ⏸️ Responzívny dizajn

#### Prepojenia
- ⏸️ Link na profil z activity card (pri účastníkoch)
- ⏸️ Link na profil z activity detail (zoznam účastníkov)
- ⏸️ Avatar klikateľný → profil

#### Privacy
- ⏸️ Nastavenie v /profile/privacy (čo je verejné)
- ⏸️ Možnosť skryť predošlé aktivity
- ⏸️ Možnosť skryť štatistiky

### Výsledné funkcie:
- ⏸️ Verejný profil stránka
- ⏸️ História aktivít
- ⏸️ Štatistiky používateľa
- ⏸️ Privacy nastavenia

---

## US-014: Notifikácie o nových aktivitách

**Status:** 📋 PLANNED

Ako používateľ
chcem dostávať notifikácie o nových aktivitách v mojom okolí podľa mojich preferencií
aby som nezmeškal zaujímavé aktivity

**Vývojár:** -

### Tasky:
#### Backend - Notifikačný systém
- ⏸️ Prisma schema: Notification model (type, userId, activityId, read, createdAt)
- ⏸️ API: GET /api/notifications (zoznam notifikácií)
- ⏸️ API: PUT /api/notifications/[id]/read (označiť ako prečítané)
- ⏸️ API: DELETE /api/notifications/[id]
- ⏸️ Background job: kontrola nových aktivít podľa preferencií (cron job)
- ⏸️ Matching engine: aktivita vs. user preferences (šport, location, price)
- ⏸️ Rate limiting (max X notifikácií denne)

#### Push notifikácie (optional)
- ⏸️ Web Push API setup
- ⏸️ Service Worker registrácia
- ⏸️ Push subscription management
- ⏸️ API: POST /api/notifications/subscribe
- ⏸️ Browser notification permission request

#### Email notifikácie
- ⏸️ Email service setup (SendGrid, Resend, alebo Nodemailer)
- ⏸️ Email template pre novú aktivitu
- ⏸️ Digest email (denný/týždenný súhrn)
- ⏸️ Unsubscribe link

#### Frontend - Notification center
- ⏸️ Notification bell icon v headeri
- ⏸️ Badge s počtom neprečítaných
- ⏸️ Dropdown/Panel s notifikáciami
- ⏸️ Notification item: avatar, text, čas, link na aktivitu
- ⏸️ "Označiť všetko ako prečítané"
- ⏸️ "Vymazať všetky"
- ⏸️ Link na /notifications (full page view)
- ⏸️ Real-time updates (WebSocket alebo polling)

#### Nastavenia notifikácií
- ⏸️ Stránka /profile/notifications
- ⏸️ Toggle: email notifikácie on/off
- ⏸️ Toggle: push notifikácie on/off
- ⏸️ Frekvencia: instant, denný digest, týždenný digest
- ⏸️ Filter: len obľúbené športy, len v okolí X km
- ⏸️ Quiet hours (nočný režim)

### Výsledné funkcie:
- ⏸️ In-app notifikácie
- ⏸️ Push notifikácie (optional)
- ⏸️ Email notifikácie
- ⏸️ Notifikačné centrum
- ⏸️ Konfigurovateľné nastavenia

---

## US-015: Hodnotenie a recenzie

**Status:** 📋 PLANNED

Ako používateľ
chcem hodnotiť účastníkov po aktivite
aby ostatný vedeli, s kým hrajú

**Vývojár:** -

### Tasky:
### Backend
- ⏸️ Prisma schema: Review model (rating 1-5, comment, reviewer, reviewed user)
- ⏸️ API: POST /api/users/[id]/reviews
- ⏸️ API: GET /api/users/[id]/reviews (zoznam recenzií)
- ⏸️ Validácia: len pre účastníkov aktivity
- ⏸️ Validácia: len po dátume aktivity
- ⏸️ Validácia: jeden review na používateľa na aktivitu
- ⏸️ Validácia: no spam, min 10 znakov pre comment
- ⏸️ Výpočet priemerného ratingu (agregácia)
- ⏸️ API: POST /api/reviews/[id]/report (report inappropriate review)

### Frontend - Review komponenty
- ⏸️ Review modal po skončení aktivity
- ⏸️ Star rating komponenta (1-5 hviezd, interactive)
- ⏸️ Text area pre komentár (optional, max 500 znakov)
- ⏸️ Character counter (500/500)
- ⏸️ Anonymous option checkbox (meno skryté)
- ⏸️ Submit a Cancel tlačidlá
- ⏸️ Loading state pri odosielaní

### Frontend - Zobrazenie recenzií
- ⏸️ Zobrazenie priemerného ratingu na profile (stars + číslo)
- ⏸️ Zoznam recenzií na profile stránke
- ⏸️ Review card komponenta (avatar, meno/anonymous, rating, komentár, dátum)
- ⏸️ Pagination pre recenzie (10 per page)
- ⏸️ Report inappropriate review button
- ⏸️ "Žiadne recenzie" empty state
- ⏸️ Responzívny dizajn

### Notifikácie
- ⏸️ Notifikácia pre používateľa pri novej recenzii
- ⏸️ Email notifikácia o novom hodnotení (optional)

### Výsledné funkcie:
- ⏸️ Rating systém funguje
- ⏸️ Reviews na profile
- ⏸️ Priemerný rating sa zobrazuje
- ⏸️ Report function

---

## US-016: Chat pre aktivitu

**Status:** 📋 PLANNED

Ako používateľ
chcem komunikovať s účastníkmi aktivity
aby sme mohli medzi sebou komunikovať

**Vývojár:** -

### Tasky:
### Backend
- ⏸️ Prisma schema: Message model (activity_id, user_id, content, timestamp)
- ⏸️ API: GET /api/activities/[id]/messages (s pagination)
- ⏸️ API: POST /api/activities/[id]/messages
- ⏸️ API: DELETE /api/messages/[id] (delete vlastnej správy)
- ⏸️ Validácia: len pre prihlásených účastníkov
- ⏸️ Validácia: max 500 znakov na správu
- ⏸️ Real-time setup (Pusher/Ably konfigurácia alebo polling endpoint)
- ⏸️ Unread message tracking (Message.read field)
- ⏸️ API: PUT /api/messages/mark-read

### Frontend - Chat UI
- ⏸️ Chat UI komponenta (sidebar/panel na detaile aktivity)
- ⏸️ Toggle button na otvorenie/zatvorenie chatu
- ⏸️ Message list (scrollable container)
- ⏸️ Message bubble komponenta (left/right podľa odosielateľa)
- ⏸️ Zobrazenie mena a fotky odosielateľa
- ⏸️ Timestamp pre každú správu (relatívny čas: "5 min ago")
- ⏸️ Message input field (textarea s auto-resize)
- ⏸️ Send button (disabled ak prázdne)
- ⏸️ Character counter (500/500)

### Real-time funkcie
- ⏸️ Real-time message receiving (Pusher/Ably integration)
- ⏸️ Auto-scroll na novú správu (smooth scroll)
- ⏸️ Unread message badge (počet neprečítaných)
- ⏸️ "Typing..." indikátor (optional)
- ⏸️ Message delivered/read status (optional)

### UX vylepšenia
- ⏸️ Emoji picker (optional - React Emoji Picker)
- ⏸️ Message delete option (len vlastné správy)
- ⏸️ "Load more" pre staršie správy (pagination)
- ⏸️ Empty state ("Začnite konverzáciu...")
- ⏸️ Loading skeleton pre načítavanie správ
- ⏸️ Error handling (offline, failed send)
- ⏸️ Responzívny dizajn (mobile drawer)

### Výsledné funkcie:
- ⏸️ Chat funguje
- ⏸️ Real-time updates
- ⏸️ Len pre účastníkov
- ⏸️ Message history

---

## US-017: AI Chatbot pre support

**Status:** 📋 PLANNED

Ako používateľ
chcem sa opýtať AI na otázky o platforme
aby som rýchlo našiel odpovede na moje otázky o platforme

**Vývojár:** -

### Tasky:
### Backend - AI Infrastructure
- ⏸️ API: POST /api/ai/support-chat
- ⏸️ OpenAI Assistants API integration
- ⏸️ API rate limiting (10 requests/day pre free users)
- ⏸️ Token usage tracking a cost monitoring
- ⏸️ Error handling a fallback responses
- ⏸️ API: GET /api/ai/chat-history (pre daného používateľa)
- ⏸️ API: DELETE /api/ai/chat-history (vymazanie histórie)

### RAG Setup (Retrieval Augmented Generation)
- ⏸️ Pinecone/Supabase Vector database setup
- ⏸️ Knowledge base creation (FAQ dokumenty)
- ⏸️ Platform guide embeddings (ako používať features)
- ⏸️ FAQ dokumenty embeddings
- ⏸️ Vector search implementation
- ⏸️ Context injection do AI promptu
- ⏸️ Relevance scoring a filtering

### Context-Aware Features
- ⏸️ Current page detection (URL tracking)
- ⏸️ User profile info injection (ak prihlásený)
- ⏸️ Recent user actions tracking (last 5 actions)
- ⏸️ Dynamic prompt construction based on context
- ⏸️ Session-based conversation memory

### Frontend - Chat Widget
- ⏸️ Floating chat button (bottom right, sticky)
- ⏸️ Badge notification (nová odpoveď)
- ⏸️ Chat window komponenta (minimize/maximize/close)
- ⏸️ Chat header s titulom a actions
- ⏸️ Message list (user + AI bubbles)
- ⏸️ Message input field
- ⏸️ Send button
- ⏸️ Loading indicator (typing dots)
- ⏸️ Scroll to bottom button

### Quick Actions
- ⏸️ Quick action buttons: "Ako vytvoriť aktivitu?"
- ⏸️ Quick action buttons: "Ako sa prihlásiť?"
- ⏸️ Quick action buttons: "Ako nájsť aktivity?"
- ⏸️ Quick action buttons: "Ako upraviť profil?"
- ⏸️ Dynamic suggestions based on page

### Advanced Features
- ⏸️ Chat history persistence (conversation_id v localStorage)
- ⏸️ "Nová konverzácia" button (reset context)
- ⏸️ Escalation to human support button
- ⏸️ Human support form (meno, email, správa)
- ⏸️ Multilingual support (SK/EN auto-detection)
- ⏸️ Copy response button
- ⏸️ Thumbs up/down feedback
- ⏸️ "Bolo to užitočné?" feedback

### Analytics
- ⏸️ Common questions tracking (analytics dashboard)
- ⏸️ User satisfaction metrics (feedback aggregation)
- ⏸️ Response time monitoring
- ⏸️ Escalation rate tracking
- ⏸️ Most helpful answers identification

### UX Polish
- ⏸️ Smooth animations (open/close, messages)
- ⏸️ Typing indicator when AI is responding
- ⏸️ Error states ("Niečo sa pokazilo, skúste znova")
- ⏸️ Offline detection a warning
- ⏸️ Mobile responsive design
- ⏸️ Keyboard shortcuts (ESC to close)
- ⏸️ Welcome message on first open

### Výsledné funkcie:
- ⏸️ AI chatbot funguje
- ⏸️ RAG s knowledge base
- ⏸️ Context-aware answers
- ⏸️ Chat history


## US-018: AI Matchmaking pre hráčov

**Status:** 📋 PLANNED

Ako používateľ
chcem aby AI našlo kompatibilných spoluhráčov
aby som hral s ľuďmi na mojej úrovni

**Vývojár:** -

### Tasky:
### Backend - Database & Models
- ⏸️ Prisma schema: MatchScore model (user1_id, user2_id, score, factors)
- ⏸️ Prisma schema: rozšírenie User (playStyle, preferredTimes, skillLevels)
- ⏸️ Database indexes pre rýchle vyhľadávanie
- ⏸️ Cache layer pre match scores (Redis - optional)

### Compatibility Algorithm
- ⏸️ Skill level matching algorithm (weight: 25%)
- ⏸️ Play style preferences matching (competitive/casual) (weight: 20%)
- ⏸️ Age group similarity calculation (weight: 15%)
- ⏸️ Location proximity (Haversine distance) (weight: 20%)
- ⏸️ Schedule compatibility analysis (weight: 10%)
- ⏸️ Past activity ratings correlation (weight: 10%)
- ⏸️ Sport preferences overlap
- ⏸️ Final score calculation (weighted sum 0-100%)

### AI Integration
- ⏸️ OpenAI embeddings generation pre user profiles
- ⏸️ Vector similarity search (cosine similarity)
- ⏸️ Embedding storage (Pinecone/Supabase Vector)
- ⏸️ Batch embedding generation (pre existing users)
- ⏸️ Incremental embedding updates (pri zmene profilu)
- ⏸️ API: POST /api/ai/match-users

### Backend APIs
- ⏸️ API: GET /api/users/matches (top matches pre používateľa)
- ⏸️ API: GET /api/activities/[id]/suggested-users (pre danú aktivitu)
- ⏸️ API: POST /api/matches/[userId]/invite (pozvať matched usera)
- ⏸️ Match score caching (24h refresh)
- ⏸️ Pagination pre match results
- ⏸️ Filtering options (min score, max distance)

### Frontend - Match Discovery
- ⏸️ "Nájdi mi spoluhráča" feature page (/find-partners)
- ⏸️ Match score zobrazenie (1-100% progress bar + badge)
- ⏸️ Match card komponenta (avatar, meno, score, factors)
- ⏸️ Match explanation tooltip: "Podobná úroveň, blízka lokalita..."
- ⏸️ "Perfect match" badge (90%+ score) - special styling
- ⏸️ "Good match" badge (70-89%)
- ⏸️ Skill level indicators (beginner/intermediate/advanced)

### Frontend - Activity Integration
- ⏸️ Suggested users section na activity detail
- ⏸️ "Odporúčaní spoluhráči" widget (top 3)
- ⏸️ Invite matched user button
- ⏸️ Invite modal (personalizovaná správa)
- ⏸️ Toast notifikácia po odoslaní pozvánky

### Match Breakdown UI
- ⏸️ Expandable match details (klik na match card)
- ⏸️ Factor breakdown visualization:
 - ⏸️ Skill level match (progress bar)
 - ⏸️ Location proximity (distance in km)
 - ⏸️ Schedule compatibility (calendar icon)
 - ⏸️ Play style match (competitive/casual)
 - ⏸️ Common sports (badge list)
- ⏸️ "Prečo sme kompatibilní" text explanation (AI-generated)

### Email Digest
- ⏸️ Weekly "Best matches" email template
- ⏸️ Email service integration (SendGrid/Resend)
- ⏸️ Cron job: weekly match calculation a email send
- ⏸️ Top 5 matches v emaili
- ⏸️ CTA button: "Pozri všetky matched"
- ⏸️ Unsubscribe option

### User Preferences
- ⏸️ Match preferences page (/profile/match-preferences)
- ⏸️ Toggle: enable/disable matchmaking
- ⏸️ Max distance slider (5-50 km)
- ⏸️ Preferred age range
- ⏸️ Play style preference (competitive/casual/both)
- ⏸️ Notification frequency (instant/weekly/never)

### Analytics & Optimization
- ⏸️ Match success tracking (koľko invites accepted)
- ⏸️ Algorithm performance monitoring
- ⏸️ A/B testing framework (different weight combinations)
- ⏸️ User feedback collection ("Bol toto dobrý match?")

### Výsledné funkcie:
- ⏸️ Matchmaking algorithm
- ⏸️ Compatibility scores
- ⏸️ User suggestions
- ⏸️ Weekly digest

---

## US-019: Reset hesla cez email

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem si obnoviť heslo ak som ho zabudol
aby som sa mohol znova prihlásiť do aplikácie

**Vývojár:** Kamil Berecký

### Tasky:
- ✅ Prisma schema: PasswordReset model (token, userId, expiresAt, used)
- ✅ Email service setup (Brevo - 300 emailov/deň zadarmo)
- ✅ Verified sender email (kberecky@gmail.com) v Brevo dashboard
- ✅ API: POST /api/auth/forgot-password (generuje token a posiela email)
- ✅ API: POST /api/auth/reset-password (resetuje heslo s tokenom)
- ✅ Email template pre reset link (HTML s responsive dizajnom)
- ✅ Stránka /auth/forgot-password (formulár na zadanie emailu)
- ✅ Stránka /auth/reset-password?token=xxx (formulár na nové heslo)
- ✅ Validácia tokenu (expiracia 1 hodina, used flag)
- ✅ Bezpečné generovanie tokenu (crypto.randomBytes + SHA-256)
- ✅ Hash nového hesla (scrypt s Better Auth parametrami: N:16384, r:16, p:1, dkLen:64)
- ✅ Vymazanie tokenu po použití (used = true)
- ✅ Správne URL pre frontend (NEXT_PUBLIC_FRONTEND_URL)
- ✅ "Zabudli ste heslo?" link na signin stránke
- ✅ Success/Error feedback messages (slovenský jazyk)
- ✅ Rate limiting (max 3 requesty za hodinu na email)
- ✅ Responzívny dizajn
- ✅ Development mode (console log namiesto emailu keď BREVO_API_KEY="brevo_test_key")
- ✅ Production mode (Brevo API integration s messageId tracking)
- ✅ Všetky sessions sa vymažú po resete (force re-login)

### Výsledné funkcie:
- ✅ Odoslanie reset emailu funguje (Brevo API)
- ✅ Token validácia funguje (expiracia, duplicita, použitie)
- ✅ Reset hesla funguje s kompatibilným scrypt hashom
- ✅ Email template je pekný a funkčný s correct frontend URL
- ✅ Development mode bez Brevo API kľúča (console log)
- ✅ Production ready s Brevo integration
- ✅ Všetky sessions sa vymažú po resete (security)
- ✅ Prihlásenie funguje po resete hesla

**Technické detaily:**
- Email service: Brevo (@getbrevo/brevo SDK)
- Password hashing: Node.js crypto scrypt (Better Auth compatible)
- Token storage: PostgreSQL (PasswordReset table)
- Email delivery: 300/day limit (Brevo free tier)

---

## US-020: Stránka "Moje aktivity"

**Status:** ✅ HOTOVÉ

Ako používateľ
chcem mať prehľad všetkých mojich aktivít (vytvorených aj prihlásených) na jednom mieste
aby som vedel, na čo som sa prihlásil a čo som vytvoril

**Vývojár:** Jozef Kovalčín

### Tasky:
- ✅ API: GET /api/activities/my (vracia created a joined aktivity)
- ✅ Backend logika: created = organizerId === userId
- ✅ Backend logika: joined = participation existuje pre userId (vrátane vlastných aktivít)
- ✅ Stránka /my-activities s tab navigáciou
- ✅ Tab "Vytvorené" (created activities)
- ✅ Tab "Prihlásené" (joined activities vrátane vlastných)
- ✅ Štatistiky: Total Created, Total Joined, Upcoming Created, Upcoming Joined
- ✅ Activity cards s badge "Organizátor" pre vytvorené
- ✅ Badge "Opakovaná" pre recurring aktivity
- ✅ Smart back navigation (sessionStorage tracking)
- ✅ Delete button pre organizátorov na detail stránke
- ✅ Redirect na source page po zmazaní (activities vs my-activities)
- ✅ Empty states pre obe záložky
- ✅ CTA buttons: "Vytvoriť aktivitu" / "Prehliadať aktivity"
- ✅ Responzívny dizajn

### Výsledné funkcie:
- ✅ Backend API vracia vytvorené aj prihlásené aktivity
- ✅ Tab navigácia medzi vytvorenými a prihlásenými
- ✅ Štatistiky zobrazujú správne počty
- ✅ Activity cards s visual badges (Organizátor, Opakovaná)
- ✅ Delete funkcia pre organizátorov s smart navigation
- ✅ Smart back button tracking (vracia na správnu stránku)
- ✅ Empty states s CTA akciami

---

## Legenda

- ✅ Hotové (Completed)
- 🔄 WIP (Work In Progress - rozrobené)
- ⏸️ Nerealizované (Planned but not started)
- 📋 PLANNED (Celá user story je len naplánovaná)

---