Vojcinn
Období: Týden 18/2026 (od 03.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: 168
Týdenní Index Náročnosti dodaných skriptů (1-5): 3
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 2 |
| Počet změněných souborů | 1 |
| Počet přid./odeb. řádků kódů | 63 |
Přehled commitů
- 2026-05-05 19:24: Do hlavní herní smyčky jsem vložil nový event: mysticka fontana
- 2026-05-09 20:30: přidal jsem mystickou truhlu, kterou hráč může otevřít nebo obejít
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ů [3 body]:
Splněno. Commity z 5. 5. a 9. 5. jasně a stručně popisují, co bylo v kódu změněno (přidání mystické fontány a truhly). To je ideální praxe, která usnadňuje orientaci v historii projektu.
2. Smysluplnost komentářů v kódu [6 bodů]:
Vynikající. Používáš docstringy u funkcí (např. u mystic_chest), což je v Pythonu standardem pro dokumentaci. Sekce kódu máš přehledně oddělené komentářovými bloky a logické kroky (např. kontrola synergií) jsou jasně vysvětleny. Oceňuji i opravu gramatické chyby v textovém výstupu u synergií.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:
Dokumentace (README.md a projektové soubory) je velmi podrobná a přehledná. Bohužel však dochází k porušení pravidel o struktuře repozitáře.
- Konkrétní výtka: V kořenovém adresáři (rootu) se nacházejí soubory /game_stats.json a /požadavky.md, které by měly být buď součástí konkrétní složky projektu, nebo v případě požadavků v dedikované složce pro dokumentaci. Soubor game_stats.json se navíc duplikuje (je v rootu i ve složce projektu), což vytváří nepořádek.
- Ostatní soubory jsou ve správných složkách a mají logické názvy.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Progrese v kódu je velmi dobrá. Implementace mystic_chest ukazuje dobrou práci s náhodou (random.random, random.choice) a správu stavu objektu player (zlato, inventář, artefakty).
- Kladně hodnotím: Logiku kontroly, zda hráč už artefakt má, a následnou kompenzaci zlatem. Také provázání s novým systémem synergií je pokročilé.
- Chyby a nedostatky:
- V úpravě z 9. 5. máš v textu překlep: "Dostál jsi 50 zlatých za něj." správně má být "Dostal jsi".
- Pravděpodobnostní větvení (řetězec if/elif s proměnnou roll) začíná být trochu nepřehledné a náchylné k chybám při ladění balancu hry. Do budoucna by bylo lepší uvažovat o systému tabulky pravděpodobnosti (dictionary nebo vážený výběr přes random.choices).
- V rámci refaktoringu jsi odstranil výchozí else větev (původně "Místnost je klidná"), což může vést k tomu, že při specifických hodnotách roll se neprovede žádná akce, pokud nejsou intervaly přesně pokryty.
Celkem získáno bodů: [18 / 90%] ze 20 možných
DIFFICULTY_INDEX: [3]