Luros
Období: Týden 16/2026 (od 19.04.) Skupina: tria URL: https://github.com/antoninkucera-lang/Luros.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-04-20 06:37: smazana slozka
- 2026-04-20 06:37: smazany slozky
- 2026-04-20 08:01: vytvoren nový projekt
- 2026-04-24 19:59: vytvorena dokumentace a pridan kod
- 2026-04-24 20:00: upraven kod a dokumentace
- 2026-04-25 19:25: Přidány základy chatbota s Groq API
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ů | 6 |
| Změněné soubory | 10 |
| Počet přid./odeb. řádků kódu | 128 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj asistent pro výuku Pythonu. Prošel jsem tvůj repozitář a tvou práci za uplynulý týden. Tady je mé hodnocení:
1. Smysluplnost popisů u commitů [2 body]
Většina tvých commitů je srozumitelná (např. „Přidány základy chatbota s Groq API“), ale objevují se i méně konkrétní popisy jako „upraven kod a dokumentace“ nebo „vytvoren nový projekt“. Příště se zkus více zaměřit na to, co konkrétně se změnilo (např. „Implementace historie konverzace v chatbotu“).
2. Smysluplnost komentářů v kódu [5 bodů]
Komentáře v souboru chatbot.py jsou velmi dobré. Oceňuji, že vysvětluješ účel proměnných (např. seznam historie) i logiku funkcí. Pomáhá to v orientaci v kódu. Jeden bod strhávám za to, že u složitějších částí (jako je volání API) by mohl být komentář ještě o něco detailnější ohledně toho, co přesně objekt odpoved obsahuje.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [1 bod]
Adresářová struktura je v pořádku, projekty máš logicky rozdělené do složek. Dokumentace k novému chatbotu je velmi přehledná a profesionální.
Bohužel musím strhnout bod za soubor 02_recepty/02_recepty_projekt.md. Nechal jsi v něm zde je chyba (pozůstatky po nepovedeném mergi v Gitu):
<<<<<<< Updated upstream
8. Tlačítko **Vymazat** smaže pole i výsledky
9. Pomocí tlačítka dole můžeš přepnout světlý nebo tmavý režim
=======
8. Pomocí tlačítka dole můžeš přepnout světlý nebo tmavý režim
>>>>>>> Stashed changes
Tento text dělá dokumentaci nečitelnou. Před commitem si vždy zkontroluj, zda jsi vyřešil všechny konflikty.
4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]
V projektu Chatbota prokazuješ dobrou progresi. Správně využíváš seznam historie pro simulaci paměti AI, což je klíčový koncept pro tento typ aplikace. Také správně používáš knihovnu python-dotenv pro zabezpečení API klíče.
V logice funkce posli_zpravu však chybí dokončení:
1. Funkce sice vytvoří objekt odpoved, ale zde je chyba — chybí return (návratová hodnota), takže program s odpovědí nemůže dále pracovat.
2. Data z API je potřeba „rozbalit“ (např. odpoved.choices[0].message.content), aby uživatel dostal čistý text.
3. V seznamu README.md jsi správně aktualizoval projekt č. 03, což ukazuje, že udržuješ přehled o svém postupu.
Celkem získáno bodů: [15 / 75%] ze 20 možných
DIFFICULTY_INDEX: [4]
Kontrolní otázka k obhajobě
V dokumentaci k chatbotu uvádíš, že si aplikace pamatuje celou historii konverzace, ale ve tvé funkci
posli_zpravuvidím, že do seznamuhistoriepřidáváš pouze zprávu od uživatele – jakým způsobem tedy zajistíš, aby AI při příští otázce věděla, co ti odpověděla v předchozím kroku?