ASWI - Pokročilé softwarové inženýrství » ASWI 2025 » Úprava CZECH SALIVARY GLAND DATABASE (Brůha) - Havlík-Jelínek

h1. Specifikace

---

* *Verze:* 1.0

* *Autor:* Bc. Vojtěch Jelínek

* *Datum:* 12-03-2025

* *Stav:* Čeká na potvrzení

h2. Historie revizí:

|_.Autor|_.Datum|_.Důvod změny|_.Verze|

| Bc. Vojtěch Jelínek | 12-03-2025 | První verze specifikace | 1.0 |

---

h1. 1. Úvod

---

Tento dokument popisuje požadavky na rozšíření funkcionality aplikace *Czech Salivary Gland Database*. Cílem je definovat funkční i nefunkční požadavky, rozhraní a omezení projektu.

h1. 2. Přehled systému

---

Projekt rozšiřuje stávající aplikaci *Czech Salivary Gland Database* o:

* *Submodul Kalendář* pro evidenci a správu kontrol pacientům,

* *Submodul Nezhoubné nádory* pro ukládání pacientů s nezhoubnými nádory,

* *vylepšení filtrování* v seznamu pacientů.

Systém je desktopová aplikace pro Windows, postavená na technologiích Electron, ReactJS, NodeJS, SQLite.

h1. 3. Funkční požadavky

---

h2. 3.1. Submodul Kalendář

* *FP-1.1:* Tlačítko @Plánované kontroly@ v menu aplikace.

** *FP-1.1.1:* Při kliknutí na tlačítko se zobrazí kalendář v centrální části aplikace.

* *FP-1.2:* Kalendář zobrazující pacienty s naplánovanou kontrolou.

** *FP-1.2.1:* V kalendáři jsou zobrazeny pouze dny, na které je naplánovaná kontrola.

** *FP-1.2.2:* Jednotlivé dny jsou nadepsány datem a následně obsahují seznam pacientů s naplánovanou kontrolou. V seznamu jsou zobrazeny pouze jména a příjmení pacientů.

* *FP-1.3:* Možnost filtrování v kalendáři.

** *FP-1.3.1:* Uživatel může filtrovat kalendář pomocí data od-do. Po zadání data od-do se zobrazí pouze dny, na které je naplánovaná kontrola.

** *FP-1.3.2:* Filtr bude klasický tzv. Datepicker.

* *FP-1.4:* Export seznamu pacientů s naplánovanou kontrolou pro tisk.

** *FP-1.4.1:* Uživatel může exportovat seznam pacientů s naplánovanou kontrolou do PDF souboru.

** *FP-1.4.2:* Export bude obsahovat jména a příjmení pacientů a datum kontroly.

h2. 3.2. Submodul Nezhoubné nádory

* *FP-2.1:* Databáze bude rozšířena o pacienty s nezhoubnými nádory.

* *FP-2.2:* Princip přidávání pacientů s nezhoubnými nádory bude stejný jako u pacientů s nádory zhoubnými.

** *FP-2.2.1:* Po kliknutí na tlačítko v menu @Přidat pacienta@ se zobrazí dvě tlačítka v centrální části okna aplikace: @Zhoubný nádor@ a @Nezhoubný nádor@.

** *FP-2.2.2:* Po kliknutí na tlačítko @Nezhoubný nádor@ se zobrazí tři tlačítka pro každou z žláz zaznamenávaných v databázi: @Příušní@, @Podčelistní@, @Podjazykové@.

** *FP-2.2.3:* Po kliknutí na tlačítko pro konkrétní žlázu se zobrazí formulář pro přidání pacienta s nezhoubným nádorem do databáze.

* *FP-2.3:* Pacienti s nezhoubnými nádory budou zobrazeni v seznamu pacientů stejně jako pacienti s nádory zhoubnými.

** *FP-2.3.1:* V seznamu pacientů bude u pacientů s nezhoubnými nádory zobrazena ikona pro snadnou identifikaci.

