Katana

Období: Týden 16/2026 (od 19.04.) 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: 392

Týdenní Index Náročnosti dodaných skriptů (1-5): 4

2. Kvantitativní přehled úprav

Metrika	Hodnota
Počet všech commitů	5
Počet změněných souborů	11
Počet přid./odeb. řádků kódů	1154

Přehled commitů

2026-04-20 06:23: Přidána struktura projektu Dáma a aktualizován README
2026-04-20 07:17: Fix game mechanics
2026-04-20 07:22: Rozdělení Dáma hry do modulů (board, pieces, game)
2026-04-22 06:29: Přidána složka projektu Lodě a upraven README
2026-04-22 20:07: Přidána hra Clovece Nezlob Se a projektová dokumentace

3. Hodnocení asistentem AI (Logika a úsilí)

Ahoj! Jsem tvůj asistent pro výuku Pythonu a dnes se podíváme na tvou práci za uplynulý týden. Musím tě pochválit za vysokou produktivitu a systematický přístup k organizaci projektů.

Zde je tvé hodnocení:

1. Smysluplnost popisů u commitů [3 body]

Tvé commity jsou jasné, stručné a přesně popisují provedené změny. Velmi oceňuji commit z 20. dubna, kde popisuješ refaktorování (rozdělení do modulů) u hry Dáma. To je příkladná praxe. - „Rozdělení Dáma hry do modulů (board, pieces, game)“ – Skvělá práce.

2. Smysluplnost komentářů v kódu [5 bodů]

Kód obsahuje docstringy u funkcí (např. v projektu Lodě) a základní komentáře u logických bloků. U hry Člověče, nezlob se by ale neškodilo trochu více rozvést složitější části, jako je logika pohybu figurek. - V souboru Lode/main.py máš hezky popsané funkce, což usnadňuje čtení. - V CloveceNezlobSe/main.py by si zasloužila komentář zejména metoda move_piece, která řeší různé stavy (nasazení vs. pohyb).

3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]

Tady nemám co vytknout. Dodržuješ pravidlo „jeden projekt = jedna složka“. Soubory v rootu jsou pouze ty nezbytné (README.md). Dokumentace v souborech _projekt.md je přehledná, obsahuje cíle i technický popis. Takhle by to mělo vypadat.

4. Logika řešení a přemýšlení studenta v Pythonu [9 bodů]

Tvůj pokrok je v tomto týdnu velmi vidět. Zvláště oceňuji: 1. Refaktoring (Dáma): Přechod od jednoho obřího souboru k modulární architektuře (board.py, pieces.py, game.py) svědčí o tom, že začínáš chápat softwarový design. 2. OOP přístup (Člověče, nezlob se): Použití tříd Player a Game je správné a logické. 3. Ošetření vstupů (Lodě): Používáš try-except blok pro zachycení nečíselných vstupů, což je v této fázi výuky výborné.

Našel jsem však pár logických nedostatků, na které si dej pozor:

V souboru CloveceNezlobSe/main.py:
- Uživatel může zadat počet hráčů mimo rozsah 2–4 a program to nijak nekontroluje.
- Při výběru figurky piece = int(input("Vyber figurku (0-3): ")) chybí validace, zda uživatel nezadal např. číslo 5, což by způsobilo pád programu (IndexError).
V souboru Lode/main.py:
- V get_player_input máš natvrdo v textu input("Zadej řádek (0-4): "). Pokud bys změnil konstantu BOARD_SIZE, text bude stále říkat 0-4. Lepší je použít f-string: f"Zadej řádek (0-{BOARD_SIZE-1}): ".

Celkem získáno bodů: [19 / 95%] ze 20 možných

Tento týden jsi odvedl kus práce, zejména to rozdělení Dámy do modulů mě potěšilo. Oprav si validace vstupů u Člověče a bude to perfektní!

DIFFICULTY_INDEX: [4]

Převedeno z DB reportu