Litr
Období: Týden 11/2026 (od 15.03.) 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-03-16 07:09: zmena README.md
- 2026-03-16 08:14: zmena barvy naboju
- 2026-03-19 19:40: ESC na stopnutí hry
- 2026-03-20 20:44: Zlepšení zobrazení pauzy
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 19 / 20 b. (95%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 4 |
| Změněné soubory | 2 |
| Počet přid./odeb. řádků kódu | 303 |
Komentář a zpětná vazba od AI
Dobrý den, jako váš pedagogický asistent jsem prošel vaše odevzdané soubory a kód za uplynulý týden. Zde je vaše hodnocení:
1. Smysluplnost popisů u commitů [3 body]:
Vaše popisy commitů jsou stručné, jasné a věcně popisují změny, které jste v kódu provedl (např. „ESC na stopnutí hry“, „Zlepšení zobrazení pauzy“). To je správná praxe, která usnadňuje orientaci v historii projektu.
2. Smysluplnost komentářů v kódu [6 bodů]:
V kódu používáte komentáře k oddělení logických sekcí (např. # definice tlacitek, # paused overlay). Velmi oceňuji komentář u max_bullet_speed, kde vysvětlujete, proč je tato hodnota zavedena (prevence glitchování). Pomáhá to pochopit záměr autora.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [2 body]:
Dodržel jste pravidlo samostatné složky pro projekt (/Bouncy-Kostka/). Soubory mají jasné názvy. README.md obsahuje všechny potřebné sekce (popis, funkce, instalace) a dává jasnou představu o tom, co hra umí. Jen pozor na kódování/formátování textu v README, v surovém výpisu se zdá být proložen mezerami, ale struktura je v pořádku.
4. Logika řešení a přemýšlení studenta v Pythonu [8 bodů]:
Prokázal jste výrazný pokrok. Implementace systému pauzy není triviální, protože vyžaduje zastavení herní logiky při zachování vykreslování a obsluhy událostí pro UI.
- Pauza a čas: Správně jste vyřešil problém s časovači (cooldowny a trvání efektu void). Výpočet pause_delta a následná korekce void_time a cooldown_time svědčí o hlubším pochopení toho, jak Pygame pracuje s časem (pygame.time.get_ticks()).
- UI: Logika tlačítek pomocí collidepoint na Rect objektech je standardní a čisté řešení.
- Drobné nedostatky:
- V kódu pro resetování cooldownu máte duplicitu: bullets_shot = 0 <span style='color: red;'>bullets_shot = 0</span> (řádek 138 v souboru).
- Logika pro přepínání pauzy a výpočet časového posunu je duplikována jak v obsluze klávesy ESC, tak v obsluze tlačítka "Resume". Bylo by elegantnější tuto logiku vyčlenit do samostatné funkce (např. toggle_pause()).
Celkem získáno bodů: [19 / 95%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
Proč v kódu při pauze ukládáš zbývající čas cooldownu do speciální proměnné
cooldown_remaining_on_pausea následně ho složitě dopočítáváš, místo abys u něj použil stejnou logiku jako uvoid_time, kde ti stačí prosté přičtenípause_delta?