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

1. Úvod¶

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.

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.

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.

1.4 Rozsah projektu¶

Viz.: Vize projektu

2. Obecný popis¶

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.

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.

2.3 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.

2.4 Omezení návrhu a implementace¶

Popis architektury
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ů.

3. Funkce systému¶

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

3.1 Export dat¶

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

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.

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ů.

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.

3.2 Výpočet statistik¶

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

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ě.

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.

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ů