virtualAI
Období: Týden 12/2026 (od 22.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-22 14:48: Add files via upload
- 2026-03-22 16:30: Add files via upload
- 2026-03-23 07:58: změna celého repozitáře
- 2026-03-23 08:01: změna celého repozitáře 2 merge
- 2026-03-25 17:10: Delete pekman.py
- 2026-03-25 17:10: Delete complex-calculator.py
- 2026-03-29 11:58: přidání do git
- 2026-03-29 19:42: fix pekman controls and pygame.math.radians
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 8 / 20 b. (40%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 6 |
| Změněné soubory | 15 |
| Počet přid./odeb. řádků kódu | 2858 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj asistent pro výuku Pythonu. Prošel jsem tvou práci v repozitáři za uplynulý týden a zde je mé hodnocení.
1. Smysluplnost popisů u commitů [1 bod]
Většina tvých commitů postrádá výpovědní hodnotu. Zprávy jako „změna celého repozitáře“ nebo automaticky generované „Add files via upload“ mi neříkají nic o tom, co konkrétního jsi v kódu změnil nebo proč. Dobrý programátor popisuje změny věcně (např. „Oprava dělení nulou v kalkulačce“).
2. Smysluplnost komentářů v kódu [3 body]
V souboru pekman.py (který jsi sice smazal, ale byl součástí práce) jsi měl pěkný úvodní docstring a základní popis tříd. V ostatních souborech (např. complex-calculator.py) však komentáře téměř úplně chybí. Pamatuj, že kód nepíšeš jen pro počítač, ale i pro lidi (včetně svého budoucího já).
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Struktura složek je v pořádku – chválím, že projekty máš v samostatných adresářích. Nicméně v repozitáři máš velký nepořádek v názvech souborů.
- Soubor /kalkulacka/kaukulacka.py zde je chyba obsahuje překlep v názvu.
- Soubor /flappy/flapy_2.0.py zde je chyba má také překlep (chybí druhé 'p').
- README.md je velmi strohé a neobsahuje žádné instrukce k instalaci či spuštění tvých programů.
4. Logika řešení a přemýšlení studenta v Pythonu [3 body]
Tvé cíle byly vytvořit kalkulačku a hru Snake. V repozitáři tyto soubory sice jsou, ale tvá aktivita tento týden spočívala především v hromadném nahrávání souborů a následném mazání funkčních skriptů (smazal jsi pekman.py a complex-calculator.py).
U kalkulačky chválím v smazaném souboru complex-calculator.py použití bloku try-except pro ošetření vstupů, což je správný přístup. Nicméně tvůj cíl byl vytvořit základní kalkulačku, a místo toho jsi nahrál a pak smazal komplexní verzi s GUI. Působí to spíše jako kopírování cizích souborů než postupná práce na vlastním cíli. U hry Snake nevidím v diffu žádný progres, pouze existující soubor.
Celkem získáno bodů: [8 / 20]
Slovní zhodnocení:
Tento týden jsi spíše „uklízel“ a přesouval soubory, než abys skutečně programoval. Oceňuji, že se nebojíš používat knihovny jako pygame nebo tkinter, ale tvůj vlastní přínos a progrese směrem k vytyčeným cílům (Snake a základní kalkulačka) jsou tento týden nejasné. Příště se soustřeď na srozumitelné commity a oprav si překlepy v názvech souborů.
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
V konstruktoru třídy
Ghostv souborupekman.pypoužíváš řádekself.direction = Direction.NONE if self.direction == Direction.NONE else self.direction– můžeš mi vysvětlit, jaký má tento příkaz konkrétní význam pro logiku pohybu duchů a co by se v programu změnilo, kdybys ho úplně odstranil?