Jarmil
Období: Týden 20/2026 (od 17.05.) Skupina: tria URL: https://github.com/samuelmichnik-oss/Jarmil.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) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-05-17 19:38: Remove unnecessary whitespace and clean up code
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 6 / 20 b. (30%) |
| Náročnost projektu (Index) | 1 |
| Počet commitů | 1 |
| Změněné soubory | 1 |
| Počet přid./odeb. řádků kódu | 6 |
Komentář a zpětná vazba od AI
Dobrý den, jako pedagogický asistent jsem vyhodnotil tvou práci na projektu "Snake Game" za uplynulý týden. Níže uvádím podrobné hodnocení:
1. Smysluplnost popisů u commitů [1 bod]:
V tomto týdnu byl zaznamenán pouze jeden commit. Přestože je jeho popis srozumitelný a odpovídá provedené změně (odstranění bílých znaků), z hlediska vývoje projektu se jedná o minimální aktivitu. Pro vyšší hodnocení je zapotřebí vykazovat kontinuální práci na logice programu, nikoliv pouze kosmetické úpravy.
2. Smysluplnost komentářů v kódu [3 body]:
Komentáře v kódu sice existují a popisují základní importy a volání funkcí (např. # importuje knihovnu pygame), jsou však velmi triviální a popisují spíše syntaxi jazyka než samotnou logiku tvého řešení. Tento týden navíc nepřibyl žádný nový komentář, který by vysvětloval fungování hry.
3. Kvalita a srozumitelnost dokumentace (README.md, _projekt.md) a struktura repozitáře [1 bod]:
Struktura repozitáře je v pořádku – soubory s kódem jsou správně umístěny v samostatné složce /Snake_game/, což chválím. Nicméně dokumentace v README.md je extrémně strohá. Obsahuje pouze název projektu a datum zahájení, ale chybí jakýkoliv popis funkcionality, návod na spuštění nebo cíle projektu. Soubor Projekt.md nebyl v ukázce blíže specifikován, což snižuje informační hodnotu dokumentace.
4. Logika řešení a přemýšlení studenta v Pythonu (progrese kódu) [1 bod]:
V uplynulém týdnu nedošlo k žádnému věcnému posunu v kódu. Jedinou aktivitou bylo smazání tří prázdných řádků a úprava volání funkce draw_bg(). Při této úpravě jsi navíc zanikl do kódu chybu v odsazení:
+ draw_bg() zde je chyba (v Pythonu je nesprávné odsazení kritickou chybou, která způsobí pád programu). Vzhledem k tomu, že úpravy jsou pouze kosmetické a neposouvají projekt směrem k cíli, uděluji minimální počet bodů.
Celkem získáno bodů: [6 / 30%] ze 20 možných
DIFFICULTY_INDEX: [1]
Kontrolní otázka k obhajobě
Všiml jsem si, že jsi v posledním commitu u volání funkce
draw_bg()změnil odsazení oproti okolnímu kódu – mohl bys mi vysvětlit, proč jsi tam tu jednu mezeru navíc přidal a jaký konkrétní dopad má tato změna na spuštění tvého programu?