ASWI - Pokročilé softwarové inženýrství » ASWI 2021 » Administrativní klient pro systém SensLog (KGM/ReliSA) - CodeBakers

h1. Příprava schůzek

h2. 23. 3. 2021 – Příprava na schůzku se zadavatelem

Lukáš

* ukázat a popsat artefakt aplikace

* zjistit požadované layouty

* získat sample dat, které jsou zpožděná v čase

* domluvit se na vývojovém prostředí

Jakub

* API endpointy (na sensory, units) vrací 500, erroy po přihlášení uživatele (zkoušel jsem oba dva testovací), fungují jenom endpointy na grupy

* jaké grupy mají mít admin práva??

* bude dashboard dostupný i bez přihlášení, nebo všechno schovat za přihlášení? Jde mi o tom, jestli na login dělat extra stránku

* všechny API jsou athorizována maximálně přes JSESSIONID?

Martin

* Mohou být data nulová a pokud ano jak mají být zobrazena v grafu (vůbec nebo nulová)

* Jaký typ grafů použít

* Jakým způsobem vykreslit data, která nejsou časově synchronizovaná

* Má obsahovat i jinou funkčnost než je zobrazování dat ze senzorů

Štěpán

* Z předchozí komunikace jsem nabyl dojmu, že už teď existuje aplikace, která vizualizuje data z dodaných end pointů. Tato aplikace však některá data z end pointů vykresluje nežádoucím způsobem a problém nějak souvisí s časovou synchronizací dat

* Pochopil jsem správně, že tato aplikace existuje?

* Pochopil jsem správně, že vykresluje určitých typ dat nežádoucím způsobem?

* Bylo by možné upřesnit, v čem chyba vzniká a jaké je požadované chování grafu

* Pokud už tato aplikace existuje, bylo by možné specifikovat další ohledy ve kterých tato aplikace nevyhovuje, abychom se těchto chyb vyvarovali?

* Jinak viz výše, tj. především konkrétní seznam případů, která data odkud mají být vykreslována (a jak se k nim dostat) a jaká je požadovaná vizualizace

* Jaké jsou hlavní funkční a mimofunkční požadavky na aplikaci? Existují nějaké nepovinné (nice to have) požadavky navíc?

h2. 8. 4. 2021 – Příprava na schůzku se zadavatelem

Jakub

* SensLog Lite v2 nabizi moznost dostat seznam jednotek pro uzivatele ale potrebujeme poslat jeho ID -> kde to ID vezmeme, kdyz po prihlaseni pres SensLog v1 nam prijde jenom jsessionid??

* SensLog Lite v2 ma jenom tyhle endpointy co jsme dostali ve wiki? https://students.kiv.zcu.cz:3443/projects/aswi2021codebakers/wiki/SensLog_Lite_v2 nikde jsem nenasel dokumentaci

* ad https://students.kiv.zcu.cz:3443/issues/8510#change-27854

** kde vememe endpointy na provadeni techto operaci? v SensLog v1 jsou prevazne popsane jenom GET API s vyjimkou insertu cele jednotky, observace, alertu. Podle struktury JSON body, nejsem presvedcen, ze bych tim dokazal Unit updatovat. k v2 nemame dokumentaci a ve standardu OGC jsem se popravde ztratil, tak tam jsem to mohl prehlednout

** nechapu ani zapis reseni aktivity viz prvni radek: _units = unit_id, decription, is_mobile, unit_type_id (číselník)_ > jak bychom mohli editovat unit_id kdyz podle schematu je to primarni klic? co tedy mame editovat?

* ad https://students.kiv.zcu.cz:3443/issues/8407

** user: přejmenovat unit, sensor > nenašel jsem pro to vhodné enpointy

** user, admin: vlozit pozici k unit > dostanu false, ale jak zjistim co jsem poslal spatne?? https://students.kiv.zcu.cz:3443/dmsf/files/700/view

** user: potreboval bych vysvetlit jak je mysleno struktura sve grupy (vim ze existuje vazebni tabulka units_to_groups) ale to jsem myslel, ze uz obstarava server na zaklade toho co mu posleme za jsessionid (my zadnej filter na FE nedelame) a backend nam vrati vsechny jednotky, chapu to tak spravne?

** user, admin: data v libovolnem useku > budeme data nejak agregovat pri zadani velkych (predem urcenych) intervalu? (eg. uzivatel zada interval vetsi jak rok [co jsem zkousel, tak nam prijde ze serveru cca 46K zaznamu a jeste nesezarenych podle datumu, takze je to docela overkill to seradit na frontend pred zobrazenim] tak mu automaticky na backendu poslat v requestu aby mu je to grouplo napr po tydnech?)

** admin: registrovat unit > s nasimi uzivateli to nemohu ani vyzkouset https://students.kiv.zcu.cz:3443/dmsf/files/701/view

** admin: endpoint na registraci samotneho sensoru? jak pak sparovat? nenasel jsem endpointy (mozna budou v OGC standardu, ale v tom jsem se ztratil)

** admin: vytvořit grupu podřízenou své grupě, tzn. parent_group_id = group_id admina > endpoint? (mozna budou v OGC standardu, ale v tom jsem se ztratil)

** admin: vytvořit a přiřadit nového uživatele k nové grupě, může mít rights_id jen 1 nebo 2 > endpointy? (mozna budou v OGC standardu, ale v tom jsem se ztratil)

https://www.meteoblue.com/en/weather/week/prague_czech-republic_3067696

h2. 26. 4. 2021 – Příprava na schůzku se zadavatelem

Lukáš

* jaké komponenty mají být zobrazeny po přihlášení na dashboard

* jaké komponenty budou zobrazeny při zobrazení grafu – graf a jeho ovládací prvky?

Jakub

* mohli bychom pro uživatele kiv dostávat roli admin? můžeme to teď podstrkávat, ale radši bych pracoval jen s daty co dostanu z BE

* smazani unit - http code 200 s message ze unit nemuze byt smazan mi neprijde vhodne zvoleny

* zakladani unit - zalozenou unit nasledne nedostanu pres endpoint /DataService?Operation=GetUnits

*Poznámky ze schůzky:*

* dashboard se dostyluje:

** seskupit editační funkce (add unit; edit unit) - https://www.primefaces.org/primeng/showcase/#/toolbar

** sekupit view tlačítka 

** podbarvit data podle typu senzorů

** barevnou paletu sladíme s logem

* zobrazení grafů

** maximálně týden úseku dat -> všechno nad týden bude agregované (AVG) -> v případě volných časových kapacit buffer (MIN; MAX)

** data se budou zobrazovat z jedné jednotky

** zobrazení grafů "od/do" za pomocí HTML input date *!nedovolit zadavat datum do budoucnosti!*

*Akceptační kritéria:*

* Přihlášení uživatele

* Přidat uživatele - role admin

* Přidat unit - role admin, user

* Upravit unit (description) - role admin, user

* Odstranit unit - role admin, user

* Přidat sensor k unit - role admin, user

* Upravit sensor (sensorTypes, sensorName - unikátní, phenomenId) - role admin, user

* Odstranit sensor - role admin, user

* Zobrazit graf jednoho sensoru - role admin, user

* Zobrazit graf unit (možnost vybrat zobrazení dat ze sensorů na unit) - role admin, user