virtualAI

Období: Týden 18/2026 (od 03.05.) Skupina: tria URL: https://github.com/hocnguyen-prog/virtualAI.git

1. Splnění základních podmínek

Podmínka	Status
Alespoň 3 commity v daném týdnu	❌ NESPLNĚNO
Rozestup alespoň 12h mezi 3 commity	❌ NESPLNĚNO
Projektová dokumentace (README, projekt.md)	❌ NESPLNĚNO

2. Přehled commitů

• 2026-05-03 13:17: změna star keeper projektu
• 2026-05-10 18:43: oprava speed test

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

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

Komentář a zpětná vazba od AI

Ahoj! Jsem tvůj pedagogický asistent a prostudoval jsem tvou práci na projektu za uplynulý týden. Je vidět, že ses zaměřil na hru Star Keeper a výrazně ji posunul kupředu, zejména co se týče vizuální stránky a herní mechaniky "Game Over".

Zde je mé hodnocení podle stanovené metodiky:

1. Smysluplnost popisů u commitů [1 bod]

V repozitáři se za tento týden nachází pouze jeden commit s popisem "změna star keeper projektu". I když popisuje, na čem jsi pracoval, je příliš obecný. Příště zkus specifikovat, co přesně jsi přidal (např. „přidána funkce pro vykreslení hráče a logika game over“).

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

Komentáře v kódu jsou velmi dobré a názorné. Oceňuji zejména detailní popis částí, ze kterých se skládá postavička hráče (nohy, tričko, košík). Pomáhá to v orientaci v souřadnicích pygame.draw. * Poznámka: Dávej si pozor na konzistenci – proměnnou pro písmo jsi pojmenoval front zde je chyba (pravděpodobně překlep z "font"). V kódu ji sice používáš konzistentně, ale mate to čtenáře.

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

Struktura repozitáře má své rezervy: * Soubory v rootu: V hlavní složce máš soubory /try.py a /historie.txt, což porušuje pravidlo o samostatných složkách pro každý projekt. * Názvy souborů: V adresáři /Pozdeji/kalkulacka/ máš soubor kaukulacka.py a ve /flappy/ máš flapy_2.0.py. Jsou to překlepy, které by se v profesionálním kódu neměly objevovat. * README.md: Obsahuje pouze seznam plánovaných projektů, ale chybí jakýkoliv návod ke spuštění nebo popis ovládání aktuální hry.

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

V logice hry jsi udělal velký kus práce: * Vlastní funkce: Vytvoření funkce draw_player(x, y) je správný krok k modularitě kódu. * Stav hry: Implementoval jsi stav game_over a možnost restartu hry pomocí klávesy R, což vyžaduje pochopení herní smyčky a větvení programu. * Práce se seznamy: Správně používáš iteraci přes kopii seznamu hvězd stars[:] při odebírání prvků, čímž předcházíš chybám při modifikaci seznamu během cyklu. * Kolize: Upravil jsi logiku kolizí tak, aby hvězdy padaly do košíku (posun basket_y), což zvyšuje realističnost hry.

Celkem získáno bodů: [14 / 70%] z 20 možných

---

Slovní zhodnocení: Tento týden jsi udělal velký pokrok v algoritmizaci hry. Místo jednoduchého čtverečku už máš v kódu komplexnější kreslení postavičky a zvládnutou logiku konce hry. Zapracuj prosím na pořádku v repozitáři – přesuň soubory z rootu do příslušných složek a oprav si překlepy v názvech souborů i v kódu (zejména to front vs font).

DIFFICULTY_INDEX: [3]

Kontrolní otázka k obhajobě

Vysvětli, proč jsi v podmínce pro zachycení hvězdy definoval novou proměnnou basket_y s posunem + 55 a co přesně se v herní mechanice stane, pokud se padající hvězda dotkne hlavy nebo trička postavičky?