Jarmil
Období: Týden 12/2026 (od 22.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-23 06:46: Přidánaní par věci do
Aktualizovány rozměry hry, přidána podpora zvuku a implementovány překážky a bonusy. - 2026-03-23 06:58: Revise README with project details and progress
Updated project description and added progress history. - 2026-03-23 09:20: Refactor Snake game with new features and optimizations - 2026-03-23 09:28: Refactor Snake game code and improve structure - 2026-03-26 10:41: Update date for pause and highscore features
Změněni času v readme - 2026-03-27 12:01: Fix formatting of game description in 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ů | 6 |
| Změněné soubory | 2 |
| Počet přid./odeb. řádků kódu | 411 |
Komentář a zpětná vazba od AI
Dobrý den, jako tvůj asistent jsem prošel tvou práci na projektu Snake za uplynulý týden. Je vidět, že jsi odvedl velký kus práce na struktuře kódu a implementaci nových herních mechanik. Zde je mé hodnocení:
1. Smysluplnost popisů u commitů [2 body]
Většina tvých commitů je srozumitelná a popisuje provedené změny (např. "Refactor Snake game code"). Body však strhávám za nekonzistenci v jazyce (míchání češtiny a angličtiny) a za nedbalost v posledních commitech. Například zpráva "Přidánaní par věci do" obsahuje překlep a je nedokončená, což ztěžuje orientaci v historii verzí.
2. Smysluplnost komentářů v kódu [5 bodů]
Kód jsi velmi pěkně rozdělil do sekcí pomocí oddělovačů (např. # -------------------), což výrazně zlepšuje čitelnost. Komentáře u funkcí a důležitých bloků (jako # High score file nebo # Check collisions) jsou užitečné. Plný počet bodů neuděluji, protože některé komentáře jsou až příliš triviální (např. # Snake těsně nad cyklem, který vykresluje hada) a zasloužily by si spíše vysvětlení "proč" se něco děje, než jen "co" tam je.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]
Struktura repozitáře je v pořádku. Hra i pomocné soubory jsou v samostatné složce /Snake_game/, což chválím – dodržel jsi pravidlo o čistotě kořenového adresáře. README obsahuje tabulku s historií pokroku, což je velmi přehledné. Jen pozor na konzistenci: v README uvádíš u posledního bodu datum 24. 3., ale commity jsou z 23. 3.
4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]
Implementace pauzy, úvodní obrazovky (intro_screen) a generování hvězdného pozadí (draw_galaxy_background) ukazuje na dobrou úroveň algoritmizace. Použití os.path.exists pro kontrolu souboru s highscore je správné a robustní řešení.
Mám však výhrady k několika logickým částem:
- V kódu pro zvuk máš chybu: eat_sound = pygame.mixer.Sound(pygame.mixer.Sound(pygame.mixer.get_init())). Funkce get_init() vrací nastavení mixéru, nikoliv cestu k souboru, zde je chyba, která by pravděpodobně způsobila pád programu při pokusu o načtení zvuku.
- V generování hvězd používáš random.randint(0, WIDTH), což může vrátit index rovný šířce okna, což by u některých metod vykreslování mohlo být mimo rozsah (bezpečnější je WIDTH-1).
- Oceňuji ale refaktoring spawn_obstacles pomocí "list comprehension", to je velmi pythonovské.
Celkem získáno bodů: [16 / 20] (80%)
Slovo asistenta: Práce na projektu pokročila přesně podle tvého plánu. Hra už vypadá jako ucelený produkt. Příště si dej větší pozor na čistotu commit zpráv a na to, abys v kódu nenechával nefunkční fragmenty (jako ten pokus o inicializaci zvuku).
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
Proč jsi ve funkci
draw_galaxy_backgroundzměnil horní hranici urandom.randintnaWIDTH-1aHEIGHT-1a co konkrétně by se v aplikaci stalo, kdyby tam padla hodnota přesně rovná šířce nebo výšce okna?