virtualAI
Období: Týden 13/2026 (od 29.03.) 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 | ✅ SPLNĚNO |
| Rozestup alespoň 12h mezi 3 commity | ✅ SPLNĚNO |
| Projektová dokumentace (README, projekt.md) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-03-29 11:58: přidání do git
- 2026-03-29 19:42: fix pekman controls and pygame.math.radians
- 2026-04-02 11:14: přidání nového pekmana
- 2026-04-03 11:00: upravení virtualAI
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 16 / 20 b. (80%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 4 |
| Změněné soubory | 20 |
| Počet přid./odeb. řádků kódu | 1517 |
Komentář a zpětná vazba od AI
Dobrý den, jako tvůj pedagogický asistent jsem prošel tvůj repozitář a kód, který jsi vytvořil v uplynulém týdnu. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [3 body]:
Tvé commity jsou jasné a popisují konkrétní změny, které jsi v kódu provedl (např. „fix pekman controls“, „přidání nového pekmana“). Je vidět, co bylo cílem dané úpravy, což velmi usnadňuje orientaci v historii tvého projektu.
2. Smysluplnost komentářů v kódu [5 bodů]:
V souboru pekM-py (správně by mělo být .py) používáš komentáře k přehlednému rozdělení kódu do logických sekcí (Nastavení, Barvy, Entity). Velmi oceňuji komentáře u složitějších částí, jako je animace pusy Pac-Mana nebo vykreslování vlinek u duchů. Pomáhá to čitelnosti. Jeden bod strhávám za to, že v souboru pekman.py komentáře po promazání kódu prakticky zmizely.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]:
V této kategorii musím body strhnout kvůli výrazným nedostatkům v pojmenovávání a struktuře:
- Názvy souborů: V repozitáři máš soubory s překlepy a nesmyslnými názvy: /Pracuje_se_na_tom/m, /Pozdeji/kalkulacka/<span style='color: red;'>kaukulacka.py</span> (má být kalkulačka), a hlavně hlavní kód týdne /Pozdeji/pekman/<span style='color: red;'>pekM-py</span> (chybí tečka a přípona .py, což je kritická chyba pro spustitelnost).
- README.md: Obsahuje pouze dva řádky se starým cílem. Chybí jakýkoliv návod, jak hru spustit nebo jaké knihovny (pygame) jsou potřeba.
- Struktura: Složka Pracuje_se_na_tom je sice v pořádku pro rozpracované věci, ale soubor m v ní nemá co dělat.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Tady tě musím pochválit. Ačkoliv ses odchýlil od svého původního cíle (had a kalkulačka), práce na Pac-Manovi vykazuje vysokou úroveň logiky:
- Pohyb po mřížce: Správně jsi implementoval kontrolu can_move pouze v momentě, kdy je entita vycentrovaná v dlaždici.
- Matematika: Použití math.sin pro animaci pusy a math.radians pro rotaci "výkousu" je velmi elegantní řešení.
- AI: Duchové mají jednoduchý, ale funkční náhodný pohyb, který respektuje zdi.
V kódu pekM-py jsem si všiml, že v metodě update při kolizi s duchem nastavuješ pevnou pozici Pac-Mana (14*BLOCK_SIZE, 21*BLOCK_SIZE), což by mohlo způsobit problém, pokud bys někdy změnil mapu (tzv. "hardcoded" hodnota).
Celkem získáno bodů: [16 / 20] Slovo asistenta: Zapracuj na pořádku v souborech. Je škoda, aby takto kvalitní kód vypadal nedbale kvůli překlepům v názvech.
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V metodě
drawu vykreslování Pac-mana počítáš proměnnoumouthpomocí funkcemath.sin– mohl bys mi vysvětlit, jak tato hodnota ovlivňuje parametry toho černého trojúhelníku a co by se ve hře vizuálně změnilo, kdybys v tom výpočtu změnil konstantu0.2na2.0?