Titan
Období: Týden 18/2026 (od 03.05.) Skupina: tria
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) | ✅ SPLNĚNO |
Vypočtený Index za tento týden: 144
Týdenní Index Náročnosti dodaných skriptů (1-5): 3
2. Kvantitativní přehled úprav
| Metrika | Hodnota |
|---|---|
| Počet všech commitů | 1 |
| Počet změněných souborů | 2 |
| Počet přid./odeb. řádků kódů | 53 |
Přehled commitů
- 2026-05-09 20:03: uprava programu kalkulačka
3. Hodnocení asistentem AI (Logika a úsilí)
Ahoj, jsem tvůj asistent pro výuku Pythonu. Prostudoval jsem tvou práci za uplynulý týden a zde je tvé hodnocení. Oceňuji zejména tvou přípravu dokumentace, která je na velmi vysoké úrovni, ale musíme zapracovat na struktuře tvého repozitáře.
1. Smysluplnost popisů u commitů [1 bod]:
V uplynulém týdnu jsi vytvořil pouze jeden commit s popisem "uprava programu kalkulačka". To je velmi málo. Commit by měl popisovat co a proč jsi změnil (např. „Přidání dokumentace a ošetření dělení nulou u kalkulačky“). Jeden commit na takové množství změn v kódu a dokumentaci je nedostatečný pro sledování historie tvé práce.
2. Smysluplnost komentářů v kódu [6 bodů]:
V této kategorii jsi odvedl skvělou práci. Kód v souboru kalkulacka/1.py je nyní vzorně okomentovaný. Oceňuji použití docstringů u funkcí (parametry, návratová hodnota) a vysvětlení jednotlivých bloků kódu. Velmi to pomáhá čitelnosti.
Poznámka: V původní verzi jsi měl překlep: # kalkulator <span style='color: red;'>nastaevuje</span> funkci. V nové verzi už je text profesionálnější.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]:
Zde mám k tvé práci nejvíce výhrad, i když samotný obsah dokumentačních souborů (_projekt.md) je výborný.
- Struktura repozitáře: Porušil jsi pravidlo o souborech v rootu. Soubory <span style='color: red;'>/chat_log.txt</span> a <span style='color: red;'>/vymazani zvuku.py</span> leží volně v hlavní složce, místo aby byly ve vlastním projektu.
- Pojmenování: Soubor <span style='color: red;'>kalkulacka/1.py</span> má nevhodný název. Měl by se jmenovat např. kalkulacka.py.
- Překlepy v názvech: Složka a soubor <span style='color: red;'>konventor</span> by se měly správně jmenovat "konvertor".
- Chyba v dokumentaci: V souboru chatbot_projekt.md ti u popisu hesla uprostřed věty končí text: „malá a velká pís“.
4. Logika řešení a přemýšlení studenta v Pythonu [6 bodů]:
Logika tvé kalkulačky je správná. Dobře jsi implementoval funkci kalkulacka() s parametry, což je lepší než psát vše do jednoho bloku. Ošetření dělení nulou pomocí podmínky if cislo2 != 0 funguje správně. Progrese je vidět hlavně v organizaci kódu – z prostého skriptu jsi udělal strukturovanou funkci. Celkově je ale objem nové logiky za týden menší, protože většina práce byla věnována komentování a dokumentaci.
Celkem získáno bodů: [14 / 70%] ze 20 možných
DIFFICULTY_INDEX: [3]