virtualAI
Období: Týden 17/2026 (od 26.04.) 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-04-30 17:24: úprava šachů
- 2026-05-03 13:17: změna star keeper projektu
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 8 / 20 b. (40%) |
| Náročnost projektu (Index) | 2 |
| Počet commitů | 1 |
| Změněné soubory | 3 |
| Počet přid./odeb. řádků kódu | 108 |
Komentář a zpětná vazba od AI
1. Smysluplnost popisů u commitů [1 bod]:
V uplynulém týdnu byl vytvořen pouze jeden commit s popisem "úprava šachů". Tento popis je velmi strohý a nepostihuje rozsah provedených změn (které zahrnovaly i úpravu Piškvorek v jiném souboru a aktualizaci historie překladů). Příště by bylo vhodné rozdělit práci do více commitů a popsat je konkrétněji (např. "Změna měřítka šachovnice na 90px" nebo "Rozšíření piškvorek na 20x20 a přidání barev").
2. Smysluplnost komentářů v kódu [3 body]:
V kódu se nacházejí základní komentáře, které oddělují logické sekce (např. # Canvas pro šachovnici, # Nadpis, # Info label). Nicméně postrádám vysvětlení složitějších operací, zejména u výpočtů souřadnic v souboru sachy_aplikace.py nebo u logiky kontroly vítězství v try.py. Student spíše využívá komentáře jako nadpisy než jako vysvětlení "proč" a "jak" kód funguje.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]:
V této kategorii musím body strhnout kvůli porušení základních pravidel:
* Soubory v rootu: Soubory /try.py a /historie.txt leží volně v hlavní složce, což je nepřípustné. Každý projekt (Piškvorky, Překladač) musí mít svou složku.
* Názvy souborů: Soubor /try.py má zcela nevhodný název, který nevypovídá o jeho obsahu (Piškvorky). V repozitáři se navíc stále nacházejí soubory s překlepy, např. <span style='color: red;'>kaukulacka.py</span> a <span style='color: red;'>flapy_2.0.py</span>.
* README: Dokumentace v README.md je pouze seznamem budoucích cílů a vůbec neodráží aktuálně rozpracované šachy nebo piškvorky.
4. Logika řešení a přemýšlení studenta v Pythonu [4 body]:
- Šachy: Provedené změny jsou čistě mechanické – šlo o přeškálování grafického rozhraní (změna konstanty 70 na 90 a úprava souvisejících výpočtů). To svědčí o pozornosti k detailu, ale neukazuje velký programátorský posun.
- Piškvorky (
try.py): Zde je progrese vidět nejvíce. Student úspěšně rozšířil mřížku z 5x5 na 20x20 a správně zobecnil logiku vykreslování i kontroly vítězství pomocí proměnnéself.velikost. Přidání barev pro hráče a vizuální zpětné vazby v Tkinteru je chvályhodné. - Cíl: Práce na šachách a piškvorkách (v souboru
try.py) vůbec neodpovídá stanoveným cílům vREADME.md. Student by měl buď aktualizovat své cíle, nebo se držet původního plánu. Vzhledem k tomu, že se jedná o středně pokročilé UI úpravy, hodnotím logiku jako průměrnou.
Celkem získáno bodů: [8 / 40%] ze 20 možných
DIFFICULTY_INDEX: [2]
Kontrolní otázka k obhajobě
V souboru
try.pyjsi do uživatelského rozhraní přidalinfo_label– jakým způsobem v kódu zajišťuješ, aby barva textu v tomto popisku odpovídala barvě figurky hráče, který je právě na tahu?