Katana
Období: Týden 12/2026 (od 22.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: 276
Týdenní Index Náročnosti dodaných skriptů (1-5): 3
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 3 |
| Počet změněných souborů | 7 |
| Počet přid./odeb. řádků kódů | 441 |
Přehled commitů
- 2026-03-23 07:23: Přidána hra Snake a dokumentace projektu
- 2026-03-25 08:17: Přidána složka s projektem a upraven README
- 2026-03-26 13:14: Přidána struktura projektu Tetris a upraven README
3. Hodnocení asistentem AI (Logika a úsilí)
Ahoj, jako tvůj pedagogický asistent jsem prošel tvůj repozitář a kód, který jsi za poslední týden vyprodukoval. Je vidět, že jsi odvedl velký kus práce – tři nové projekty (Snake, Turnbattle, Tetris) během jednoho týdnu je velmi ambiciózní tempo.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [3 body]
Zprávy jsou jasné, stručné a odpovídají tomu, co se v daný den v repozitáři dělo. Oceňuji, že ke každému datu zápisu v README odpovídá i konkrétní commit, což svědčí o dobré disciplíně. - Splněno.
2. Smysluplnost komentářů v kódu [5 bodů]
V kódu se orientuješ dobře a používáš komentáře pro logické bloky (inicializace, barvy, funkce, třídy). V projektu Turnbattle a Snake jsi dokonce začal používat i docstringy (např. """Vykreslení hráče na obrazovku"""), což je výborný zvyk.
- Drobné vytknutí: Komentáře jsou někdy až příliš popisné u zjevných věcí (např. # Barvy), ale u složitější logiky (např. v Tetrisu u kolizí) jsou adekvátní.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Dokumentace (_projekt.md soubory) je na vysoké úrovni. Každý projekt má jasný cíl, popis funkcí i technické detaily. README v kořenu slouží jako skvělý rozcestník.
- Vážná výtka ke struktuře: Porušil jsi pravidlo o adresářové struktuře. Soubory <span style='color: red;'>/Kalkulacka_GUI_Kod.py</span> a <span style='color: red;'>/Kalkulacka_GUI_Dokumentace</span> leží volně v rootu repozitáře místo toho, aby byly ve vlastní složce (např. /Kalkulacka/). Ostatní projekty jsou už v pořádku.
4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]
Progrese je vidět především v přechodu k objektově orientovanému programování (třídy Player v Turnbattle a Piece v Tetrisu). Práce s knihovnou pygame je správná, zvládáš herní smyčku i vykreslování.
Všiml jsem si však několika nedostatků:
- Snake: V souboru snake.py máš nedokončenou logiku na konci souboru:
python
# Kolize se sebou samým
if head in snake[1:]:
<span style='color: red;'>zde je chyba</span> (chybí akce, např. running = False)
- Turnbattle: V dokumentaci Turnbattle_projekt.md uvádíš, že projekt obsahuje soubory main.py, game.py, player.py atd., a že nepřítel má náhodné chování. Ve skutečnosti je ale veškerý kód v jednom souboru Turnbattle.py a logika nepřítele (třída Enemy) úplně chybí – hráč se jen pohybuje po mřížce a "vyhraje", když stoupne na stejné políčko jako druhý hráč. Dokumentace tedy neodpovídá odevzdané realitě.
- Tetris: Logika clear_rows a collision je implementována velmi čistě a efektivně pomocí generátorové notace seznamů.
Celkem získáno bodů: [16 / 80%] ze 20 možných
Slovní shrnutí: Odevzdal jsi velké množství kódu, který je až na drobné chyby funkční a velmi přehledný. Dej si pozor na soulad mezi tím, co napíšeš do dokumentace a co skutečně naprogramuješ. Také si ukliď soubory s Kalkulačkou v kořenové složce.
DIFFICULTY_INDEX: [3]