Mendys
Období: Týden 15/2026 (od 12.04.) Skupina: tria URL: https://github.com/alexanderFIV/Mendys.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-04-14 04:20: quality of life improvement - better deleting interaction
- 2026-04-14 04:25: pointed out mistakes fixed
- 2026-04-16 05:08: Added a save and load function fixed some bugs and updated documentation
- 2026-04-17 19:23: adressing feedback
- 2026-04-18 15:47: further cleanup
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 18 / 20 b. (90%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 5 |
| Změněné soubory | 7 |
| Počet přid./odeb. řádků kódu | 228 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent. Prostudoval jsem tvou práci za uplynulý týden na projektu Project Preview a níže předkládám tvé hodnocení.
1. Smysluplnost popisů u commitů [3 body]:
Tvé commity jsou jasné a popisují konkrétní změny. Oceňuji zejména commit 16.04.2026, který detailně shrnuje opravy chyb i novou funkcionalitu (save/load). Drobné překlepy jako "adressing" (správně addressing) nebo chybějící interpunkci v anglických popisech nebudu penalizovat, protože věcně jsou zprávy v pořádku.
2. Smysluplnost komentářů v kódu [4 body]:
V kódu se orientuješ dobře a používáš komentáře k oddělení logických bloků (např. # 5. Render Graphics). Nicméně, nově přidané metody pro serializaci (to_dict, from_dict) a ukládání (save_project, load_project) by si zasloužily alespoň krátký docstring nebo komentář vysvětlující, k čemu slouží (i když jsou názvy intuitivní). U Base64 konverze obrázků by bylo vhodné vysvětlit, proč volíš právě tento způsob ukládání.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]:
Zde vidím největší posun.
- Struktura: Pravidla byla dodržena, soubory jsou v logických složkách (Project preview, Kostka), v rootu jsou pouze konfigurační soubory a README.
- Obsah: Velmi oceňuji, že jsi upustil od neformálních poznámek o "AI švandoření" a přepsal jsi dokumentaci do profesionální češtiny. Technický popis architektury (JSON, Base64, NumPy) je na vysoké úrovni a dává projektu jasný rámec.
- Drobnost: V souboru Documentation.md máš u datumu 18.04.2026 překlep: "...not like they are litterally useless" (správně literally).
4. Logika řešení a přemýšlení studenta v Pythonu [9 bodů]:
Tento týden jsi odvedl velký kus práce na pokročilé funkcionalitě:
- Serializace dat: Implementace metod to_dict a from_dict pro objekty je správný objektově orientovaný přístup.
- Práce s daty: Převod QImage přes QByteArray do Base64 pro uložení do JSONu je elegantní řešení integrity projektu (vše v jednom souboru).
- Oprava chyb: Přidání výpočtu scale_x a scale_y pro zachování poměru stran grafiky v texturách svědčí o tom, že o problémech přemýšlíš v souvislostech.
- Progrese: Projekt se posunul od pouhého zobrazovadla k reálně použitelné aplikaci, která umí pracovat s uživatelskými daty.
Celkem získáno bodů: [18 / 90%] z 20 možných
Slovní hodnocení:
Tvůj pokrok je velmi působivý. Přechod od experimentování k implementaci robustního systému ukládání projektů a profesionalizace dokumentace je přesně to, co od studenta střední školy očekávám. Logika ukládání přes Base64 je sice náročnější na paměť, ale pro potřeby editoru vizitek je to velmi praktické řešení. Příště se zkus v kódu více zaměřit na ošetření vstupů (např. co se stane, když se uživatel pokusí načíst poškozený JSON v load_project – použij try-except).
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
V dokumentaci uvádíš, že pro efektivní matematické výpočty a 3D náhled využíváš knihovnu
numpy, kterou jsi ale v rámci posledního „cleanupu“ z hlavního souboruPpmain.pyodstranil – mohl bys vysvětlit, proč už tam není potřeba a co přesně se stalo s tou částí kódu, která ji původně využívala?