Katana
Období: Týden 16/2026 (od 19.04.) Skupina: tria URL: https://github.com/maximjavorsky-code/Katana.git
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 |
2. 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. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 19 / 20 b. (95%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 5 |
| Změněné soubory | 11 |
| Počet přid./odeb. řádků kódu | 1154 |
Komentář a zpětná vazba od AI
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_inputmáš natvrdo v textuinput("Zadej řádek (0-4): "). Pokud bys změnil konstantuBOARD_SIZE, text bude stále říkat 0-4. Lepší je použít f-string:f"Zadej řádek (0-{BOARD_SIZE-1}): ".
- V
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]
Kontrolní otázka k obhajobě
V metodě
play_turnu Člověče, nezlob se používáš bloktry-exceptpro ošetření vstupu; co se v aktuální implementaci stane s hodnotou, kterou hráč hodil na kostce, pokud zadá neplatný vstup (např. písmeno), a jak bys kód upravil, aby kvůli takovému překlepu hráč o svůj tah nepřišel?