Vojcinn
Období: Týden 11/2026 (od 15.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) | ✅ SPLNĚNO |
Vypočtený Index za tento týden: 252
Týdenní Index Náročnosti dodaných skriptů (1-5): 3
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 7 |
| Počet změněných souborů | 5 |
| Počet přid./odeb. řádků kódů | 611 |
Přehled commitů
- 2026-03-16 07:21: přepsání dokumentace
- 2026-03-16 07:21: přepsání dokumentace
- 2026-03-16 07:31: popis projektů
Updated project titles and added project details. - 2026-03-19 21:40: Add files via upload - 2026-03-20 12:47: textová dokumentace na dungeon quest
Added project documentation for Dungeon Quest, detailing gameplay mechanics, controls, and technical implementation. - 2026-03-20 12:49: textová dokumentace na dungeon quest
Podrobný popis tohoto projektu. - 2026-03-21 18:53: přidání projektu
popis
3. Hodnocení asistentem AI (Logika a úsilí)
Dobrý den, jako tvůj pedagogický asistent jsem prošel tvou práci na projektu Dungeon Quest a dalších souborech v repozitáři za uplynulý týden. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]:
Většina tvých zpráv je srozumitelná (např. „textová dokumentace na dungeon quest“), ale srážím bod za zprávu „Add files via upload“, což je automatický text GitHubu, který nic neříká o obsahu změn. Také se ti tam objevuje duplicita „přepsání dokumentace“ ve stejný čas. Příště se zkus více zaměřit na to, co konkrétně jsi v kódu změnil.
2. Smysluplnost komentářů v kódu [2 body]:
V kódu používáš pouze základní strukturní oddělovače (např. # Hráč, # Datové struktury). To pomáhá orientaci, ale zcela chybí vysvětlující komentáře u složitější logiky, jako je výpočet XP nebo algoritmus útoku v metodě attack. Jako začátečník bys měl komentovat, proč daný blok kódu dělá to, co dělá, aby se v něm vyznal i někdo jiný (nebo ty za měsíc).
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]:
Tady musím pochválit dodržení struktury. Každý projekt má svou složku, soubory s kódem nejsou v rootu a mají jasné názvy. Dokumentace v dungeon_quest_projekt.md je velmi podrobná a přehledná. Pozor jen na překlepy v hlavním README.md:
- | 03 | <span style='color: red;'>duegon quest</span> | 21.03.2026 | (správně: Dungeon Quest).
4. Logika řešení a přemýšlení studenta v Pythonu [6 bodů]:
Zvolil jsi projekt s vysokou náročností (Scope). Použití třídy Player pro správu stavu postavy je vynikající krok a ukazuje, že rozumíš objektově orientovanému přístupu. Stejně tak oceňuji práci s vnořenými datovými strukturami (seznamy slovníků pro nepřátele).
Bohužel body musím strhnout za to, že odevzdaný kód je nekompletní:
- Metoda use_potion v souboru dungeon_quest.py končí uprostřed definice:
<span style='color: red;'>... zde kód náhle končí a chybí celá herní smyčka i zbytek logiky</span>.
- Kvůli tomu není program v aktuálním stavu spustitelný, což je u odevzdání zásadní problém. Logika, kterou jsi ale stihl napsat (XP systém, damage variance), je velmi kvalitní.
Celkem získáno bodů: [12 / 60%] ze 20 možných
Slovní hodnocení:
Strukturálně máš repozitář v naprostém pořádku a tvůj posun k objektovému programování (třídy) je skvělý. Projekt Dungeon Quest má velký potenciál. Dej si však pozor na kontrolu odevzdávaných souborů – pravděpodobně jsi zapomněl nahrát zbytek řádků v souboru dungeon_quest.py. Také si pohlídej drobné překlepy v dokumentaci. Pokud kód dokončíš, bude to velmi silná práce.
DIFFICULTY_INDEX: [3]