Luros
Období: Týden 10/2026 (od 02.03.) 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-03-02 07:33: first commit
- 2026-03-02 09:03: pridal sem do luros neco
- 2026-03-02 09:05: pridal sem text
- 2026-03-02 09:08: Update lurosfirst.py
- 2026-03-02 09:10: zkouska pushe
- 2026-03-02 09:12: smazal sem vsechny testovaci texty
- 2026-03-02 09:17: prejmenoval sem soubor
- 2026-03-02 09:25: vytvoril sem hru
- 2026-03-02 09:26: vytvoril sem hru
- 2026-03-02 09:28: Update prvnitest.py
- 2026-03-02 09:33: vytvoril sem jednoduchou hru hadej cislo
- 2026-03-02 14:56: zkousim propojeni s githubem doma
- 2026-03-02 15:02: zkousim propojeni s githubem doma
- 2026-03-05 13:36: vytvoril sem prostředí pro tetris
- 2026-03-05 13:45: vytvoril sem pozadi pro tetris
- 2026-03-05 13:54: dokumentace k projektu tetris
- 2026-03-05 13:56: moje první dokumentace k projektu Tetris
- 2026-03-05 14:57: Update README.md
- 2026-03-05 21:40: přidána dokumentace projektu
- 2026-03-05 21:45: upraveno
- 2026-03-05 21:52: Přidány komentáře do funkce mrizka
- 2026-03-05 21:59: doplněna dokumentace
- 2026-03-06 09:47: upravena velikost herního pole
- 2026-03-06 10:00: Přidán padající blok se zastavením na spodku
- 2026-03-06 10:16: Přidáno ukládání dopadlých bloků a spawning nového bloku
- 2026-03-06 10:22: Přidáno stackování bloků a změněna barvy na modrou
- 2026-03-06 10:28: Aktualizovaná dokumentace podle stavu hry
- 2026-03-06 11:08: Přidána složka pro projekt receptů
- 2026-03-06 11:18: Přidán gitignore pro ochranu API klíče
- 2026-03-06 11:47: Přidány importy a funkce pro hledání receptů
- 2026-03-06 11:48: Přidán gitignore pro .vscode složku
- 2026-03-06 11:50: Odstraněna složka .vscode z repozitáře
- 2026-03-06 11:56: Přidány funkce pro vyhledávání a výpis receptů
- 2026-03-06 11:58: Dokončena základní funkcionalita vyhledávání receptů
- 2026-03-06 17:59: Opraveno vyjíždění bloků z mřížky
- 2026-03-08 22:18: upraven vzhled hry
- 2026-03-09 07:30: Aktualizovan seznam projektu v README
- 2026-03-09 09:01: podminky.md
- 2026-03-09 09:33: pridan soubor podminky.md
3. Výsledky AI analýzy kódu
| Metrika | Hodnota |
|---|---|
| Celkové body (AI) | 16 / 20 b. (80%) |
| Náročnost projektu (Index) | 3 |
| Počet commitů | 36 |
| Změněné soubory | 9 |
| Počet přid./odeb. řádků kódu | 650 |
Komentář a zpětná vazba od AI
Jako tvůj pedagogický asistent jsem prošel tvůj repozitář a kód za uplynulý týden. Zde je tvé hodnocení:
1. Smysluplnost popisů u commitů [2 body]
Zprávy z konce týdne jsou v pořádku (např. „Opraveno vyjíždění bloků z mřížky“ nebo „Přidány funkce pro vyhledávání a výpis receptů“). Jasně popisují, co se v kódu změnilo. Nicméně v pondělí a úterý jsou zprávy velmi strohé („upraveno“, „pridal sem text“, „Update lurosfirst.py“), což ztěžuje orientaci v historii změn. Také se snaž sjednotit jazyk (mícháš češtinu s diakritikou, bez ní a angličtinu).
2. Smysluplnost komentářů v kódu [4 bodů]
Tvůj kód je komentován srozumitelně. Oceňuji, že vysvětluješ i logiku (např. u časovače v Pygame nebo parametrů API). Pomáhá to v orientaci tobě i komukoliv, kdo by kód četl. Bod strhávám za občasné komentování naprosto zřejmých věcí, jako je # Hlavní část programu nebo # Adresa API pro hledání receptů, které kód spíše opticky natahuje.
3. Kvalita a srozumitelnost dokumentace (README.md, _projekt.md) [2 body]
Dokumentace k projektu Tetris je zpracovaná výborně. Obsahuje vše důležité: cíl, aktuální stav, technický popis logiky (seznam dopadle_bloky) i návod na instalaci a ovládání. README v kořeni je sice stručné, ale pro navigaci v projektech zatím postačuje.
4. Logika řešení a přemýšlení studenta v Pythonu (progrese kódu) [5 bodů]
V uplynulém týdnu jsi udělal velký kus práce. Přechod od prázdného okna k fungujícímu stackování bloků v Tetrisu je logicky správně zvládnutý. Použití pygame.time.get_ticks() pro řešení pádu bloku je elegantní. Také tě chválím za projekt s recepty – správné použití knihovny requests a zabezpečení API klíče pomocí .env a .gitignore je pokročilá technika, která se cení.
Našel jsem však nedostatek v logice kolizí:
* V ovládání pohybu šipkami kontroluješ pouze okraj mřížky, ale ne kontrolu, zda už na daném místě není jiný blok: if event.key == pygame.K_LEFT and blok_x > 0: <span style='color: red;'>zde je chyba</span> (umožní ti to vjet padajícím blokem „do“ jiného bloku, který už leží na dně).
* V souboru tetris.py máš v jedné verzi barvy nastavené na zelenou a v další na modrou, ale v dokumentaci píšeš o modré – hlídej si konzistenci mezi kódem a popisem.
Celkem získáno bodů: [13 / 65%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
V dokumentaci píšeš, že hra končí při zaplnění mřížky až nahoru, ale v kódu žádnou takovou kontrolu zatím nemáš – co se tedy v aktuální verzi hry stane v momentě, kdy se nově vytvořený blok na pozici
[5, 0]objeví na stejném místě, kde už jeden pevný blok ze seznamudopadle_blokyleží?