virtualAI

Období: Týden 15/2026 (od 12.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-12 11:35: dokončení projektu překladač
• 2026-04-18 12:03: upravení překladače
• 2026-04-19 14:47: přidání chess programu

3. Výsledky AI analýzy kódu

Metrika	Hodnota
Celkové body (AI)	14 / 20 b. (70%)
Náročnost projektu (Index)	4
Počet commitů	2
Změněné soubory	5
Počet přid./odeb. řádků kódu	236

Komentář a zpětná vazba od AI

Zde je tvé vyhodnocení za uplynulý týden:

1. Smysluplnost popisů u commitů [2 body]

Popisy jsou stručné a jasné („dokončení projektu“, „upravení překladače“). Chybí však detailnější informace o tom, co konkrétně se v kódu změnilo (např. zmínka o přidání GUI nebo integraci API).

2. Smysluplnost komentářů v kódu [4 body]

V nové verzi překladače oceňuji přehledné rozdělení kódu pomocí komentářů na sekce (LÉVÝ PANEL, PRAVÝ PANEL). V kódu se lépe orientuje. Nicméně v nové třídě PrekladacApp zcela chybí dokumentační řetězce (docstrings) u metod, které byly v původní verzi (např. u funkcí nacist_soubor). Soubor try.py je komentován dostatečně pro svůj malý rozsah.

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 organizace: - Soubory v rootu: V hlavní složce se nachází /try.py a /historie.txt, což je nepřípustné. Každý skript a jeho data mají mít svou složku. - Názvy souborů: Soubor try.py je pojmenován velmi neurčitě. V seznamu cílů v README máš překlep „kaukulačka“, který se přenesl i do názvu souboru /Pozdeji/kalkulacka/kaukulacka.py zde je chyba. - Dokumentace: README.md obsahuje pouze seznam cílů, nikoliv návod k použití nebo popis repozitáře.

4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]

Zde tě musím velmi pochválit. Progrese mezi starou a novou verzí překladače je obrovská: - Refaktoring: Přešel jsi od jednoduchého procedurálního kódu s regulárními výrazy k objektově orientovanému programování (class PrekladacApp). - Nové technologie: Implementace knihovny customtkinter pro moderní GUI a využití externí knihovny deep_translator pro skutečný překlad (namísto pouhého nahrazování znaků) posouvá projekt na úplně jinou úroveň. - Práce s daty: Logika ukládání historie do textového souboru a její následné načítání při startu aplikace je implementována správně. Ačkoliv „překladač“ nebyl v tvém původním seznamu cílů, jeho náročnost a kvalita zpracování (vyjma chybějících docstringů) jsou na vysoké úrovni.

Celkem získáno bodů: [14 / 70%] ze 20 možných

Slovní komentář: Udělal jsi velký kus práce na aplikaci překladače. Logika kódu je čistá a pokročilá. Příště se však soustřeď na pořádek v repozitáři – soubory jako try.py nemají v hlavní složce co dělat a soubor historie.txt by měl být v rámci složky projektu, nikoliv v rootu. Pozor také na překlepy v názvech souborů.

DIFFICULTY_INDEX: [4]

Kontrolní otázka k obhajobě

Všiml jsem si, že v metodě uloz_do_historie vkládáš nové záznamy do GUI na začátek (index 0.0), zatímco do souboru historie.txt se přes open(..., "a") připisují na konec – jak se tato nekonzistence v řazení projeví v seznamu historie po restartu aplikace?