drobek
Období: Týden 10/2026 (od 08.03.) Skupina: tria URL: https://github.com/jakubdrobisz-cloud/drobek.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-11 15:40: Přidání hry Hádej číslo
- 2026-03-11 15:56: Create 01_HadejCislo
- 2026-03-11 15:58: Delete 01_HadejCislo
- 2026-03-11 16:05: Přidán projekt Hádej číslo s kódem a dokumentací
- 2026-03-11 16:11: Přidán projekt Hádej číslo s kódem a dokumentací
- 2026-03-11 16:24: Přidán projekt Hádej číslo s kódem a dokumentací
- 2026-03-11 16:26: Přidán projekt Hádej číslo s dokumentací
- 2026-03-11 16:32: Rename 01_HadejCislo_dokumentace.md to 01_HadejCislo_projekt.md
- 2026-03-13 08:51: Přidán kód hry Hádej číslo a dokumentace projektu
- 2026-03-13 08:54: Přidán kód hry Hádej číslo
- 2026-03-14 20:14: Přidán kód hry Hádej číslo a dokumentace projektu
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 15 / 20 b. (75%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 11 |
| Změněné soubory | 8 |
| Počet přid./odeb. řádků kódu | 141 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci na projektu „Hádej číslo“. Zde je tvé hodnocení za uplynulý týden:
1. Smysluplnost popisů u commitů [3 body]:
Tvé zprávy u commitů jsou jasné a srozumitelné. Oceňuji, že z nich lze vyčíst postupný vývoj projektu (přidání kódu, přejmenování souborů, doplnění dokumentace). To je v programátorské praxi velmi důležité.
2. Smysluplnost komentářů v kódu [4 body]:
V kódu se nachází docstring u funkce ask_yes_no, což je skvělá ukázka dobré praxe. Nicméně zbytek kódu (zejména logika ve funkci hra) by si zasloužil alespoň krátké komentáře vysvětlující, co dělají jednotlivé bloky (např. ošetření vstupu nebo výpočet použitých pokusů). Úvodní komentář #budu delat kod pro hadani cisla je spíše pracovní poznámka než dokumentace kódu.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]:
V této kategorii musím body strhnout kvůli porušení pravidel organizace projektu:
- Struktura: V hlavní složce (rootu) repozitáře se nachází soubor /hadejcislo.py. Podle zadání mají být všechny soubory s kódem v samostatné složce projektu (což jsi sice udělal v /01_HadejCislo/, ale v rootu zbyl duplicitní soubor).
- README.md: Obsah tvého hlavního README.md je v aktuální verzi velmi špatně čitelný (obsahuje extrémní množství mezer: # d r o b e k). To působí neprofesionálně a ztěžuje to orientaci v projektu. Dokumentace v 01_HadejCislo_projekt.md je však v pořádku.
4. Logika řešení a přemýšlení studenta v Pythonu (progrese kódu) [8 bodů]:
Tady tě musím pochválit, tvá progrese v psaní kódu je vynikající:
- Ošetření chyb: Správně jsi implementoval try-except blok pro zachycení chyby, když uživatel nezadá číslo.
- Dekompozice: Rozdělení kódu na logické části (ask_yes_no, hra, main) je přesně to, co od středoškolského studenta očekávám.
- Parametrizace: Funkce hra používá výchozí parametry (min_cislo=1, max_cislo=100, max_pokusy=8), což zvyšuje znovu-použitelnost kódu.
- Správná konvence: Použití if __name__ == "__main__": ukazuje, že o Pythonu přemýšlíš v širším kontextu než jen jako o jednoduchém skriptu.
Drobná pochvala za logický výpočet proměnné pouzite, kde správně pracuješ s počtem pokusů.
Celkem získáno bodů: [15 / 75%] ze 20 možných
Slovní shrnutí: Logicky je tvůj program na velmi vysoké úrovni a tvé dovednosti v Pythonu (funkce, výjimky) jsou nadstandardní. Musíš si však dát větší pozor na „pořádek v dílně“ – tedy na to, kde máš uložené soubory a jak vypadá tvá úvodní dokumentace (README). Odstraň prosím soubory z hlavní složky a oprav formátování textu.
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
V poslední verzi funkce
hramáš na konci výpis „Prohrál jsi“, který není v žádné podmínce ani v blokuelse– jak je tedy možné, že se tato zpráva nevypíše i v případě, že hráč vyhraje?