Přezdívka
Období: Týden 15/2026 (od 12.04.) Skupina: tria URL: https://github.com/marekolsar-lgtm/P-ezd-vka.git
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 |
2. Přehled commitů
- 2026-04-12 16:11: vylepšeni grafiky charaktera a death animace
- 2026-04-18 08:31: optimalizace kodu, fixnuti bugs
- 2026-04-18 21:33: updatnuti dokumentace a vysvetleni kodu
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 16 / 20 b. (80%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 3 |
| Změněné soubory | 4 |
| Počet přid./odeb. řádků kódu | 758 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci na projektu 2D Survival Game za uplynulý týden. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]:
Zprávy u commitů jsou sice česky (což je v pořádku) a popisují provedenou činnost, ale jsou poněkud strohé. Například commit „optimalizace kodu, fixnuti bugs“ by mohl být konkrétnější – jaké chyby jsi opravil? Commit „updatnuti dokumentace a vysvetleni kodu“ je jasný, ale mohl jsi ho rozdělit, pokud jsi měnil i logiku. Chválím však dodržování časové posloupnosti.
2. Smysluplnost komentářů v kódu [5 bodů]:
Vzhledem k tomu, že jsi odevzdal rozsáhlý soubor vysvetleni_kodu.md, je vidět, že nad strukturou programu přemýšlíš a dokumentuješ ji pro ostatní. Je to skvělý zvyk. V samotném kódu (podle dokumentace) předpokládám existenci tříd a metod, které odpovídají tvým popisům. Body strhávám pouze za to, že v diffu nevidím přímo komentáře v .py souborech, ale tvůj externí popis je natolik detailní, že funkci programu jasně osvětluje.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:
Tady máme několik nedostatků, které musíš do příště napravit:
- Verzování zbytečností: Do repozitáře jsi nahrál složky __pycache__ (např. /2dsurvival_game/__pycache__/2dsurvival_game.cpython-311.pyc). Tyto soubory do gitu nepatří, vytvoř si soubor .gitignore.
- Názvy souborů: Ve složce /random/ máš soubory test.py a test2.py. To jsou přesně ty nesmyslné názvy, na které si máš dávat pozor. Pokud jde o pomocné skripty, pojmenuj je podle toho, co testují (např. test_perlin_noise.py).
- Dokumentace: Samotná dokumentace v 2dsurvival_game.md je naopak vynikající. Je velmi podrobná, obsahuje tabulky rarit, statistiky nepřátel a vysvětlení mechanik. To ti zachránilo body v této kategorii.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Tvá progrese v tomto týdnu je velmi silná. Implementace systému rarit (Common až Legendary) s konkrétními pravděpodobnostmi svědčí o dobrém matematickém základu. Oceňuji: - Normalizaci pohybu: Uvádíš "normalizovaná diagonála", což je častá chyba začátečníků (že se šikmo pohybují rychleji), ty jsi ji vyřešil. - Mechaniku Knockbacku a imunity: Práce s časem (snímky/frames) místo prostého čekání je správná cesta pro hry v Pygame. - Magnetismus XP orbů: Výpočet vektoru přitahování k hráči v určitém radiusu (150 px) je pokročilejší a funkční mechanika. - Škálování obtížnosti: Zvyšování HP a poškození bosse s každou vlnou ukazuje na komplexní uvažování o herním designu.
Pár drobností k opravě: V dokumentaci píšeš „vylepšeni grafiky charaktera“ (správně česky charakteru/postavy) a „fixnuti bugs“ (míchej raději méně anglicismů do českých vět).
Celkem získáno bodů: [16 / 80%] z 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V popisu mechaniky útoku uvádíš, že meč zasáhne všechny nepřátele ve 180° výseči kolem směru myši – jakým konkrétním matematickým způsobem v kódu kontroluješ, že se nepřítel nachází právě v tomto správném úhlu, a jak jsi zajistil, aby útok nezasáhl i nepřátele, kteří jsou sice v dosahu (radius), ale stojí za zády hráče?