virtualAI
Období: Týden 10/2026 (od 08.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-09 07:28: Initial commit
- 2026-03-09 07:59: kalkulacka, uprava readme
- 2026-03-09 08:07: kalkulacka, uprava readme
- 2026-03-09 08:20: https://github.com/hocnguyen-prog/virtualAI.git
- 2026-03-13 16:52: Add files via upload
- 2026-03-14 22:22: Add files via upload
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 11 / 20 b. (55%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 6 |
| Změněné soubory | 4 |
| Počet přid./odeb. řádků kódu | 409 |
Komentář a zpětná vazba od AI
Zde je tvé hodnocení za uplynulý týden:
1. Smysluplnost popisů u commitů [1 bod]:
Většina tvých commitů postrádá výpovědní hodnotu. Zprávy jako „Add files via upload“ nebo dokonce vložení URL adresy „https://github.com/hocnguyen-prog/virtualAI.git“ místo popisu změny jsou v profesionální praxi nepřípustné. První dva commity ohledně kalkulačky byly v pořádku, ale následně jsi rezignoval na popisování toho, co v kódu skutečně měníš.
2. Smysluplnost komentářů v kódu [4 body]:
V souborech snake_game.py a flappy_bird.py oceňuji logické rozdělení kódu do bloků pomocí komentářů (např. # pták, # update pipes, # helper functions). To výrazně pomáhá v orientaci. Nicméně u souboru kaukulacka.py komentáře téměř chybí a u složitějších částí herní logiky by bylo vhodné vysvětlit „proč“ daná věc funguje (např. u detekce kolizí), nejen „co“ se právě děje.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]:
V této kategorii musím body strhnout úplně, a to ze dvou důvodů:
1. Porušení struktury: Všechny tvé soubory (/snake_game.py, /flappy_bird.py, /kaukulacka.py) leží volně v hlavní složce repozitáře. Podle metodiky měl mít každý projekt (kalkulačka, had, flappy bird) svou vlastní složku.
2. README: Dokumentace je velmi slabá. Obsahuje pouze tvůj cíl a následně historii gitových příkazů, které patří do terminálu, nikoliv do dokumentace projektu. README má sloužit k popisu toho, jak program spustit a co dělá.
4. Logika řešení a přemýšlení studenta v Pythonu [6 bodů]:
Tvým původním cílem byla „kaukulačka“ (pozor na překlep v názvu souboru i v README). Ta je funkční, obsahuje ošetření vstupů pomocí try/except a kontrolu dělení nulou, což je chvályhodné.
Následně jsi nahrál dva komplexní herní projekty v Pygame. Kód her je logicky strukturovaný a pokročilý (využití seznamů, slovníků pro objekty trubek, funkce pro resetování stavu). Nicméně vzhledem k tomu, že tyto velké projekty byly nahrány najednou bez jakékoli historie postupného vývoje (commity „Add files via upload“), je těžké posoudit tvou vlastní progresi a tvůrčí proces. Navíc jsi neopravil překlep v názvu souboru kaukulacka.py.
Celkem získáno bodů: [11 / 55%] ze 20 možných
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
Ve hře Snake máš funkci
set_mode, která měníCELL_SIZEa následně přepočítáváGRID_WIDTHaGRID_HEIGHT. Jak přesně by se změnilo chování detekce kolize se stěnami, kdybys tyto dvě proměnné neaktualizoval a nechal je v původních hodnotách z režimu "Normal"?