h2. 3.3. Filtrování

* *FP-3.1:* Filtrování v seznamu pacientů bude vylepšeno.

** *FP-3.1.1:* Uživatel bude mít možnost filtrovat pacienty podle více kritérií najednou. Kde stěžejními kritérii budou:

*** *recidiva* (ano/ne),

*** *nádor* (zhoubný/nezhoubný),

*** *stav* (zemřel/žije),

*** *pohlaví* (muž/žena).

h1. 4. Use Case scénáře

---

h2. 4.1 UC-1: Naplánování kontroly pacienta

* *Popis:* Lékař chce naplánovat kontrolu pacienta.

* *Primární aktéři:* Lékař.

* *Kroky:*

** 1. Lékař otevře seznam pacientů.

** 2. Lékař vybere pacienta, kterému chce naplánovat kontrolu.

** 3. Lékař vyplní položku @Datum plánované kontroly@.

h2. 4.2 UC-2: Zobrazení kalendáře s naplánovanými kontrolami

* *Popis:* Lékař chce zobrazit kalendář s naplánovanými kontrolami.

* *Primární aktéři:* Lékař.

* *Kroky:*

** 1. Lékař klikne na tlačítko @Plánované kontroly@ v menu aplikace.

** 2. Zobrazí se kalendář s naplánovanými kontrolami.

h2. 4.3 UC-3: Přidání pacienta s nezhoubným nádorem

* *Popis:* Lékař chce přidat pacienta s nezhoubným nádorem.

* *Primární aktéři:* Lékař.

* *Kroky:*

** 1. Lékař klikne na tlačítko @Přidat pacienta@ v menu aplikace.

** 2. Lékař klikne na tlačítko @Nezhoubný nádor@.

** 3. Lékař vybere žlázu, ke které chce přidat pacienta.

** 4. Lékař vyplní formulář pro přidání pacienta s nezhoubným nádorem.

h2. 4.4 UC-4: Filtrování pacientů

* *Popis:* Lékař chce filtrovat pacienty podle více kritérií.

* *Primární aktéři:* Lékař.

* *Kroky:*

** 1. Lékař otevře seznam pacientů.

** 2. Lékař klikne na tlačítko @Filtrovat@.

** 3. Lékař vybere kritéria, podle kterých chce filtrovat pacienty.

** 4. Lékař potvrdí filtrování.

h2. 4.5 UC-5: Export seznamu pacientů s naplánovanou kontrolou pro tisk

* *Popis:* Lékař chce exportovat seznam pacientů s naplánovanou kontrolou do PDF souboru.

* *Primární aktéři:* Lékař.

* *Kroky:*

** 1. Lékař klikne na tlačítko @Plánované kontroly@ v menu aplikace.

** 2. Lékař klikne na tlačítko @Exportovat@.

** 3. Soubor se uloží na disk ve formátu @.pdf@ do adresáře, který zvolí lékař.

h1. 5. Mimofunkční požadavky

---

* *NFP-1:* *Kompatibilita* - Nové funkce nesmí narušit stávající funkčnost aplikace.

* *NFP-2:* *Zálohování* - Nová data musí být součástí systému zálohování.

h1. 6. Rozhraní

---

* *GUI:* Aplikace bude mít stejné grafické rozhraní jako stávající aplikace.

* *Databáze:* SQLite databáze bude rozšířena o nové tabulky pro nové funkce.

* *API:* Lokální NodeJS server bude rozšířen o nové API pro nové funkce.

h1. 7. Omezení a předpoklady

---

* *O-1:* Aplikace bude dostupná pouze pro Windows.

* *O-2:* Data nebudou synchronizována mezi více uživateli.

* *O-3:* Uživatelé musí manuálně plánovat kontroly pacientů.

* *O-4:* Uživatelé musí manuálně aktualizovat aplikaci na novou verzi.