Titan
Období: Týden 10/2026 (od 08.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-09 07:39: first commit
- 2026-03-09 07:42: first commit
- 2026-03-09 08:01: kalkulačka, uprava readme
- 2026-03-10 09:47: uprava programu
- 2026-03-13 11:33: projektova dokumentace a uprava programu
- 2026-03-13 19:52: uprava programu
- 2026-03-13 20:16: novy program uprava REDME
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ů | 7 |
| Změněné soubory | 5 |
| Počet přid./odeb. řádků kódu | 153 |
Komentář a zpětná vazba od AI
Jako tvůj pedagogický asistent jsem prostudoval tvou práci za uplynulý týden. Je vidět, že jsi pokročil v organizaci kódu do funkcí a začal jsi používat pokročilejší datové struktury, jako jsou slovníky. Nicméně v tvé práci se objevilo i několik nedostatků, na které se musíme zaměřit.
Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]
Tvé commity jsou sice pravidelné a popisují, na čem jsi pracoval (např. "projektova dokumentace a uprava programu"), ale jsou poměrně strohé a opakující se. V jednom z nich máš také překlep ("uprava REDME"). Příště zkus být konkrétnější v tom, co přesně jsi v programu upravil (např. "oprava logiky dělení nulou v kalkulačce").
2. Smysluplnost komentářů v kódu [4 body]
V kódu se snažíš vysvětlit, co jednotlivé části dělají, což je chvályhodné. Zejména u převodníku jednotek jsou komentáře užitečné. U kalkulačky je ale komentář typu „karkulator“ v úvodu zbytečný a obsahuje překlep. Oceňuji však popis funkce u převodníku.
3. Kvalita a srozumitelnost dokumentace (README.md, _projekt.md) a struktura repozitáře [1 bod]
Zde mám několik zásadních výtek:
* Struktura a názvy: Chválím rozdělení do složek. Nicméně soubor kalkulacka/1.py má zde je chyba (nesmyslný název). Soubory by se měly jmenovat reprezentativně, např. kalkulacka_v1.py nebo prostě main.py.
* README.md: Tvůj hlavní soubor README je v aktuální podobě zde je chyba (je téměř nečitelný kvůli zvláštnímu formátování s mezerami mezi každým písmenem).
* Projektová dokumentace: Dokumentace v .md souborech je naopak zpracována velmi pěkně a podrobně, což ti zachránilo body v této kategorii.
4. Logika řešení a přemýšlení studenta v Pythonu (progrese kódu) [5 bodů]
V logice vidím velký rozdíl mezi oběma programy:
* Převodník jednotek: Velmi oceňuji použití slovníku (prevodni_faktory) a matematický přístup k výpočtu přes společný základ (metr). To ukazuje na dobré programátorské přemýšlení. Program ale zde je chyba (vůbec se neptá na hodnotu, kterou chce uživatel převést, pouze vypíše koeficient).
* Kalkulačka: V průběhu týdne jsi v kódu nechal začátečnické syntaktické chyby, které by program okamžitě zastavily:
* 1 = print ("Zadej...") zde je chyba (přiřazení do literálu čísla).
* 4 = print ("Výsledek: ") zde je chyba (stejný problém na konci souboru).
* Pozitivní je, že v poslední verzi jsi tyto nesmyslné řádky odstranil a implementoval jsi ošetření dělení nulou.
Celkem získáno bodů: [12 / 60%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V převodníku jednotek tvůj vzorec pro výpočet proměnné
faktorvrátí při převodu z kilometrů (km) na metry (m) hodnotu 0.001 – dokážeš vysvětlit, proč ti vyšlo právě toto číslo a jaký konkrétní vstup od uživatele v programu chybí, aby mohl uživatel skutečně převést např. 5 kilometrů na metry?