Přezdívka
Období: Týden 13/2026 (od 29.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: 282
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ů | 6 |
| Počet přid./odeb. řádků kódů | 679 |
Přehled commitů
- 2026-03-30 06:15: vylepšení menu hry
- 2026-03-30 06:42: přidaní peněz do hry, rozdělení upgradu do rarities
- 2026-03-30 08:11: přidani enemy spawn limitu
- 2026-04-02 18:11: přidani boss enemiček
- 2026-04-03 20:31: uprava dokumentace, přidani souboru vysvětlujci kod
3. Hodnocení asistentem AI (Logika a úsilí)
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci na projektu za uplynulý týden. Je vidět, že jsi na hře 2dsurvival_game udělal velký kus práce, zejména v oblasti herních mechanik a dokumentace.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [3 body]
Tvé commity jsou jasné a srozumitelné. Oceňuji, že každý commit odpovídá konkrétní logické změně (přidání bossů, úprava menu, peníze). Jen drobná poznámka k češtině: v commitu "přidani boss enemiček" se snaž používat spíše spisovné výrazy, ale bodování to nesnižuje, protože účel popisu byl splněn.
2. Smysluplnost komentářů v kódu [5 bodů]
Ačkoliv v samotném diffu kódu vidím tentokrát méně přímých komentářů v .py souboru, tvůj nový soubor vysvetleni_kodu.md funguje jako vynikající externí komentář k logice tříd (Camera, Player, Enemy). Detailně v něm popisuješ, co která metoda dělá (např. math.hypot pro vzdálenost). Body mírně strhávám za to, že v souboru vysvetleni_kodu.md máš překlep: "Pokud zbranˇ player hitne stvůru". Příště se snaž udržovat vysvětlivky přímo v kódu pomocí Docstrings, aby byly dostupné i programátorovi přímo při čtení funkcí.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Dokumentace (2dsurvival_game.md a vysvetleni_kodu.md) je na špičkové úrovni. Popisuješ nejen co program dělá, ale i jaké jsou parametry entit (Boss HP, rychlost atd.).
Zde však musím udělit zásadní výtku ke struktuře:
- V repozitáři máš složku /snake/__pycache__/. Soubory .pyc do repozitáře nikdy nepatří, mají být v .gitignore.
- Složka /random/ obsahuje soubory test.py a test2.py. To je přesně to, co pravidla zakazují – v repozitáři by neměl být "nepořádek" a pomocné soubory s neurčitými názvy.
Za tyto prohřešky strhávám 1 bod.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]
Tvá progrese v kódu je velmi dobrá. - Boss systém: Logika, kdy se boss spawnuje na konci vlny s vyšším HP a imunitou na knockback, je správně navržená. - Ekonomika: Přidání šance (30 %) na drop peněz a implementace "magnetu" pro sbírání XP i peněz ukazuje, že přemýšlíš nad herním designem a uživatelským zážitkem (UX). - Matematika: Správně používáš goniometrické funkce a výpočty vektorů pro pohyb nepřátel k hráči. Jeden bod nechávám jako rezervu pro finální propojení všech systémů a začištění výše zmíněných strukturálních chyb.
Celkem získáno bodů: [17 / 85%] z 20 možných
Zhodnocení: Práce je velmi kvalitní, zejména oceňuji tvůj analytický přístup k popisu funkcí. Pokud příště vyčistíš repozitář od pomocných testovacích skriptů a odstraníš složku __pycache__, bude to perfektní.
DIFFICULTY_INDEX: [3]