Jarmil

Období: Týden 18/2026 (od 03.05.) 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	❌ NESPLNĚNO
Projektová dokumentace (README, projekt.md)	❌ NESPLNĚNO

2. Přehled commitů

2026-05-04 05:46: Implement star movement in the game

Added functionality to update star positions in the game. - 2026-05-04 08:05: Refactor and clean up Snake game code - 2026-05-04 08:13: code modification and adding a store

Refactor code for readability and add shop system - 2026-05-07 07:58: Remove unnecessary blank lines in Snake_hra_projekt.py

3. Výsledky AI analýzy kódu

Metrika	Hodnota
Celkové body (AI)	18 / 20 b. (90%)
Náročnost projektu (Index)	3
Počet commitů	4
Změněné soubory	1
Počet přid./odeb. řádků kódu	629

Komentář a zpětná vazba od AI

Ahoj, jsem tvůj asistent pro výuku Pythonu. Prostudoval jsem tvůj kód a tvůj postup za uplynulý týden. Je vidět, že jsi na projektu zapracoval a posunul jsi hru Snake o úroveň výš, zejména přidáním herního obchodu.

Zde je tvé hodnocení:

1. Smysluplnost popisů u commitů [3 body]

Tvé commity jsou velmi dobře popsané. Používáš jasné a stručné názvy, které odpovídají tomu, co se v kódu skutečně změnilo (např. „Implement star movement“, „Refactor code for readability“). Oceňuji i rozšiřující popis u druhého commitu. To je skvělá praxe, která usnadňuje orientaci v historii projektu.

2. Smysluplnost komentářů v kódu [6 bodů]

V této kategorii jsi odvedl perfektní práci. Téměř každý řádek má svůj komentář, což je v této fázi výuky velmi užitečné pro tebe i pro kohokoliv, kdo by tvůj kód četl. Komentáře jsou věcné a v češtině, což pomáhá k lepší srozumitelnosti struktury hry (např. vysvětlení směrů v dictionary nebo principu snake.insert).

3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]

Pravidla pro strukturu jsi dodržel. Projekt má vlastní složku /Snake_game/ a soubory jsou logicky pojmenované. README.md obsahuje základní informace a v repozitáři se dá snadno orientovat.

4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]

Tvůj posun je viditelný. Implementace shop systému jako samostatné funkce s vlastní smyčkou je dobrý nápad. Refactoring kódu zpřehlednil hlavní smyčku. Nicméně jsem narazil na pár logických nedostatků a chyb:

Nedokončená logika: V obchodě máš možnost koupit "Smaller snake" (size_lvl), ale tato proměnná se v herní logice (pohyb hada, zkracování ocasu) nikde neprojevuje. Je to definované, ale nevyužité.
Chyba v power-upu: Na konci souboru při pokusu o spawn power-upu voláš funkci špatně: power = <span style='color: red;'>rand_cell</span>. Chybí ti tam závorky rand_cell(), aby se funkce spustila a vrátila souřadnice. Takhle do proměnné power uložíš pouze odkaz na tu funkci.
Zmizelé překážky: Všiml jsem si, že v nové verzi kódu jsi úplně odstranil logiku překážek (obstacles), která v té starší byla. Pokud to byl záměr pro zjednodušení, je to v pořádku, ale hra tím trochu ztratila na obtížnosti.

Celkem získáno bodů: [18 / 90%] ze 20 možných

DIFFICULTY_INDEX: [3]

Kontrolní otázka k obhajobě

V rámci tvého nového shopu si hráč může koupit upgrade „Smaller snake“, který zvyšuje proměnnou size_lvl – kde přesně v logice hry tuto proměnnou následně využíváš k tomu, aby se tělo hada skutečně zkrátilo nebo zmenšilo?