Zadanie 3 - Finálne odovzdanie
Finálne odovzdanie projektu - kompletná implementácia
Zadanie 3 - Finálne odovzdanie
Termín odovzdania: 26.04.2026 23:59
Miesto odovzdania: GitHub repozitár commit do hlavnej vetvy + odovzdanie .zip súboru do AIS
Úloha v rámci zadania
Úloha v rámci zadania 3 je odovzdať kompletnú implementáciu projektu, ktorý ste vyvíjali počas semestra. Projekt musí spĺňať všetky požiadavky a musí být odprezentovaný na cvičeniach 9-12.
1. Nutné podmienky
Získať môžete max 6 bodov za túto časť. Splniť musíte všetky podmienky, inak bude projekt hodnotený 0 bodov.
Aby projekt bol hodnotený nenulovým počtom bodov, musí splniť všetky nasledujúce podmienky:
| Podmienka | Popis |
|---|---|
| OOP princípy | Generalizácia, dedenie, polymorfizmus (run-time, compile-time), preťaženie, prekonanie, enkapsulácia, abstrakcia |
| GUI | Projekt resp. vaša hra musí obsahovat grafické používateľské rozhranie (GUI). |
| Jednotkové testy* | Pokrytie kódu na minimálne 80% (line coverage) |
| Rozhrania | Projekt musí obsahovať interface(s) |
| JavaDoc | Anotácie v kóde |
| UML diagram tried | Finálny diagram tried vašej hry |
| Vypracovanie dokumentácie | Kompletná technická dokumentácia |
2. Ďalšie podmienky
Získať môžete max 14 bodov za túto časť. Môžete si vybrať, ktoré princípy, vzory alebo technológie implementujete. Pri každom je uvedený max. počet bodov, ktorý môžete získať za jeho zmysluplnú implementáciu.
Ďalšie môžete vo vašom projekte implementovať. Tieto veci nie sú povinné, ale v prípade, že ich neimplementujete, bude vám chýbať časť bodov z hodnotenia.
| Podmienka | Popis | Max. počet bodov |
|---|---|---|
| Návrhové/architektonické vzory | Observer, Strategy, atď. | 5 bodov |
| Loggovanie činností | Použitie loggeru | 2 body |
| Vlastné výnimky | Implementácia custom exceptions | 2 body |
| Viacvláknovosť | Použitie threads | 2 body |
| Generickosť | Generické triedy vo vlastnom kóde | 2 body |
| Použitie reflexie | 2 body | |
| Použitie lambda výrazov | 2 body | |
| Použitie serializácie | 2 body |
Finálna špecifikácia hodnotenia je skonkretizovaná nižšie.
Nutnou podmienkou pre získanie bodov za akýkoľvek OOP pincíp je jeho korektné zdokumentovanie a vysvetlenie v rámci prezentácie a otázok.
3. Commity
Na projekte musíte pracovať priebežne. Je potrebné mať spravené každý týždeň v priemere aspoň 2 commity v GitHub repozitári.
Vysvetlenie: Formulácia „v priemere aspoň 2 commity za týždeň“ má zdôrazniť, že na projekte je vhodné pracovať priebežne počas celého semestra. Očakáva sa preto, že commity budú pribúdať pravidelne každý týždeň, približne v súlade s uvedeným priemerom, a nie až naraz po dlhšom období bez aktivity.
Je dovolené vynechať za celý semester jeden týždeň. Ak ste si túto možnosť uplatnili, uveďte to v dokumentácii k projektu.
Dokumentácia musí obsahovať
- Formálne náležitosti - titulná strana, obsah, číslovanie strán
- Špecifikáciu zadania resp. projektu - akú hru robíte
- Ukážky a popis OOP princípov (z nutných podmienok) s prepojením na kód
- Ukážky, popis a vysvetlenie ďalších implementovaných funkcionalít, princípov alebo vzorov (z ďalších podmienok)
- Opis grafického používateľského rozhrania a jednotlivých obrazoviek
- Opis testovania a jednotnových testov a ich výsledky
- UML diagram tried
- Vyjadrenie ku commitom - či ste splnili požiadavku na počet commitov, či ste využili možnosť vynechať jeden týždeň, a ak áno, ktorý týždeň to bol
- Používateľský manuál - ako spustiť program
Hodnotenie
Všetky odovzdané práce budú podrobené kontrole originality a musia byť v súlade s Etickým kódexom.
| Kritérium | Body |
|---|---|
| Finálne odovzdanie | 20 bodov |
Čo má obsahovať odovzdanie
AIS: Jeden .zip súbor (nie .rar) s názvom MenoPriezvisko_Zadanie3.zip obsahujúci:
- Zdrojový kód - kompletný zdrojový kód implementácie aj testov
- Dokumentácia - kompletnú technickú dokumentáciu vo formáte PDF
Do AIS odovzdávate kód, ktorý je .zip súborom vášho repozitára s kódom na GitHub.
GitHub: Vykonáte final commit kódu do hlavnej vetvy do dátumu odovzdania. V repozitári bude:
- Zdrojový kód - kompletný zdrojový kód implementácie aj testov
- Dokumentácia - kompletnú technickú dokumentáciu vo formáte PDF
Samotná implementácia nestačí, je potrebné vedieť čo a prečo robíte. Kódu musíte rozumieť a musíte byť schopní ho pri prezentácii vysvetliť a obhájiť.
Každý študent musí odprezentovať odozvdanú prácu. Prezentácie projektov prebiehajú na cvičeniach 9-12.