Katana

Období: Týden 18/2026 (od 03.05.) 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	❌ NESPLNĚNO
Projektová dokumentace (README, projekt.md)	✅ SPLNĚNO

2. Přehled commitů

2026-05-04 05:55: Přidána poker hra, odstraněn projekt Parkour, aktualizován README
2026-05-06 07:11: Add Pazaak project
2026-05-06 07:16: Update README

3. Výsledky AI analýzy kódu

Metrika	Hodnota
Celkové body (AI)	15 / 20 b. (75%)
Náročnost projektu (Index)	3
Počet commitů	3
Změněné soubory	10
Počet přid./odeb. řádků kódu	630

Komentář a zpětná vazba od AI

Ahoj, jsem tvůj pedagogický asistent a prozkoumal jsem tvou práci na repozitáři za uplynulý týden. Zde je tvé hodnocení podle stanovené metodiky:

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

Tvé commity jsou jasné a popisné. Oceňuji, že v jednom z commitů (z 4. 5.) uvádíš i to, že jsi odstranil starý projekt a aktualizoval README. To velmi pomáhá v orientaci v historii vývoje. * "Add Pazaak project" – Jasné a výstižné. * "Update README" – Standardní, doplňující změny.

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

V souboru pazaak.py a main.py používáš vizuální oddělovače a nadpisy (např. ✨ GLOW, 🧍 ACTIONS), což velmi zvyšuje čitelnost kódu. Komentáře v tutorial.py jsou české a stručné. Body strhávám za to, že v souboru karty.py chybí jakýkoliv komentář, ačkoliv jde o samostatný modul.

3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:

Struktura repozitáře je příkladná – každý projekt má svou složku a v rootu nejsou žádné "zapomenuté" soubory. README tabulka je poctivě aktualizovaná. Důvod stržení bodu: U nového projektu Pazaak chybí dokumentační soubor Pazaak_projekt.md, který máš u všech ostatních her. Dokumentace by měla vznikat současně s kódem.

4. Logika řešení a přemýšlení studenta (progrese kódu) [6 bodů]:

Zvolené téma (Pazaak z KOTORu) je středně náročné a oceňuji pokus o modulární přístup a vytvoření lobby. Bohužel jsem v logice a implementaci našel několik zásadních chyb, které by znemožnily spuštění hry:

Chyba v cestě: V souboru Pazaak/main.py se pokoušíš spustit hru příkazem subprocess.run(["python", "pazaak_kotor.py"]), ale tvůj soubor se ve skutečnosti jmenuje pazaak.py. Hra by se tedy z menu nespustila.
Chybějící scope: V souboru Pazaak/karty.py používáš proměnné screen a FONT, které v tomto souboru nejsou definovány, importovány ani předány jako argumenty funkce. To povede k pádu programu (NameError).
Logika v Lode/main.py: Úprava na konci souboru je zvláštní. Máš tam while True smyčku s input(), která je ale umístěna mimo hlavní funkci a v podstatě by zastavila jakékoliv korektní ukončení programu, aniž by to mělo vliv na hru samotnou.
AI: Logika AI v Pazaaku je velmi triviální (pouhý limit 16), ale pro začátek dostačující.

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

Slovní hodnocení: Odvedl jsi velký kus práce na grafice a rozhraní nové hry. Pazaak vypadá vizuálně skvěle díky implementaci "glow" efektů. Dávej si však pozor na propojování souborů – když kód rozdělíš do modulů, musíš zajistit, aby proměnné jako screen byly správně předány. Také nezapomínej na dokumentaci k novým projektům.

DIFFICULTY_INDEX: [3]

Kontrolní otázka k obhajobě

V souboru pazaak.py používáš ve funkci ai_play() cyklus while pro simulaci tahu soupeře – uvidí hráč na obrazovce plynule, jak si AI postupně karty dobírá, nebo se celkový součet AI změní okamžitě, a co je příčinou tohoto chování z hlediska fungování herní smyčky a překreslování v Pygame?