Bizon
Období: Týden 13/2026 (od 29.03.) Skupina: tria URL: https://github.com/stepanlenczowski-debug/Bizon.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-30 07:24: Vytvoření začátku kodu organizér souboru
- 2026-03-30 07:27: Přidané organizáter souboru do kořenové složky
- 2026-03-31 10:52: Dodělání kodu na organizator souboru
- 2026-04-04 20:41: Přidání README
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ů | 4 |
| Změněné soubory | 3 |
| Počet přid./odeb. řádků kódu | 82 |
Komentář a zpětná vazba od AI
Ahoj, jsem tvůj pedagogický asistent a prostudoval jsem tvou práci v repozitáři za uplynulý týden. Zde je tvé hodnocení založené na odevzdaných souborech a provedených změnách.
1. Smysluplnost popisů u commitů [3 body]
Tvé popisky jsou jasné a srozumitelné. Z chronologie je patrné, jak jsi na projektu pracoval (začátek, přesun, dokončení). Oceňuji, že v popisu uvádíš konkrétní činnost, kterou jsi provedl. Pozor jen na drobné překlepy ("organizáter").
2. Smysluplnost komentářů v kódu [6 bodů]
Kód v souboru organizer_souboru.py je komentován příkladně. Komentáře vysvětlují každou logickou sekci (kategorie, kontrola existence složky, ošetření duplicit), což usnadňuje orientaci v kódu. Pro příště bys mohl zkusit přidat i krátký docstring na začátek souboru s popisem celkového účelu skriptu.
3. Kvalita a srozumitelnost dokumentace a struktura repozitáře [0 bodů]
V této kategorii musím body strhnout kvůli porušení základních pravidel organizace repozitáře:
- Soubory v rootu: V hlavním adresáři (rootu) se ti nachází soubor organizer_souboru.py. Podle metodiky musí mít každý projekt svou vlastní složku a kód nesmí ležet volně.
- Neshoda v názvech: V README.md uvádíš projekt č. 04 jako "Organizátor hesel", ale tvůj kód a složka se jmenují Organizátor_hesel/organizer_souboru.py, přičemž kód reálně organizuje soubory na disku podle přípon, nikoliv hesla. Tato nekonzistence je matoucí.
- Chybějící dokumentace: Pro nový projekt (Organizátor souborů) zcela chybí dokumentační soubor (např. organizator_projekt.md), který by popisoval funkcionalitu, na rozdíl od tvých předchozích projektů.
4. Logika řešení a přemýšlení studenta v Pythonu [7 bodů]
Samotná logika skriptu pro organizaci souborů je napsána velmi dobře:
- Ošetření kolizí: Velmi oceňuji implementaci while cyklu pro přidávání číselného indexu (_1, _2), pokud soubor se stejným názvem v cílové složce již existuje. To svědčí o pokročilém přemýšlení nad edge-cases (mezními stavy).
- Kategorizace: Použití slovníku pro mapování kategorií na seznamy přípon je elegantní a snadno rozšiřitelné.
- Práce s knihovnami: Správně využíváš moduly os a shutil.
- Chyba v zadání: Bodové srážky jsou zde za to, že tvůj kód vůbec neodpovídá deklarovanému cíli v README ("Organizátor hesel"). Pokud jsi změnil zadání z organizátoru hesel na organizátor souborů, měl jsi aktualizovat i dokumentaci.
Celkem získáno bodů: [16 / 80%] ze 20 možných
DIFFICULTY_INDEX: [3]
Kontrolní otázka k obhajobě
Jakým způsobem tvůj kód v cyklu
whilezajistí, že se soubor nakonec přejmenuje právě nadata_2.txt, pokud v cílové složce už existují souborydata.txtidata_1.txt?