připomenutí předchozí hodiny a uvedení problému „Refaktoring a čitelnost kódu“. 5–12 min: stručná teorie – refaktoring, čitelnost, pojmenování, duplicita, komentář. 12–18 min: společná ukázka prvního kroku a kontrolních kritérií. 18–36 min: samostatná práce nebo práce ve dvojici – Upravit nepřehledný funkční program, zachovat chování a doložit změny testy. 36–41 min: vzájemná kontrola podle zadání a oprava zjištěné chyby. 41–45 min: uložení výstupu (Původní a refaktorovaná verze), krátký exit ticket a pojmenování dalšího kroku.
Testování, ladění a práce s chybou · 45 minut
Refaktoring a čitelnost kódu
Žák zlepší názvy, členění a opakování bez změny výsledku.
00
ČASOVÁ OSA
Struktura 45minutové hodiny
01
VIDEO LEKCE
Ukázka a vysvětlení postupu
▶
Video je připravené k doplnění
Video ukáže princip, první kroky, kontrolu a typickou chybu. Nebude obsahovat celý hotový upravitelný úkol.
provider: youtube · youtubeId: ""02
STUDIJNÍ MATERIÁL
Výklad: z čeho se učíš
Chyba není pouze neúspěch, ale informace o tom, kde se skutečné chování liší od očekávání. Systematické testování odděluje domněnku od důkazu.
V hodině „Refaktoring a čitelnost kódu“ je hlavním cílem: Žák zlepší názvy, členění a opakování bez změny výsledku. Nejde pouze o dokončení jednotlivých kliknutí nebo příkazů; důležité je umět vysvětlit, proč zvolený krok vede k cíli a co se v průběhu práce mění.
Klíčové pojmy refaktoring, čitelnost, pojmenování, duplicita, komentář tvoří společný jazyk pro popis řešení. Při praktické práci v prostředí „Python / VS Code“ sleduj vstup, jednotlivé kroky, mezivýsledek a způsob kontroly. Pokud některý krok nelze popsat nebo zopakovat, postup ještě není dostatečně přesný.
Praktická část vychází ze zadání: Upravit nepřehledný funkční program, zachovat chování a doložit změny testy. Výsledkem musí být „Původní a refaktorovaná verze“. Hotový výstup nestačí pouze ukázat; musí být možné doložit, že vznikl z pracovních podkladů a že splňuje uvedená hodnoticí kritéria.
Před odevzdáním ověř zejména: Stejné chování a lepší struktura. U programů nebo modelů použij více vstupů, u diagramů zkontroluj vztahy a popisky, u dokumentace ověř úplnost. Chybu nejprve přesně popiš, potom změň jen jednu věc a znovu výsledek otestuj.
Slovníček pojmů
refaktoring
Úprava vnitřní struktury programu bez změny jeho požadovaného chování.
čitelnost
Míra, s jakou člověk dokáže rychle pochopit strukturu, názvy a záměr kódu nebo dokumentu.
pojmenování
Volba názvů, které jednoznačně a srozumitelně popisují význam proměnných, polí, souborů nebo částí systému.
duplicita
Opakovaný záznam nebo část obsahu, která má být podle pravidel uvedena pouze jednou.
komentář
Text ve zdrojovém kódu určený čtenáři, který program při spuštění neprovádí.
03
ŘÍZENÁ PRÁCE
Postup krok za krokem
- 01
Ve studentské lekci si přečti cíl a otevři pracovní podklady. Připrav prostředí: Python / VS Code. Originální podklady ponech beze změny a pracuj s kopií ve vlastní složce.
- 02
Pojmenuj pracovní složku ve tvaru „44_refaktoring-a-citelnost-kodu_prijmeni“. Uvnitř odděl zdrojové soubory, vlastní práci a výsledný export.
- 03
Rozděl zadání na menší ověřitelné kroky: Upravit nepřehledný funkční program, zachovat chování a doložit změny testy. Nejprve vytvoř nejjednodušší funkční nebo srozumitelnou variantu.
- 04
Po každém významném kroku výsledek spusť, otevři nebo jinak zkontroluj. Zapisuj testovací vstup, skutečný výsledek a případnou opravu; neměň více nezávislých věcí najednou.
- 05
Porovnej práci s kritérii „Stejné chování a lepší struktura“. Oprav alespoň jednu konkrétní slabinu zjištěnou vlastní nebo vrstevnickou kontrolou.
- 06
Ulož zdrojovou i výslednou podobu. Odevzdej „Původní a refaktorovaná verze“ v požadovaném formátu a přidej krátké zdůvodnění, jak jsi správnost ověřil/a.
04
PRACOVNÍ PODKLADY
Stáhni si soubory, se kterými budeš pracovat
Náhled ukazuje pouze strukturu a typ výsledku. Hotové upravitelné řešení ve studentské části není.
.TXT
44 Podklady Readme
↓Pracovní podklad určený k samostatnému zpracování.
44_PODKLADY_README.txt · 1 kB.PY
44 Startovni Program
↓Pracovní podklad určený k samostatnému zpracování.
44_startovni_program.py · 1 kB.CSV
44 Vstupni Data
↓Pracovní podklad určený k samostatnému zpracování.
44_vstupni_data.csv · 1 kBDůležité: Podklady jsou vstupy k práci, nikoli kompletní řešení. Vlastní výsledek musí vzniknout podle zadání, testu a reflexe.
05
OTEVŘENÉ ODPOVĚDI
Pracovní list
1. Startovací otázkaStačí 2–3 věty; důležitý je konkrétní výchozí příklad.
Co už o tématu „Refaktoring a čitelnost kódu“ víš? Uveď konkrétní příklad nebo situaci.
2. Práce s pojmyDefinici spoj s konkrétním krokem, hodnotou nebo částí výstupu.
Vysvětli vlastními slovy alespoň tři pojmy: refaktoring, čitelnost, pojmenování, duplicita, komentář. Ke každému přidej použití v dnešní úloze.
3. Rozhodnutí a zdůvodněníUveď nejméně dvě možné varianty a kritérium volby.
Které rozhodnutí je při řešení úkolu „Upravit nepřehledný funkční program, zachovat chování a doložit změny testy.“ nejdůležitější a podle čeho je uděláš?
4. Plán praktické prácePostup má mít vstup, očíslované kroky, kontrolu a očekávaný výstup.
Rozepiš vlastní postup k zadání: Upravit nepřehledný funkční program, zachovat chování a doložit změny testy.
5. SebekontrolaKaždou otázku musí být možné zodpovědět důkazem z práce.
Převeď hodnoticí kritéria na kontrolní otázky: Stejné chování, lepší struktura.
6. Exit ticketOdpověď musí být konkrétní a vztahovat se k dnešní práci.
Napiš jeden pochopený princip, jednu provedenou opravu a jeden další krok.
06
PRAKTICKÁ PRÁCE
Refaktoring a čitelnost kódu
Upravit nepřehledný funkční program, zachovat chování a doložit změny testy. 1. Pojmenuj pracovní složku ve tvaru „44_refaktoring-a-citelnost-kodu_prijmeni“. Uvnitř odděl zdrojové soubory, vlastní práci a výsledný export. 2. Rozděl zadání na menší ověřitelné kroky: Upravit nepřehledný funkční program, zachovat chování a doložit změny testy. Nejprve vytvoř nejjednodušší funkční nebo srozumitelnou variantu. 3. Po každém významném kroku výsledek spusť, otevři nebo jinak zkontroluj. Zapisuj testovací vstup, skutečný výsledek a případnou opravu; neměň více nezávislých věcí najednou. 4. Porovnej práci s kritérii „Stejné chování a lepší struktura“. Oprav alespoň jednu konkrétní slabinu zjištěnou vlastní nebo vrstevnickou kontrolou.
Očekávaný výstup
Původní a refaktorovaná verze
07
DŮKAZ O UČENÍ
Odevzdání praktického úkolu
Otevřená odpověď
Původní a refaktorovaná verze
Dokonči praktickou práci a odevzdej důkaz: Původní a refaktorovaná verze. Použij studentské podklady, zpracuj je samostatně a před odevzdáním projdi kontrolní kritéria. Hotové řešení je dostupné pouze v učitelské části.
Zatím nebyl vybrán žádný soubor.
V samostatném HTML se ukládají odpovědi a názvy vybraných souborů pouze do tohoto prohlížeče. Skutečný upload provede aplikace Kurzy/Studio.
08
ZÁVĚREČNÁ KONTROLA
Test
09
REFLEXE
Co si z lekce odnášíš
Dokončeno neznamená pouze vytvořeno. Po dokončení lekce prokážeš cíl odevzdáním výstupu: Původní a refaktorovaná verze. Výsledek zkontroluj podle kritérií: Stejné chování a lepší struktura.