ASWI - Pokročilé softwarové inženýrství » ASWI 2023 » Vylepšení funkcí a rozhraní frameworku SPADe (Pícha) - PRO_grammers.

h1. Popis a cíle frameworku SPADe

h2. Popis stávajícího SPADe frameworku

Během projektu vývoje softwaru se projektový manažer snaží vyhnout špatným praktikám a anti-vzorům, aby tak předešel případnému snížení pravděpodobnosti úspěšného dokončení projektu. Některé špatné praktiky však

na první pohled nemusí být zřejmé a k jejich odhalení může dojít až v případě, kdy už významně negativně ovlivnily průběh projektu. Tento problém

by mohla řešit automatická detekce špatných praktik a anti-vzorů už v jejich počáteční fázi. Díky tomu by měl projektový manažer prostor adekvátně

zareagovat. (Petr Štěpánek, 2022)

V současné době neexistuje komerční nástroj, který by v projektových

datech prováděl automatickou detekci špatných praktik nebo anti-vzorů nezávisle na použitém ALM nástroji. Tento problém je předmětem projektu

Katedry informatiky a výpočetní techniky (KIV) Fakulty aplikovaných věd

(FAV) Západočeské univerzity v Plzni (ZČU), kde je vyvíjen framework

Software Anti-pattern Detector (SPADe).

Hlavní funkčností frameworku SPADe je těžba dat ze softwarových projektů uložených v různých ALM nástrojích a jejich transformace do unifikované struktury v datovém skladu. Nad naplněným datovým skladem je

následně umožněno provádět datové analýzy zjišťující přítomnost událostí,

vzorců chování, konceptů a metod. Zvláštní pozornost je věnována zejména

přítomnosti špatných praktik a anti-vzorů.

!clipboard-202303181252-ieyt2.png!

[obr. 1]

h2. Cíle

Cílem je rozšířit framework SPADe, konkrétně: detektor, webové rozhraní a databázi, o několik dalších aplikací, přičemž každá by měla na starost konkrétní věc. Konkrétně detektor a webová aplikace jsou v současné době spojeni do jedné aplikace (monolit), který vznikl v rychlosti pod vedením Ondřeje V. My tento monolit chceme rozdělit do MVC architektury, tzn. využít Java Spring Boot jako RestAPI a ReactJS na vývoj samotné webové aplikace, která by s Javou komunikovali pomocí RestAPI.

Nadále aplikace nemá žádnou autentizaci. Cílem je připravit takovou (nejspíše) službu, která bude mít abstraktní rozhraní (mj. bridge), který by sloužil jako připojení pro jiné autentizační služby. Zatím by autentizační služba byla vcelku primitivní a fungovala by s daným rozhraním. Komplexnější framework typu Keycloak, google OAuth apod. by se řešilo na úrovni diplomové práci mimo ASWI/TSP.+.

Při migraci detektoru pouze na RestAPI je cílem i zavést tkz. kontraktové testy. Jsou to jednotkové testy využívající několik knihoven přímo od springu, které vytvářejí stuby z daných předpisů (swagger) a poté se spouštějí s cílem otestovat, zda neproběhla žádná změna v žádném z kontrolerů, která by ovlivnila výstup endpointu(ů).

V průběhu implementace by byla vize i taková, že bychom zkusili změnit databázi z MySQL na MS SQL Server, a to kvůli mnoha výhodám, které má oproti MySQL. Nicméně je nutné vůbec zjistit, zda s touto DB bude jednoduchý nasazení potom v CI/CD apod.

h1. Specifikace požadavků

# Změna současné architektury na MVC

# Přidání správy uživatelů 

# Zavedení kotraktového testování

# Přidání možnosti jednoduchého nasazení produktu

# Kompletní a ucelená dokumentace produktu (malá priorita)

h1. Hrubý plán projektu

h2. Iterace

*Iterace vycházejí z pravidel definovaných v [[Interní_konvence]]*

*Viz [Roadmap]*

h1. Stakeholders

 * Petr Pícha (zákazník)

 * Petr Urban, Petr Štěpánek, Jiří Trefil a Václav Hrabík (vývojářský tým)

 * Adam Šmucr (bakalářská práce)

 * manažeři, výzkumníci v SW vývoji, sami vývojáři (potencionální uživatelé)

h1. Seznam rizik

h2. Technická rizika

 * Neznalost původní architektury

 * Neznalost používaných frameworků

h3. Řešení technických riziky

 * Řádné zaškolení a prostudování architektury

 * Řádné zaškolení a prostudování manuálů a vyzkoušení si principů na testovém projektu

h2. Časová rizika

 * Velká vytíženost vývojářského týmu v ostatních předmětech

 * Nemoci, lékařské zákroky

 * Velikonoce

h3. Řešení časových rizik

 * Pracovat postupně, průběžně a časově efektivně

 * Ihned po zjištění události oznámit týmu, aby se na to mohlo ihned reagovat

 * neslavit velikonoce :D