virtualAI
Období: Týden 20/2026 (od 17.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 | ✅ SPLNĚNO |
| Rozestup alespoň 12h mezi 3 commity | ❌ NESPLNĚNO |
| Projektová dokumentace (README, projekt.md) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-05-17 20:49: vylepšení projektu která probudí mozek
- 2026-05-17 20:54: přidání do README
- 2026-05-18 06:18: další změna braintest
- 2026-05-18 20:27: změna většiny projektu
- 2026-05-18 20:29: přidání složky na školní projekty
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 13 / 20 b. (65%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 5 |
| Změněné soubory | 10 |
| Počet přid./odeb. řádků kódu | 1479 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci na repozitáři za uplynulý týden. Udělal jsi obrovský kus práce na projektu šachů, což mě těší, ale v organizaci souborů a dokumentaci máme stále značné mezery.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]:
Tvé popisy commitů jsou sice chronologické a říkají, na čem jsi pracoval, ale jsou příliš obecné. Například commit "změna většiny projektu" u takto velkého zásahu do kódu (přechod na hru proti AI, threading) je nedostatečný. Měl bys specifikovat, že jsi integroval Stockfish nebo přidal zvukové efekty.
2. Smysluplnost komentářů v kódu [4 body]:
V kódu se objevují základní komentáře (inicializace zvuků, nastavení AI), což je v pořádku. Nicméně u komplexnějších částí, jako je práce s vlákny (threading) nebo komunikace s externím enginem (Stockfish), komentáře chybí. Programátor, který by tvůj kód četl poprvé, by mohl mít problém pochopit, jak přesně tyto pokročilé funkce ovládáš.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]:
V této kategorii musím být přísný, protože jsi porušil základní pravidla organizace projektu:
- Soubory v rootu: V hlavní složce ti leží konfigurační a datové soubory: /neat_config.txt, /data_text.txt, /highscore.json, /historie.txt. Ty by měly být v příslušných složkách u projektů, ke kterým patří (např. ve složce snake nebo brain_test).
- Nesmyslné/chybné názvy:
- Složka /školní_projekt/ obsahuje soubory py.py a try.py. Název "try" je navíc klíčové slovo v Pythonu, což je velmi špatná praxe.
- V kalkulačce máš překlep v názvu: kaukulacka.py.
- Další soubory jako pekM.py nebo qt.py jsou rovněž nevhodně pojmenované.
- README.md: Obsahuje pouze seznam plánů, ale vůbec nereflektuje tvou aktuální práci na šachách, které jsou momentálně tvým největším projektem.
4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]:
Tady tě musím pochválit za velký technický skok.
- Progrese: Přechod z jednoduché dvouhry na "Profesionální šachovou aplikaci" s integrací enginu Stockfish je vynikající.
- Threading: Správně jsi pochopil, že výpočet AI by "zamrazil" grafické rozhraní (Tkinter), a proto jsi použil threading.Thread. To je na středoškoláka pokročilá a správná logika.
- Knihovny: Efektivní využití python-chess a pygame pro zvuky.
- Nedostatky: V README.md tvůj cíl "šachy" úplně chybí (přestože na nich pracuješ nejvíce), což působí, jako bys pracoval na něčem jiném, než jsi si předsevzal. Logika aplikace je však robustní.
Celkem získáno bodů: [13 / 65%] ze 20 možných
Doporučení pro příští týden:
1. Ukliď si root repozitáře a přesuň data do složek.
2. Přejmenuj soubory py.py a try.py na něco smysluplného.
3. Aktualizuj README.md – doplň tam projekt šachů a popiš, co už umí (AI, PGN export atd.).
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
Proč jsi do nové verze přidal modul
threadinga co konkrétně by se stalo s oknem aplikace (GUI) v momentě, kdy by Stockfish počítal složitý tah, pokud bys tento výpočet nespouštěl v samostatném vlákně?