Litr
Období: Týden 22/2026 (od 31.05.) Skupina: tria URL: https://github.com/6makaleo9/Litr.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) | ❌ NESPLNĚNO |
2. Přehled commitů
- 2026-06-01 18:26: nova ability na dalku
- 2026-06-03 18:05: nove efekty pro slash utok
- 2026-06-06 16:08: pridana stamina
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 20 / 20 b. (100%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 3 |
| Změněné soubory | 1 |
| Počet přid./odeb. řádků kódu | 288 |
Komentář a zpětná vazba od AI
Ahoj, zde je tvé hodnocení za uplynulý týden. Odvedl jsi velký kus práce, zejména na vizuální stránce a herní logice projektu Dashing Kostka.
1. Smysluplnost popisů u commitů [3 body]:
Všechny tři commity jsou stručné, jasné a přesně popisují provedenou změnu. Je vidět, že pracuješ systematicky a zprávy jako „pridana stamina“ nebo „nova ability na dalku“ usnadňují orientaci v historii projektu.
2. Smysluplnost komentářů v kódu [6 bodů]:
Komentáře v kódu jsou na velmi vysoké úrovni. Oceňuji zejména:
* Vysvětlení matematických operací (výpočet úhlů u slash efektů).
* Jasné oddělení sekcí kódu pomocí dekorativních čar (např. ─── ZDRAVÍ HRÁČE ───), což zvyšuje čitelnost.
* Popis parametrů u nových konstant (např. u STAMINA_REGEN_MS).
* zde je chyba: V komentáři u regenerace staminy uvádíš "1 za sekundu", ale v kódu máš STAMINA_REGEN_MS = 250, což odpovídá 4 bodům za sekundu. Pozor na nesoulad mezi dokumentací a realitou kódu.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]:
Struktura repozitáře je příkladná. Každý projekt má svou vlastní složku a v rootu se nachází pouze README.md. Soubory jsou pojmenovány logicky a přehledně. Dokumentace v README.md sice obsahuje zvláštní formátování (mezery mezi písmeny), ale je informativní a jasně definuje cíle projektů.
4. Logika řešení a přemýšlení studenta v Pythonu [9 bodů]:
V této oblasti jsi udělal největší pokrok. Implementace systému staminy je logická a správně navázaná na herní mechaniky (dash a air slash).
* Vzdušný slash: Oceňuji vytvoření samostatné třídy AirSlash. Použití math.atan2 pro výpočet směru letu a následné otočení o 90 stupňů pro vykreslení efektu řezu ukazuje pokročilé pochopení vektorové geometrie v hrách.
* Vizuální efekty: Implementace "glow" efektu pomocí pygame.SRCALPHA a postupného vykreslování čar s různou průhledností je kreativní řešení, které posouvá hru z čistě funkční na esteticky zajímavou úroveň.
* Regenerace: Správně používáš pygame.time.get_ticks() pro nezávislou regeneraci staminy, což je mnohem lepší přístup než prosté přičítání v každém snímku (framerate independent).
* zde je chyba: Při výpočtu šířky stamina baru (stamina_bar_w) používáš konstantu PLAYER_MAX_HP. I když to v aktuálním nastavení může vizuálně sedět, logicky by šířka lišty měla být definována samostatnou konstantou nebo odvozena od maximální staminy, aby při změně počtu životů lišta nečekaně nezměnila velikost.
Celkem získáno bodů: [20 / 100%] ze 20 možných
Tento týden jsi splnil zadání na maximum a tvůj kód vykazuje známky dobrého architektonického návrhu. Pokračuj v tomto tempu!
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V mechanismu regenerace staminy používáš k aktualizaci času výpočet
last_stamina_regen += steps * STAMINA_REGEN_MS– mohl bys vysvětlit, v čem je toto řešení lepší než prostélast_stamina_regen = now_ticksv situaci, kdy by se hra na krátkou chvíli zasekla?