Titan
Období: Týden 11/2026 (od 15.03.) Skupina: tria URL: https://github.com/viktordamek-lang/Titan.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) | ✅ SPLNĚNO |
2. Přehled commitů
- 2026-03-16 08:05: vytvořeni noveho programu a prava readme
- 2026-03-17 12:38: uprava programu a pridani noveho
- 2026-03-20 08:05: projektova dukumetace
- 2026-03-21 20:56: uprava programu
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 12 / 20 b. (60%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 4 |
| Změněné soubory | 5 |
| Počet přid./odeb. řádků kódu | 560 |
Komentář a zpětná vazba od AI
Ahoj, jako tvůj pedagogický asistent jsem prošel tvou práci za uplynulý týden. Udělal jsi obrovský kus práce, zejména v oblasti grafického rozhraní, ale jsou zde i nedostatky v organizaci a popisech, na které se musíme zaměřit.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [1 bod]:
Tvé zprávy u commitů jsou velmi stručné a málo vypovídající. Zprávy jako „uprava programu“ nebo „projektova dukumetace“ (obsahující navíc překlep) neříkají nic o tom, co konkrétně se v kódu změnilo. Příště se pokus popsat, jakou novou funkci jsi přidal nebo jakou chybu jsi opravil (např. „Přidání GUI rozhraní pomocí Tkinter pro chatbota“).
2. Smysluplnost komentářů v kódu [2 body]:
V souboru Jednoduchý chatbot.py jsi přidal pouze jeden velmi stručný komentář. V novém souboru ChatbotApp.py, který je poměrně rozsáhlý, zcela chybí vnitřní komentáře u jednotlivých metod. I když jsou názvy funkcí srozumitelné, v dokumentaci Kalkulacka_4_operace_projekt.md jsi sliboval, že „každá funkce bude okomentována“, což jsi v kódu nedodržel.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:
- Struktura: Chválím rozdělení do složek. Nicméně v kořenovém adresáři se nachází soubor/složka
/Kalkulator, která tam dle pravidel nemá co dělat. Také soubor/kalkulacka/1.pymá nesmyslný název; měl by se jmenovat např.kalkulacka_konzole.py. - Dokumentace: Dokumentace k chatbotovi a převodníku je zpracována velmi pěkně a podrobně. Naopak hlavní
README.mdv rootu je graficky i textově rozbité („K a l k u l a k a“), což působí velmi neprofesionálně.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Zde tě musím velmi pochválit. Přechod od jednoduchých konzolových skriptů k objektově orientovanému programování s grafickým rozhraním (tkinter) je skvělý progres.
* Plusy: Použití slovníků pro převodní faktory v unit_converter, správné ošetření výjimek try-except u uživatelských vstupů a implementace messagebox pro interakci.
* Mínusy: V souboru Jednoduchý chatbot.py jsi přidal import os a import sys, které ale v kódu nikde nepoužíváš. Soubor ChatbotApp.py končí uprostřed slova gu (pravděpodobně guess_number), což znamená, že kód je neúplný a nefunkční v této verzi.
Celkem získáno bodů: [12 / 60%] ze 20 možných
Slovní zhodnocení:
Tvůj pokrok v Pythonu je viditelný, zejména odvaha pustit se do GUI aplikací. Musíš si ale dávat větší pozor na čistotu odevzdávané práce – nenechávat v kódu rozepsané části (nedokončená funkce guess_number), mazat nepoužívané importy a dodržovat kulturu pojmenovávání souborů a psaní commitů. Dokumentace je tvá silná stránka, tak ji zkus přenést i do formy komentářů přímo v kódu.
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V dokumentaci v bodě 4.11 detailně popisuješ funkci pro zobrazení počasí pomocí knihovny requests, ale v souboru ChatbotApp.py pod tlačítkem 11 tato funkce chybí, je tam místo ní podruhé ukončení programu a v importech knihovnu requests vůbec nemáš – můžeš mi vysvětlit, proč tvůj kód v tomto bodě neodpovídá dokumentaci?