ASWI - Pokročilé softwarové inženýrství » ASWI 2017 » Modul pro analýzu medicínských dat (KIV neuro) - Heidtke

h1. Modul pro analýzu medicínských dat - DOKUMENT SPECIFIKACE POŽADAVKŮ

h2. 1.	Úvod

h3. 1.1	Předmět specifikace

Specifikace se zabývá modulem pro analýzu medicínských dat. Tento modul by měl být rozdělen do dvou oddělených částí. První částí je export dat z databáze do xls souboru a druhou částí je výpočet statistik a jejich následné grafické zobrazení. Verze: 1.0.

h3. 1.2	Typografické konvence

Běžný text: písmo Times, velikost 12 pt, zarovnání do bloku

Nadpis 1. úrovně: písmo Times, velikost 18 pt, mezera před 24 b., mezera za 12 b.

Nadpis 2. úrovně: písmo Times, velikost 14 pt, mezera před 14 b., mezera za 14 b.

Odstavec: Řádkování přesné, 12 b.

h3. 1.3	Cílové publikum, návod ke čtení

Specifikace je určena pro team vývojářů, mentora a zákazníka.

Specifikace je rozdělena do dalších X kapitol. Ve druhé kapitole je obecně popsán vyvíjený produkt. V následující kapitole jsou podrobně popsány jednotlivé jeho funkce. Čtvrtá kapitola se potom zabývá vnějšími rozhraními a kapitola pátá potom dalšími mimofunkčními požadavky, jako je kvalita či výkonnost.

h3. 1.4	Rozsah projektu

Viz.: [[Vize projektu]]

h2. 2.	Obecný popis

h3. 2.1	Kontext systému

Vyvíjený produkt je modulem do prototypu webové aplikace, která slouží ke sběru medicínských dat. Aplikace má být během vývoje tohoto produktu nasazena do ostrého provozu. Modul má na základě sesbíraných dat počítat statistiky a umožnit export těchto dat.

h3. 2.2	Funkce produktu

Výpočet a zobrazování statistik na nasbíraných datech.

Export nasbíraných dat do souboru ve formátu xls.

h3. 2.3	Třídy uživatelů

****************** to be done

h3. 2.4	Provozní prostředí

Aplikace běží zároveň na dvou serverech. Server primární, je ten, kde je spuštěna hlavní stabilní verze vyvíjené aplikace a server sekundární, kde se testují všechny nové vyvíjené funkčnosti. Na serverech běží operační systém Linux.

h3. 2.5	Omezení návrhu a implementace

Backend aplikace je vyvíjen v programovacím jazyce Python3. Využívá se zde frameworku Flask pro jednodušší implementaci. Pro další funkčnost jsou doinstalovány různé doplňky (knihovny) Pythonu. Frontend je realizován pomocí HTML, CSS a JavaScriptu. JavaScript bude pro zobrazování statistik v grafech zásadní. Databáze je relační. Naměřená data jsou ukládána ve formátu JSON z důvodu proměnlivosti experimentů.

h3. 2.6	Uživatelská dokumentace

[[Wiki]]

•	To be done

h2. 3.	Funkce systému

Modul by měl mít základní dvě funkce: export dat a výpočet statistik nad daty.

h3. 3.1	Export dat

Export dat do formátu xls, se kterým se pracuje v programu Excel.

h4. 3.1.1	Popis a priorita

Funkce má zajistit exportování dat z databáze do souboru xls v požadovaném formátu. Funkce má střední prioritu.

h4. 3.1.2	Události a odpovědi

Uživatel si na webových stránkách pomocí check boxů může vybrat z prováděných experimentů, buď jeden, nebo více. Po kliknutí na tlačítko „Export“ se stáhne soubor, který bude obsahovat data z požadovaných experimentů.

h4. 3.1.3	Funkční požadavky

POŽADAVEK-1: Data budou exportována do souboru xls ve formátu specifikovaném zákazníkem (např. hlavičky sloupců, sloučené buňky, rozdělení dat atd.)

POŽADAVEK-2: Data bude možné stáhnout pro jeden či více experimentů (měření) najednou.

h3. 3.2	Výpočet statistik

Výpočet a grafické zobrazení statistik nad nasbíranými daty.

h4. 3.2.1	Popis a priorita

Modul má zajistit výpočet statistik z dat, která jsou sesbírána na různých akcích. Po té data přehledně zobrazit v grafické podobě.

h4. 3.2.2	Události a odpovědi

Uživatel si na webových stránkách může vybrat některý z prováděných experimentů (měření). Po kliknutí na odkaz „view“ se zobrazí nová stránka, kde budou zobrazeny číselné a grafické statistiky, dle požadavků zákazníka.

h4. 3.2.3	Funkční požadavky

POŽADAVEK-1: Zobrazení základních dat experimentu, kolik se účastnilo lidí a jejich genderové rozložení. Průměrný věk.

POŽADAVEK-2: Genderové rozložení bude zobrazeno graficky v koláčovém grafu.

POŽADAVEK-3: Věk bude rozdělen po desetiletích a zobrazen v histogramu.

POŽADAVEK-4: Pod těmito základními statistikami budou zobrazeny karty s jednotlivými kategoriemi experimentu. V každé kategorii budou vypočítány základní statistiky, jako jsou průměry nebo procentuální úspěšnost.

POŽADAVEK-5: Uživatel si bude moct vybrat, pro jakou skupinu budou zobrazeny statistiky na kartách. Skupiny budou rozděleny na muže a ženy a k tomu také na jednotlivé věkové dekády.

POŽADAVEK-6: Statistiky budou na kartách graficky úhledně zobrazeny, pomocí grafů a obrázků