Katana
Období: Týden 15/2026 (od 12.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-15 06:56: Přidán projekt Frogger a upraven README
- 2026-04-16 04:24: Přidán projekt Flappy Bird a upraven README
- 2026-04-16 17:17: Přidán projekt Sudoku a aktualizován README
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 20 / 20 b. (100%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 3 |
| Změněné soubory | 7 |
| Počet přid./odeb. řádků kódu | 423 |
Komentář a zpětná vazba od AI
Ahoj! Jako tvůj asistent pro výuku programování jsem prošel tvůj repozitář a odevzdanou práci za uplynulý týden (od 15. 4. do 16. 4. 2026). Máš za sebou velmi produktivní období, během kterého jsi odevzdal hned tři nové projekty: Frogger, Flappy Bird a Sudoku.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [3 body]
Tvé zprávy u commitů jsou jasné, stručné a přesně popisují, co se v daném kroku stalo (např. „Přidán projekt Frogger a upraven README“). Časová souslednost odpovídá záznamům v README. Práce s Gitem je z tvé strany příkladná.
2. Smysluplnost komentářů v kódu [6 bodů]
V kódu se orientuješ velmi dobře a komentáře používáš smysluplně k rozdělení logických bloků. Oceňuji zejména komentáře u tříd Bird a Pipe v projektu Flappy Bird a vysvětlení algoritmu pro kontrolu 3x3 bloku v Sudoku. Pomáhá to čitelnosti kódu.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]
Dodržel jsi pravidlo samostatných složek pro každý projekt, což velmi chválím. Dokumentace ve formátu _projekt.md je u všech nových projektů vyčerpávající a přehledná.
Drobné upozornění: V souboru README.md se ti v jedné z verzí objevil překlep (přebytečný znak):
| 15 | Flappy Bird | 16.4.2026 |<span style='color: red;'>¨</span>
Také si dej pozor na nahrávání složek <span style='color: red;'>__pycache__/</span> do repozitáře (složka Sachy). Tyto soubory by měly být ignorovány (ideálně pomocí souboru .gitignore), protože jsou to zkompilované soubory Pythonu, které do čistého repozitáře nepatří.
4. Logika řešení a přemýšlení studenta v Pythonu [9 bodů]
V uplynulém týdnu jsi udělal velký pokrok:
* OOP (Objektově orientované programování): V projektech Frogger a Flappy Bird jsi správně použil třídy pro reprezentaci herních objektů. To svědčí o dobrém pochopení zapouzdření dat a logiky.
* Algoritmizace: V Sudoku jsi úspěšně implementoval logiku kontroly pravidel pomocí 2D polí a celočíselného dělení (určování kvadrantů), což je středoškolsky náročná úloha.
* Ošetření vstupů: V Sudoku chválím použití bloku try/except v hlavní herní smyčce, i když je trochu obecný (zachytí jakoukoli chybu).
* Pygame: Efektivně využíváš metody pro detekci kolizí (colliderect).
Celkem získáno bodů: [20 / 100%] ze 20 možných
Vynikající práce! Tento týden jsi prokázal vysoké nasazení i schopnost aplikovat teorii (třídy, 2D pole) v praxi. Jen si pohlídej čistotu repozitáře (ten zmíněný pycache).
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V projektu Sudoku ve funkci
is_validmáš u všech tří typů kontrol (řádek, sloupec, blok) podmínku, která vylučuje kontrolu aktuální pozice (např.pos[1] != inebo(i, j) != pos) – mohl bys vysvětlit, zda jsou tyto podmínky ve tvém kódu skutečně potřeba, když uvážíš, v jakém pořadí v hlavní herní smyčce provádíš validaci a samotný zápis čísla do pole?