Vojcinn
Období: Týden 22/2026 (od 31.05.) Skupina: tria URL: https://github.com/easymoneysniper713/Vojcinn.git
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 |
2. Přehled commitů
- 2026-06-01 06:46: Oprava dungeon_quest.py
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 5 / 20 b. (25%) |
| Náročnost projektu (Index) | 1 |
| Počet commitů | 1 |
| Změněné soubory | 1 |
| Počet přid./odeb. řádků kódu | 2 |
Komentář a zpětná vazba od AI
1. Smysluplnost popisů u commitů [1 bod]:
V uplynulém týdnu byl zaznamenán pouze jeden commit s popisem „Oprava dungeon_quest.py“. Tento popis je velmi obecný a neříká nic o tom, co konkrétně bylo opraveno nebo změněno (v tomto případě šlo o úpravu herních statistik zbroje). Pro lepší přehlednost by bylo vhodnější psát konkrétněji, např. „Úprava obrany u kožené zbroje“.
2. Smysluplnost komentářů v kódu [1 bod]:
V rámci provedené změny v souboru dungeon_quest.py nebyl přidán žádný nový komentář, který by vysvětloval logiku nebo důvod změny hodnoty. V kódu vidíme pouze oddělovací řádky z minula. U větších projektů, jako je tvůj Dungeon Quest, je důležité komentovat i datové struktury (např. v jakých jednotkách je obrana počítána).
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:
Dokumentace v souborech _projekt.md je velmi podrobná a ambiciózní, což chválím. Nicméně v ní dochází k nekonzistenci: v souboru hadej_cislo_projekt.md odkazuješ na spuštění souboru hadani_cisla.py <span style='color: red;'>zde je chyba</span>, ale tvůj soubor se ve skutečnosti jmenuje 02_hadej_cislo.py. V dokumentaci k Dungeon Questu máš také překlep v nadpisu „Artejakty“.
Z hlediska struktury repozitáře jsi porušil pravidlo o umístění souborů. Soubory /game_stats.json a /požadavky.md leží volně v kořenovém adresáři (rootu). Každý projektový soubor musí být ve své složce. Navíc složka __pycache__ do repozitáře nepatří, měla by být ignorována (např. pomocí souboru .gitignore).
4. Logika řešení a přemýšlení studenta v Pythonu [2 body]:
Práce za tento týden vykazuje minimální progresi. Jedinou změnou v kódu byla úprava jedné číselné hodnoty ve slovníku ARMORS (změna obrany kožené zbroje z 2 na 3). Podle zadání jde o extrémně triviální úpravu, která nijak nerozvíjí logiku tvého rozsáhlého cíle popsaného v dokumentaci (soubojový systém, questy, obchod, společníci). Pro naplnění cíle projektu "Dungeon Quest" je potřeba začít implementovat slíbené funkce, nikoliv pouze měnit konstanty.
Celkem získáno bodů: [5 / 25%] ze 20 možných
DIFFICULTY_INDEX: 1
Kontrolní otázka k obhajobě
V jaké konkrétní funkci v souboru dungeon_quest.py využíváš hodnotu z dictionary ARMORS a jak přesně máš v kódu ošetřeno, aby v případě, že je hodnota zbroje vyšší než útok nepřítele, nedocházelo k přičítání životů hráči?