Osnova dokumentace maturitní práce

Šablonu dokumentu včetně návodu naleznete na školním Moodle po přihlášení školním účtem Intranetu OA.

Obsah 1 Struktura práce 2 Jak si rozvrhnout čas 3 Úvod práce 4 Teoretický úvod do problematiky 4.1 Seznámení čtenáře s problematikou 4.2 Použité technologie 4.3 Průzkum konkurenčních řešení 5 Popis řešení 5.1 Model dat aplikace 5.2 Návrh uživatelského rozhraní a jeho testování 5.3 Popis implementace 5.4 Popis testování produktu 5.5 Zdůvodnění případných změn 5.6 Výsledky 5.7 Porovnání s alternativními produkty 6 Závěr 7 Použité zdroje 8 Přílohy 9 Obsah CD 10 Související stránky

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

1. Úvodní stránka
2. Prohlášení, zadání, další povinné informace...
3. 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,...
4. Obsah (seznam kapitol — ideálně s hypertextovými odkazy)
5. Ú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.
6. 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.
7. 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
8. Závěr
   • Znovu stručně — co se povedlo udělat, co se nepovedlo.
9. 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:

1. co jste chtěli řešit (úvod)
2. proč jste to chtěli řešit (úvod)
3. jaké technologie jste chtěli použít (úvod)
4. jaké úkoly je třeba splnit (úvod)
5. jak se pozná, jestli jste zadání splnili: „co produkt musí splňovat“ (úvod)
6. co se vám povedlo (závěr)
7. jaké změny v zadání jste museli provést a proč (závěr)
8. v čem by se mělo (dalo) pokračovat dál v případných navazujících projektech (závěr)

Dále je stručně popsán obsah jednotlivých kapitol Vaší 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.

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.

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

Související stránky

• Harmonogram maturitní práce