ClubHub – Fáza 1: Katalóg podujatí

O projekte

ClubHub je aplikácia, v ktorej študenti nájdu všetky školské podujatia na jednom mieste – krúžky, turnaje, výlety, koncerty aj prednášky. Je to mobilná aplikácia pre Android aj iOS.

Problém: informácie o podujatiach sú dnes roztrúsené po nástenkách, skupinových chatoch a e-mailoch. Študenti sa o akciách dozvedia neskoro alebo vôbec.

Vízia: jedna appka, kde študent nájde, čo sa v škole deje, prihlási sa a nič nezmešká.

Ciele projektu

• Dodať funkčnú aplikáciu po fázach, každá fáza je použiteľná sama o sebe.
• Vyskúšať si prácu ako na reálnom projekte: zadanie od klienta, tímová práca, code review, prezentácia výsledkov mentorovi.
• Na konci mať appku spustenú na reálnom telefóne.

Používatelia

V prvej fáze robíme appku pre jedného používateľa – študenta, ktorý hľadá podujatia. Ďalšie roly pridáme v neskorších fázach.

Persona	Kto to je	Čo potrebuje	Od fázy
Tomáš, 16 – študent	Chodí na basketbal, zaujíma sa o hackathony	Rýchlo zistiť, čo sa deje tento týždeň, a nezabudnúť na akciu	1
Lucia, 17 – organizátorka	Vedúča študentského divadelného krúžku	Zverejniť podujatie a vidieť, kto príde	neskôr
p. Novák – učiteľ	Organizuje výlety a súťaže	Mať prehľad o prihlásených	neskôr

Fáza 1 – MVP: Katalóg podujatí

Cieľom MVP je appka, v ktorej používateľ nájde podujatia, pozrie si detail a uloží si tie, ktoré ho zaujímajú.

Dáta o podujatiach v tejto fáze dodá klient ako súbor events.json (22 podujatí). Dátumy podujatí v súbore sú pevne dané – upravte si ich podľa potreby, aby ste mohli otestovať filtre obdobia. Appka zatiaľ nekomunikuje so serverom.

Dizajn: obrazovky Fázy 1 vo Figme a design systém (farby, písmo, ikony a komponenty). Obrazovky majú ID (A1, B1…), na ktoré sa môžete odvolávať.

V rozsahu fázy

• zoznam podujatí zoradený podľa dátumu,
• detail podujatia,
• vyhľadávanie podľa názvu,
• filter podľa kategórie a obdobia,
• označenie „Zaujíma ma“ a zoznam uložených podujatí.

Mimo rozsahu

Tieto veci nerobíme, ani čiastočne:

• prihlásenie používateľa,
• registrácia na podujatie a vstupenky,
• vytváranie a úprava podujatí,
• napojenie na server.

Obrazovky a user stories

MVP má 3 obrazovky: Podujatia (zoznam), Detail podujatia a Uložené. Každá user story má akceptačné kritériá – story je hotová, až keď sú splnené všetky.

US-01 Navigácia

Ako študent chcem jednoducho prepínať medzi podujatiami a uloženými, aby som sa v appke nestratil.

• Navigácia je v spodnej lište.
• Položky: Podujatia, Uložené. Aktívna položka je zvýraznená.
• Po spustení appky sa zobrazí obrazovka Podujatia.

US-02 Zoznam podujatí

Ako študent chcem vidieť prehľad najbližších podujatí, aby som vedel, čo sa v škole deje.

• Každé podujatie je karta s obrázkom, názvom, dátumom a časom, miestom a kategóriou.
• Podujatia sú zoradené podľa dátumu a času začiatku od najbližšieho. Pri rovnakom začiatku sú zoradené podľa názvu abecedne.
• Podujatia, ktoré už prebehli, sa nezobrazujú. Podujatie prebehlo, keď je jeho koniec v minulosti; ak nemá uvedený koniec, rozhoduje začiatok.
• Klik na kartu otvorí detail podujatia.
• Ak nie je žiadne podujatie, zobrazí sa prázdny stav s textom „Zatiaľ tu nie sú žiadne podujatia“.

