Vojcinn
Období: Týden 19/2026 (od 10.05.) Skupina: tria
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 |
Vypočtený Index za tento týden: 200
Týdenní Index Náročnosti dodaných skriptů (1-5): 4
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 1 |
| Počet změněných souborů | 1 |
| Počet přid./odeb. řádků kódů | 97 |
Přehled commitů
- 2026-05-15 17:17: oprava
3. Hodnocení asistentem AI (Logika a úsilí)
Zde je tvé hodnocení za uplynulý týden na projektu Dungeon Quest a dalších aktivitách v repozitáři.
1. Smysluplnost popisů u commitů [1 bod]
Zde mám velkou výhradu. V celém týdnu jsi vytvořil pouze jeden commit s velmi strohým popisem "oprava". Commit zpráva by měla jasně říkat, co jsi v kódu změnil (např. "přidání funkce pro ukládání a načítání hry a refaktoring hlavní smyčky"). Takto zpětně nikdo (ani ty) nepozná, co se v dané verzi změnilo.
2. Smysluplnost komentářů v kódu [5 bodů]
V kódu používáš docstringy u nových funkcí (save_game, load_game), což je chvályhodné. Jsou stručné a jasné. V samotném těle funkcí by se však hodilo pár komentářů k tomu, proč ukládáš zrovna tyto konkrétní atributy nebo jak funguje ošetření chyb při načítání. Celkově je ale kód díky výpisům pro hráče docela čitelný.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Dokumentace v souborech _projekt.md je zpracována velmi pěkně a podrobně, což ti chválím. Bohužel však porušuješ pravidla pro strukturu repozitáře. V hlavní složce (rootu) se ti povalují soubory:
- /game_stats.json (tento soubor máš navíc duplicitně i ve složce projektu)
- /požadavky.md
Všechny soubory patřící k projektu "Dungeon Quest" by měly být v jeho složce. Udržuj v kořenovém adresáři pouze hlavní README.md.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]
Tady jsi udělal velký kus práce. Implementace ukládání a načítání přes modul json je logická a správná. Oceňuji zejména:
- Refaktoring: Všiml jsi si, že pro načtení hry musíš kód rozdělit a vytvořil jsi funkci game_loop(player), kterou voláš jak při nové hře, tak při načtení. To svědčí o dobrém algoritmickém přemýšlení.
- Ošetření chyb: Použití bloku try-except u načítání souboru (ošetření FileNotFoundError) je velmi profesionální a zabrání pádu programu, pokud soubor neexistuje.
- Drobné vady: Uvnitř funkcí save_game a load_game pokaždé znovu provádíš import json. Je lepším zvykem dávat všechny importy na úplný začátek souboru. Také pozor na to, že cesta k souboru save_game.json je relativní, takže záleží na tom, odkud skript spouštíš.
Celkem získáno bodů: [15 / 75%] ze 20 možných
STUPNICE NÁROČNOSTI (Index 1-5): DIFFICULTY_INDEX: [4]