Přezdívka
Období: Týden 12/2026 (od 22.03.) Skupina: tria
1. Splnění základních podmínek
| Podmínka | Status |
|---|---|
| Alespoň 3 commity v daném týdnu | ✅ SPLNĚNO |
| Rozestup alespoň 12h mezi 3 commity | ✅ SPLNĚNO |
| Projektová dokumentace (README, projekt.md) | ✅ SPLNĚNO |
Vypočtený Index za tento týden: 294
Týdenní Index Náročnosti dodaných skriptů (1-5): 3
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 5 |
| Počet změněných souborů | 5 |
| Počet přid./odeb. řádků kódů | 1356 |
Přehled commitů
- 2026-03-23 07:42: Vylepšeni grafiky hry, změnění spawnovani enemiček
- 2026-03-23 09:35: přidal do hry waves(každa wave = těžši enemička)
- 2026-03-23 20:03: přidani upgradu do hry, vylepšení lvl systemu
- 2026-03-26 20:32: přidani upgradu do hry, přidani hit effectu
- 2026-03-28 10:45: dodělání dokumentace, odstranění nepotřebných souboru
3. Hodnocení asistentem AI (Logika a úsilí)
Zde je hodnocení práce za uplynulý týden:
1. Smysluplnost popisů u commitů [3 body]
Zprávy v historii verzování jsou jasné, stručné a věcně popisují provedené změny (např. „přidání upgradu do hry“, „vylepšení lvl systému“). Student používá konzistentní styl i jazyk. Oceňuji zejména commit z 28. března, který ukazuje na snahu o reflexi a čištění projektu („odstranění nepotřebných souborů“).
2. Smysluplnost komentářů v kódu [5 bodů]
V souboru patch_level_up.py (který byl dle historie smazán po použití) jsou komentáře příkladné – jasně člení skript do logických bloků (1. Player.init, 2. Player.add_xp atd.). V samotném hlavním souboru 2dsurvival_game.py je však v rámci ukázky komentářů méně. Dokumentace v .md souborech je sice špičková, ale body v této kategorii se soustředí na kód. Doporučuji přidat více „proč“ komentářů k nově přidaným proměnným jako knockback_timer.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]
Struktura repozitáře je naprosto v pořádku. Každý projekt má svou vlastní složku (/snake, /2dsurvival_game) a v rootu se nachází pouze README.md.
Upozornění: V repozitáři se nachází složka __pycache__ a soubor .pyc. Tyto soubory jsou generovány Pythonem a do verzovacího systému (Git) nepatří. Doporučuji nastavit soubor .gitignore.
Dokumentace v 2dsurvival_game.md je vynikající, obsahuje detailní rozbor herních mechanik, statistik nepřátel i ovládání.
4. Logika řešení a přemýšlení studenta v Pythonu [9 bodů]
Student prokázal vysokou úroveň programátorského myšlení.
- Progrese: Přechod od jednoduchého hada k survival hře s vlnami nepřátel a RPG prvky (level-up systém) je výrazný skok v náročnosti.
- Logika: Implementace „Level up menu“ se třemi náhodně nabízenými upgrady (random.sample(UPGRADES_POOL, 3)) ukazuje na pokročilé pochopení herní smyčky a správy stavu aplikace (is_level_up_screen).
- Kreativita: Skript patch_level_up.py je fascinující ukázkou „meta-programování“. Místo aby student kód jen přepsal, napsal si pomocný skript, který pomocí operací se stringy modifikoval hlavní herní soubor. I když je to v praxi riskantní metoda (náchylná k chybám při sebemenší změně v cílovém souboru), ukazuje to na velmi silné algoritmické uvažování.
- Herní mechaniky: Nový wave systém a rozlišení typů nepřátel (Tank, Fast, Flying) s různými atributy svědčí o dobré architektuře objektů (i když je vidět jen část kódu).
Celkem získáno bodů: [19 / 95%] ze 20 možných
STUPNICE NÁROČNOSTI (Index 1-5): DIFFICULTY_INDEX: [3]