US-03 Detail podujatia

Ako študent chcem vidieť všetky informácie o podujatí, aby som sa rozhodol, či pôjdem.

• Detail zobrazuje všetky údaje z časti Podujatie (nižšie).
• Z detailu sa dá vrátiť späť na zoznam; filtre a vyhľadávanie zostanú zachované.
• Ak sa podujatie nenájde, zobrazí sa hláška „Podujatie sa nenašlo“ s tlačidlom späť.

US-04 Vyhľadávanie

Ako študent chcem vyhľadať podujatie podľa názvu, aby som rýchlo našiel to, o ktorom som počul.

• Vyhľadávacie pole je nad zoznamom podujatí.
• Hľadá sa len v názve podujatia. Stačí časť názvu („robot“ nájde „Súťaž v robotike“) a medzery na začiatku a konci hľadaného textu sa ignorujú.
• Výsledky sa menia počas písania, bez potvrdenia.
• Nezáleží na veľkosti písmen ani diakritike („koncert“ nájde „KONCERT“, „beh“ nájde „Beh“, „sutaz“ nájde „Súťaž“).
• Keď nič nevyhovuje, zobrazí sa „Nenašli sme žiadne podujatie“ a možnosť vymazať hľadanie.

US-05 Filtre

Ako študent chcem vidieť len podujatia, ktoré ma zaujímajú, aby som nemusel prechádzať celý zoznam.

• Filter podľa kategórie – dá sa vybrať viac kategórií naraz. Zobrazí sa podujatie, ktoré patrí do ktorejkoľvek z vybraných kategórií.
• Filter podľa obdobia: Všetko, Dnes, Tento týždeň, Tento mesiac. Podujatie patrí do obdobia, keď v ňom začína:
  • Dnes – od 00:00 do 23:59 dnešného dňa,
  • Tento týždeň – od pondelka 00:00 do nedele 23:59 týždňa, v ktorom je dnešný deň,
  • Tento mesiac – od 1. dňa 00:00 do posledného dňa 23:59 aktuálneho mesiaca.
• Predvolený filter obdobia je Všetko a nie je vybraná žiadna kategória.
• Filtre sa dajú kombinovať navzájom aj s vyhľadávaním – zobrazí sa podujatie, ktoré spĺňa všetky naraz.
• Je vidieť, ktoré filtre sú aktívne, a jedným klikom sa dajú zrušiť všetky.

US-06 Zaujíma ma

Ako študent si chcem uložiť podujatia, ktoré ma zaujímajú, aby som ich mal po ruke.

• Podujatie sa dá označiť „Zaujíma ma“ na karte v zozname aj v detaile; opätovný klik označenie zruší.
• Obrazovka Uložené zobrazuje označené podujatia v rovnakom tvare ako zoznam.
• Označenie zostane aj po zatvorení a znovuotvorení appky.
• Ak nie je nič uložené, zobrazí sa prázdny stav s tlačidlom „Prezrieť podujatia“.

Podujatie

Každé podujatie má tieto údaje. Na karte v zozname sa zobrazujú len niektoré, v detaile všetky.

Údaj	Príklad	Na karte	Povinný
Názov	Vianočný koncert	áno	áno
Kategória	Kultúra	áno	áno
Dátum a čas začiatku	18. 12. 2026, 17:00	áno	áno
Dátum a čas konca	18. 12. 2026, 19:00	nie	nie
Miesto	Aula, 1. poschodie	áno	áno
Obrázok	fotka z minulého roka	áno	nie
Popis	2–3 odseky textu	nie	áno
Organizátor	Hudobný krúžok	nie	áno
Cena	Zadarmo / 3 €	nie	nie

Keď podujatie nemá obrázok, zobrazí sa náhradný obrázok podľa kategórie – fialový gradient s ikonou kategórie podľa dizajnu (komponent Category Image). Keď nemá cenu, nezobrazuje sa nič (nie „0 €“).

Kategórie

Šport, Kultúra, Veda a technika, Výlety, Krúžky, Ostatné.