TheReader
Období: Týden 10/2026 (od 08.03.) Skupina: tria
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 |
Vypočtený Index za tento týden: 280
Týdenní Index Náročnosti dodaných skriptů (1-5): 4
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 7 |
| Počet změněných souborů | 10 |
| Počet přid./odeb. řádků kódů | 302 |
Přehled commitů
- 2026-03-08 17:47: added_snake
- 2026-03-09 09:06: přidal komentáře a upravil README.md
- 2026-03-12 18:57: added start menu and a save function
- 2026-03-12 19:03: add start menu and add a save function
- 2026-03-13 13:27: ukazka
- 2026-03-13 13:32: ukazka 2
- 2026-03-14 18:49: added an achievement window to snake.py, started a project called GD (currently under revision). will update documentation in the future.
3. Hodnocení asistentem AI (Logika a úsilí)
Ahoj, jsem tvůj asistent pro výuku Pythonu. Prošel jsem tvůj repozitář a kód, který jsi za poslední týden vytvořil. Oceňuji, že jsi se pustil do pokročilejších konceptů, jako je práce s externími daty (JSON) a tvorba uživatelského rozhraní pomocí tříd.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]
Většina tvých commitů je jasná a srozumitelná (např. "added start menu and a save function"). To je skvělá praxe. Bohužel jsi to pokazil dvěma commity s názvy "ukazka" a "ukazka 2". Tyto popisy jsou nicneříkající a v profesionálním prostředí by ti neprošly. Příště se jim vyhni.
2. Smysluplnost komentářů v kódu [4 body]
Komentáře v kódu používáš správně k označení logických bloků (např. # loading saves, # button settings). Jsou stručné a věcné. Chybí mi však občasné vysvětlení "proč" něco děláš, nejen "co" tam je (např. u složitější logiky vykreslování uložených pozic). Také si dej pozor na míchání češtiny a angličtiny – v snake.py máš anglické komentáře, ale v dřívějších commitech byly české.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Strukturu repozitáře chválím – dodržel jsi pravidlo "jeden projekt = jedna složka" a v rootu máš jen README. Nicméně v samotné dokumentaci jsou velké nedostatky:
* Soubor snake_projekt.md je nedokončený a končí uprostřed slova: "3. Čte stisknuté š".
* V souboru GD_projekt.md máš překlep: "currnetly".
* Soubor proj2_projekt.md je úplně prázdný.
* README.md v hlavní složce obsahuje jen seznam dat, což je pro uživatele málo informativní.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]
Tady jsi odvedl kus práce! Velmi oceňuji tyto body:
* OOP přístup: Vytvoření třídy Button pro tlačítka v Pygame svědčí o dobrém pochopení objektů.
* State Machine: Správně přepínáš mezi stavy menu, game, saves atd.
* Perzistence dat: Použití modulu json pro ukládání pozice hada je vynikající krok vpřed.
* Vylepšení ovládání: Přidání WASD k šipkám je uživatelsky přívětivé.
Našel jsem však jednu logickou chybu v souboru snake.py:
* Při výpisu upgradů používáš v řetězci znak "\n" (např. "- No upgrades implemented yet.\n- Use this screen..."). Knihovna pygame.font.render standardně nepodporuje víceřádkový text a tento znak nevykreslí jako nový řádek, ale jako nečitelný symbol nebo jej ignoruje. Pro více řádků musíš volat render pro každý řádek zvlášť.
Celkem získáno bodů: [15 / 75%] ze 20 možných
DIFFICULTY_INDEX: [4]