Přezdívka
Období: Týden 17/2026 (od 26.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 | ❌ NESPLNĚNO |
| Rozestup alespoň 12h mezi 3 commity | ❌ NESPLNĚNO |
| Projektová dokumentace (README, projekt.md) | ✅ SPLNĚNO |
2. Přehled commitů
- 2026-04-27 06:07: dokončení vysvětlení kodu
- 2026-05-02 20:39: udělani složky gitignore
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 12 / 20 b. (60%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 2 |
| Změněné soubory | 3 |
| Počet přid./odeb. řádků kódu | 4214 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj asistent a zhodnotil jsem tvou práci na projektech Snake a 2D Survival Game za uplynulý týden. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [1 bod]
Záznamy o změnách jsou tento týden velmi strohé (pouze dva commity). Oceňuji snahu o dokumentaci kódu, ale zpráva „udělani složky gitignore“ je technicky nesprávná – .gitignore má být soubor, nikoliv složka. Navíc se ti do repozitáře dostala složka __pycache__, což znamená, že tvůj gitignore nefunguje správně nebo jsi soubory přidal dříve, než jsi ho nastavil. Příště se pokus commity více kouskovat podle toho, na jaké konkrétní funkci zrovna pracuješ.
2. Smysluplnost komentářů v kódu [4 body]
V repozitáři se nachází soubor vysvetleni_kodu_new.py, což naznačuje, že se snažíš kód dopodrobna popsat. To je u takto komplexního projektu, jako je tvůj Snake s upgrady, velmi důležité. Nicméně v samotných souborech .py (např. snake.py) by měly být komentáře přímo u logických bloků, aby se v nich dalo orientovat bez otevírání vedlejších dokumentů. Za snahu o "vysvětlení kódu" jako samostatnou aktivitu dávám solidní počet bodů, ale v samotném zdrojovém kódu by jich mohlo být více.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Struktura složek je v pořádku – každý projekt má svou vlastní složku, což chválím. Dokumentace v snake_projekt.md je výborná a velmi detailní.
Mám však dvě výtky:
1. Soubor README.md: Obsah hlavního README je formátován velmi podivně (mezery mezi každým písmenem), což zhoršuje čitelnost.
2. Smetí v repozitáři: V repozitáři vidím složku /snake/__pycache__/. Tyto soubory do repozitáře nepatří, protože se generují automaticky při spuštění Pythonu. Musíš je smazat a správně nastavit .gitignore.
4. Logika řešení a přemýšlení studenta v Pythonu [6 bodů]
Tvůj projekt Snake má velmi ambiciózní cíl (systém debuffů, persistence dat v .txt souborech, upgrady). Práce se soubory jako balance.txt nebo upgrade.txt ukazuje, že zvládáš ukládání a načítání stavu hry, což je skvělá dovednost. Logika "každých 10 bodů výběr karty" je zajímavý herní prvek, který vyžaduje dobrou práci s podmínkami a událostmi v pygame. Body strhávám za to, že tento týden byla aktivita zaměřena spíše na popisy než na nový kód, a za chybu v ignorování systémových souborů.
Celkem získáno bodů: [12 / 60%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V commitu z 2. května uvádíš vytvoření „složky gitignore“, ale v projektu přesto zůstal soubor
snake.cpython-39.pyc– můžeš mi vysvětlit, jak jsi tento ignorovací mechanismus nastavil a proč v seznamu souborů chybí standardní soubor.gitignore?