Osnova dokumentace maturitní práce
Šablonu dokumentu včetně návodu naleznete na školním Moodle po přihlášení školním účtem.
Obsah |
Struktura práce
Odborné práce mají záměrně velmi pevnou strukturu. Cílem je, aby čtenář nemusel číst celou práci, ale rychle našel vše, co potřebuje.
- Součásti odborné práce
- Úvodní stránka
- Prohlášení, zadání, další povinné informace...
- Anotace/resumé
- Celý projekt shrnutý do dvou odstavců co se dělá a jaké technologie použijeme
- Když si ji přečtu, měl bych vědět, jestli chci číst dál
- Nepište: že je to projekt na OA, že vás to bavilo,...
- Obsah (seznam kapitol — ideálně s hypertextovými odkazy)
- Úvod
- Motivace a cíl práce
- Od začátku, je třeba představit důležité pojmy
- Část informací už zazněla v anotaci, ale úvod musí být samostatně čitelný i pro toho, kdo anotaci nečetl.
- Teoretický úvod
- Stručné představení pozadí projektu.
- Na IT typicky netriviální technologie, které jste použili a ostatní by nemuseli znát.
- O každé technologii cca 1-2 odstavce souvislého textu — ne jen body.
- Popis práce
- ...
- Tady se struktura kapitol může lišit podle povahy práce
- Sem patří i kapitola s návodem na instalaci a zprovoznění projektu
- Závěr
- Znovu stručně — co se povedlo udělat, co se nepovedlo.
- Použité zdroje
- Formátujte podle normy (použijte Citace.com)
- Jaké zdroje uvádět:
- Pěkné podrobné tutoriály, učebnice, které si uživatel může přečíst o daném tématu a které vám pomohly.
- Konkrétní zdroje, které citujete v práci.
- Konkrétní zdroje, ze kterých jste brali kód či myšlenky.
- Min. 5 zdrojů (relevantních).
Jak si rozvrhnout čas
Nejdůležitější (a nejsložitější) je napsat úvod a závěr. Tyto dvě kapitoly by měly stačit k tomu, aby čtenář pochopil:
- co jste chtěli řešit (úvod)
- proč jste to chtěli řešit (úvod)
- jaké technologie jste chtěli použít (úvod)
- jaké úkoly je třeba splnit (úvod)
- jak se pozná, jestli jste zadání splnili: „co produkt musí splňovat“ (úvod)
- co se vám povedlo (závěr)
- jaké změny v zadání jste museli provést a proč (závěr)
- v čem by se mělo (dalo) pokračovat dál v případných navazujících projektech (závěr)
Tedy úplně nejdůležitější je úvod. Protože závěr už vlastně vychází z úvodu a komentuje, co se povedlo a co ne. Stejně jako ostatní kapitoly, které rozvíjí témata, nastíněná v úvodu práce.
Navíc v úvodu musíte začít... Zkrátka, úvod budete opakovaně přepisovat a doplňovat, brrr! Ale vyplatí se to! ;)
Dále je stručně popsán obsah jednotlivých kapitol Vaší práce.
Pro konkrétní projekty lze samozřejmě osnovu upravit, k úpravám by však měl být dobrý důvod a doporučujeme změny konzultovat s vedoucím práce.
Úvod práce
Popište na cca jedné straně formátu A4, co jste řešili a k jakým výsledkům jste dospěli. Při psaní vycházíte z úvodní analýzy.
- Co bylo cílem práce?
- fungující program?
- porovnání metod?
- vyzkoušení postupu, technologie, nástroje,...?
- ...
- Cílová skupina uživatelů
- Pro jakou cílovou skupinu je produkt určený.
- Jaké jsou požadavky na výsledný produkt?
- Klademe nějaká omezení na produkt? Co musí splňovat? Proč? (Buďte konkrétní!!!)
- Jaké prostředky jsme použili?
- Popis výsledku
- Jaké jsou základní součásti produktu?
- K jakým výsledkům jste dospěli?
- Do jaké fáze původně plánovaného rozsahu se podařilo dojít?
- Splnili jste základní prototyp?
- Zvládli jste vyřešit některá rozšíření? Která?
- Narazili jste na neočekávané problémy? Jaká řešení jste nalezli?
- Praktické nasazení
- Je výsledný produkt někde používán v praxi?
- Je takové použití domluveno, plánováno?
- Porovnání s existujícími produkty
- Existují nějaké podobné produkty?
- V čem je projekt jiný než podobné existující produkty?
- Stručně obsah dalších kapitol
- Ke každé z dalších kapitol (kromě závěru) shrňte jednou větou, o čem kapitola je.
Teoretický úvod do problematiky
Seznámení čtenáře s problematikou
Pokud se zabýváte tématem, které není běžně známé, připravte pro čtenáře stručný souhrn, který potřebuje pro pochopení vaší práce.
Zde budete často pracovat se zdroji, které si přečtete a na základě nichž text zpracujete.
Pokud je vaším úkolem vytvořit aplikaci (mobilní, webovou,...), tuto část nejspíš můžete vynechat.
Použité technologie
Popište technologie, které jste použili. Vysvětlete jejich význam v rámci vašeho projektu. Očekávejte, že Váš čtenář má základní přehled v oblasti IT, ale nezná konkrétní náležitosti Vašeho produktu.
Například pro projekt programovaný pomocí knihovny GD v PHP stačí jen velmi letmo zmínit, co je to jazyk PHP, měli byste se ale podrobněji zabývat funkcemi knihovny GD, které jste ve svém projektu použili.
Průzkum konkurenčních řešení
Prozkoumejte, jaká alternativní řešení se nabízí na trhu. Vyzkoušejte je, projděte jejich vlastnosti a sepište stručný souhrn. Shrňte, v čem má být vaše aplikace/váš produkt jiná(ý)/lepší.
Tuto část obvykle řešíte ještě před začátkem řešení.
Popis řešení
Popište důležité součásti vašeho řešení.
Konkrétní obsah se liší podle povahy projektu. Pokud například srovnáváte dva e-learningové systémy, bude obsah této kapitoly zcela jiný než u projektu, kde se vytváří aplikace.
Ale pokud programujete aplikaci, velmi často budete psát následující části:
Model dat aplikace
Popište, s jakými daty pracuje vaše aplikace. Využijte ER model či diagram tříd podle toho, jestli je vaše aplikace založena na SQL databázi, či spíše objektově orientovaná (můžete samozřejmě použít oboje, pokud vaše aplikace používá obojí).
Návrh uživatelského rozhraní a jeho testování
Na začátku práce si potřebujete rozmyslet, jak bude vypadat uživatelské rozhraní vaší aplikace. Zde je dobré místo shrnout návrh a zdůvodnit volby.
Popíšete také, jakým způsobem jste návrh aplikace testovali.
Popis implementace
Popište, jakým způsobem vaše aplikace zpracovává data.
Pokud jste museli najít či vymyslet nějaký náročnější algoritmus, popište zde jeho fungování.
Opět očekávejte od svého čtenáře základní přehled v oblasti IT zhruba na úrovni úspěšného absolventa naší školy.
Není tedy například třeba popisovat, jak funguje ve Vašem kódu podmínka if
či cyklus for
v PHP, vysvětlete spíše, proč je tuto podmínku potřeba pohlídat a k čemu používáte proměnné v podmínce, pokud jejich význam není být z názvu zcela zřejmý.
Popis testování produktu
Popište, jakým způsobem jste testovali svůj produkt. Uveďte kterým lidem jste produkt nechávali testovat, jaké podněty jste z testování získali a jak jste je promítli do výsledného produktu.
Zdůvodnění případných změn
Pokud jste museli upravit původní znění zadání, zde je dobré místo pro podrobnější zdůvodnění změn.
Výsledky
K čemu jsme dospěli, co výsledný program umí. Co se naopak nepovedlo a jak jsme to napravili.
U některých projektů je tuto kapitolu možné a vhodné spojit se závěrem, zvláště pokud je výsledkem projektu program a výsledkem práce je tedy kód programu. Naopak u teoreticky zaměřených prací je tato kapitola obvykle obsáhlejší a v závěru zmíníte pouze nejzásadnější výsledky.
Porovnání s alternativními produkty
V úvodu jsme nastínili vizi, jak to mělo být. Tady už pracujeme s tvrdou realitou. Jak je na tom náš produkt ve skutečnosti... ;) Samozřejmě pouze pokud je výsledkem projektu nějaký produkt. ;)
Závěr
- Shrňte vlastnosti výsledného produktu.
- Podařilo se nám splnit cíle projektu? Které ano a které ne? Zdůvodněte.
- Museli jsme učinit nějaké významné změny v porovnání s původní představou? Vysvětlete proč.
- Splnil produkt původní požadavky a očekávání? Pokud ne, proč? Pokud je v něčem dokonce překonal, uveďte.
- Navrhněte další možná témata případných navazujících projektů. Co by šlo dále zlepšit.
Použité zdroje
- Uvádíte zdroje, které:
- doslovně citujete v práci.
- Z nichž čerpáte informace.
- Které považujete za zajímavé a doporučujete čtenáři jejich studium.
- Není třeba rozlišovat, do které z kategorií zdroj patří.
- Neměli byste citovat zdroje, které jste vůbec nečetli. Někdy se rozlišují kapitoly: Použitá literatura a Doporučená literatura.
Viz také: Citování zdrojů
Přílohy
- Uživatelská příručka aplikace (pokud je produktem aplikace).
- Zdrojový kód. (Zvláště u rozsáhlejších projektů ale není nutné. Lze vybrat jen části, nebo kód přiložit pouze na CD).
Obsah CD
- elektronická podoba textu práce
- kompletní zdrojové kódy
- skript pro vytvoření databáze, pokud je potřeba
- hesla a přihlašovací jména účtů pro vyzkoušení aplikace