Ako plánovať úlohu

Skôr než začnete písať kód, napíšte si krátky plán toho, čo idete spraviť. Plán vám ukáže, čo ešte neviete, a kolega v ňom nájde chybu skôr, než ju napíšete do kódu. Prerobiť plán trvá pár minút, prerobiť hotovú obrazovku celú hodinu.

Kedy a kam

• Pred každou úlohou z týždenného plánu. Netreba ho len pri drobnosti, ktorú opíšete jednou vetou, napríklad „na tlačidle má byť Zavrieť namiesto Zrušiť“.
• Do karty úlohy v Notione. Keď úlohu odovzdávate ako merge request, plán skopírujte aj do jeho popisu.
• Pred začatím ho dajte prečítať kolegovi z tímu. Nemusí ho schvaľovať, stačí, keď si ho prejde.

Šablóna

CIEĽ: 1–2 vety – čo robím a prečo

SÚBORY:
- názov-súboru.vue – cesta v projekte (NOVÝ / UPRAVENÝ: čo sa v ňom mení)

ČO BUDE NA OBRAZOVKE:
- 1. časť obrazovky -> čo v nej je
  - 1.1 menšia časť alebo komponent -> čo zobrazuje
  - prázdny stav / načítavanie / chyba -> čo sa vtedy zobrazí
- 2. ďalšia časť

DÁTA A LOGIKA:
- props: názov -> čo komponent dostane
- emits: názov -> kedy komponent udalosť pošle
- computed: názov -> čo vypočíta
- funkcie: názov -> čo spraví

OTÁZKY:
- čo ešte neviem alebo musím zistiť

AKO TO OVERÍM:
- konkrétny postup v appke podľa akceptačných kritérií

Ako ju vyplniť

• Cieľ má najviac dve vety. Všetky podrobnosti patria do ďalších častí.
• Súbory píšte v poradí, v akom ich budete vytvárať alebo upravovať. Pri každom uveďte, či je nový, alebo čo sa v ňom mení.
• Časti obrazovky očíslujte (1, 2, 2.1…), aby bolo hneď vidieť, čo je v čom. Prázdny stav, načítavanie a chybu napíšte pod časť, ku ktorej patria – nie na koniec plánu.
• Dáta a logika – jedna vec na riadok v tvare názov -> čo robí. Pri obrazovke bez logiky túto časť vynechajte.
• Otázky – čo neviete, napíšte ako otázku. Nehádajte a nevyberajte si odpoveď potichu.
• Ako to overím – konkrétny postup, nie „otestujem, či to funguje“.

Pravidlá

1. V pláne nie je kód. Ani HTML, ani JavaScript. Opíšte, čo bude kde a čo robí, slovami a šípkami.
2. Čo neviete, napíšte ako otázku. Časť, ktorá závisí od nezodpovedanej otázky, začnite robiť až po odpovedi.
3. Plán pred začatím ukážte kolegovi.
4. Keď sa počas práce plán zmení, upravte ho. Plán má popisovať to, čo naozaj robíte.

Príklad: karta podujatia (US-02)

CIEĽ: Karta jedného podujatia pre zoznam podujatí, aby študent na prvý
pohľad videl, čo, kedy a kde sa koná.

SÚBORY:
- event-card.vue – app@events/_components/ (NOVÝ)
- events-list.vue – app@events/ (UPRAVENÝ: dočasnú kartu nahradí event-card)

ČO BUDE NA OBRAZOVKE (event-card.vue):
- 1. karta (div s pozadím, zaoblením, tieňom a paddingom) -> klik otvorí detail podujatia
  - 1.1 obrázok -> obrázok podujatia
    - bez obrázka -> náhradný obrázok podľa kategórie (gradient s ikonou)
    - srdiečko „Zaujíma ma“ vpravo hore -> ion-button s ikonou
  - 1.2 kategória -> text vo farbe primary
  - 1.3 názov podujatia
  - 1.4 dátum a čas začiatku -> naformátovaný napr. „18. 12. 2026, 17:00“
  - 1.5 miesto

DÁTA A LOGIKA:
- props: event -> objekt podujatia z mock dát
- emits: open -> pošle sa po kliknutí na kartu, s id podujatia
- computed: imageUrl -> obrázok podujatia, alebo náhradný podľa kategórie
- computed: formattedStart -> dátum a čas začiatku cez funkciu z _utils

OTÁZKY:
- Otvára detail karta sama, alebo len pošle open a otvorí ho zoznam?
- Bude na karte aj tlačidlo „Zaujíma ma“ (US-06), alebo ho pridáme neskôr?

AKO TO OVERÍM:
- otvorím Podujatia, vidím karty s obrázkom, kategóriou, názvom,
  dátumom a miestom
- podujatie bez obrázka má náhradný obrázok svojej kategórie
- klik na kartu otvorí detail toho istého podujatia