Jarmil
Období: Týden 11/2026 (od 15.03.) Skupina: tria URL: https://github.com/samuelmichnik-oss/Jarmil.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) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-03-16 07:01: Přidaní dokumentace hry
- 2026-03-16 07:04: Doplněni v readme
- 2026-03-16 07:06: Update README.md
- 2026-03-16 07:26: Popis změn
- 2026-03-16 07:38: Uprava adresařu
- 2026-03-16 07:42: Uprava složky
- 2026-03-16 08:58: Uprava složek
- 2026-03-16 09:00: Uprava složek
- 2026-03-16 09:01: smazani duplicitních souboru
- 2026-03-16 09:10: Oprava pohybu hada, přejmenování proměnných do angličtiny, vylepšení logiky jídla
- 2026-03-16 09:13: Přidání skore ve hře
- 2026-03-16 09:17: Přidání hlavního menu pro hru
- 2026-03-18 07:18: Změněni readme
Removed control instructions from the README. - 2026-03-21 20:58: Update README.md for language and formatting
Musel jsem sformatovat par veci na dokončeni readme.
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ů | 14 |
| Změněné soubory | 7 |
| Počet přid./odeb. řádků kódu | 951 |
Komentář a zpětná vazba od AI
Ahoj Samuele, jako tvůj asistent jsem prošel tvou práci za uplynulý týden. Udělal jsi velký kus práce na logice hry a refaktoringu kódu. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]:
V pondělí 16. 3. jsi byl velmi aktivní a popisy jako „Přidání hlavního menu“, „Oprava pohybu hada“ nebo „Přidání skóre“ jsou příkladné. Bohužel u ostatních commitů (zejména kolem úprav složek) se popisy opakují nebo jsou strohé („Uprava složek“, „Popis změn“). Také se snaž sjednotit jazyk – mícháš češtinu a angličtinu. V commitu z 18. 3. máš gramatickou chybu: „Změněni readme“.
2. Smysluplnost komentářů v kódu [4 body]:
Komentáře v kódu používáš správně k oddělení logických bloků (Initialization, Game objects, Functions). Oceňuji, že jsi převedl komentáře a názvy proměnných do angličtiny, což je v programování standard. Komentáře jsou však zatím spíše popisné (např. # Draw snake). Příště se zkus zaměřit na vysvětlení „proč“ daná část kódu dělá to, co dělá, u složitějších pasáží.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]:
Struktura repozitáře je v pořádku. Kód Snake_hra_projekt.py je umístěn ve vlastní složce Snake_game, což chválím. README.md obsahuje všechny důležité sekce (popis, technologie, spuštění). Jen pozor na detaily v textu: „konec hry při nabourani“ (chybí diakritika). Odstranění souboru Projekt.md a přesun informací do hlavního README byl správný krok pro přehlednost.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Tady tě musím pochválit nejvíce. Udělal jsi velký pokrok v organizaci kódu:
* Modularita: Převedl jsi hru z lineárního skriptu na funkce.
* Předávání parametrů: Funkce jako draw_objects(snake, food, score) už nespoléhají jen na globální proměnné, což je známka pokročilejšího uvažování.
* Nová logika: Úspěšně jsi implementoval game_over_screen s možností restartu hry pomocí klávesy 'R'. To vyžadovalo pochopení zacházení s herní smyčkou a událostmi.
* Ošetření chyb: Logika pohybu, kde kontroluješ, aby se had nemohl otočit o 180 stupňů přímo do sebe, je implementována správně.
Celkem získáno bodů: [16 / 80%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V poslední úpravě jsi změnil funkci
move_snaketak, že vrací seznamsnakei booleovskou hodnotuate_food– vysvětli mi, proč je z hlediska chování Pythonu nutné hodnotuate_foodvracet pomocíreturn, aby se skóre v hlavní smyčce správně aktualizovalo, zatímco u seznamusnakeby se jeho pohyb (změna obsahu) projevil i bez toho, aniž bys ho z funkce vracel?