Katana
Období: Týden 11/2026 (od 15.03.) Skupina: tria URL: https://github.com/maximjavorsky-code/Katana.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 07:09: Create Kalkulačka
- 2026-03-16 07:32: Rename Kalkulačka to Kalkulacka
- 2026-03-16 07:56: ---
- 2026-03-16 07:57: ---
- 2026-03-16 08:03: Vyřešen konflikt v README
- 2026-03-16 08:07: Přidána GUI kalkulačka a dokumentace projektu
- 2026-03-16 08:13: Přidán kód a dokumentace GUI kalkulačky
- 2026-03-18 16:17: Přidána složka Blackjack
- 2026-03-18 16:22: Přidání lokálních souborů před pull
- 2026-03-18 16:23: Vyřešen konflikt README.md
- 2026-03-19 15:19: Přidána hra Kostky
- 2026-03-19 15:20: Úprava README
- 2026-03-20 15:11: Přidán chatbot
- 2026-03-20 15:12: Aktualizace README
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 17 / 20 b. (85%) |
| Náročnost projektu (Index) | 4 |
| Počet commitů | 14 |
| Změněné soubory | 14 |
| Počet přid./odeb. řádků kódu | 1587 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci za uplynulý týden. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]:
Většina tvých commitů je věcná a jasně popisuje provedené změny (např. „Přidána hra Kostky“, „Aktualizace README“). Oceňuji i záznamy o řešení konfliktů. Nicméně tvé dva commity z 16. 3. s popisem "---" jsou naprosto nepřípustné, protože neposkytují žádnou informaci o tom, co se v kódu změnilo.
2. Smysluplnost komentářů v kódu [6 bodů]:
V této kategorii odvádíš skvělou práci. Kód je komentován přehledně, vysvětluješ účel funkcí i jednotlivých bloků (např. u kalkulačky nebo hry Kostky). U projektu Blackjack oceňuji i použití docstringů u tříd a metod, což svědčí o tvé snaze o profesionální zápis kódu.
3. Kvalita a srozumitelnost dokumentace (README.md, _projekt.md) a struktura repozitáře [1 bod]:
Dokumentace projektů (Markdown soubory) je vynikající, obsahuje popisy, pravidla i návody ke spuštění. Bohužel jsi ale hrubě porušil pravidlo o adresářové struktuře. Soubory Kalkulacka_GUI_Kod.py a Kalkulacka_GUI_Dokumentace leží volně v kořenovém adresáři (rootu). Každý projekt musí mít svou vlastní složku, aby byl repozitář přehledný. Také soubor Kalkulacka_GUI_Dokumentace postrádá příponu .md.
4. Logika řešení a přemýšlení studenta v Pythonu (progrese kódu) [8 bodů]:
Tvá logika je na velmi dobré úrovni a vidím zde velký progres:
* Kalkulačka: Funkční využití knihovny tkinter a efektivní (i když v praxi riskantní) využití funkce eval().
* Kostky a Chatbot: Dobrá práce se slovníky a náhodnými prvky.
* Blackjack: Zde jsi postoupil k objektově orientovanému programování (třídy Card, Deck, Player), což je náročné a logicky správně uchopené.
* Vytknutí: V souboru Blackjack_hra.py je kód v závěru neúplný a utržený v polovině slova: self.money = money # <span style='color: red;'>Dos</span>. Pravděpodobně se ti nepodařilo nahrát celý soubor.
Celkem získáno bodů: [17 / 85%] ze 20 možných
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
V souboru
Kalkulacka_GUI_Kod.pyu funkcevytvor_tlacitkopoužíváš v parametrucommandzápis slambda– co přesně by se v aplikaci změnilo, kdybys tam nechal jenstisk(text)bez té lambdy?