SKAIS2 kliendisuhtluse ja info kättesaadavuse I etapi arendustööd
1. Mõisted ja lühendid
Mõiste/Lühend
Kirjeldus
SKA
Sotsiaalkindlustusamet
TEHIK
Tervise ja Heaolu Infosüsteemide Keskus
SKAIS2
Sotsiaalkaitse infosüsteem (hõlmab ametnikurakendust ja iseteenindust)
SKA iseteenindus
Sotsiaalkindlustusameti iseteenindus
2. Ülevaade
SKA kasutab ülesannete täitmiseks sotsiaalkaitse infosüsteemi, mis koosneb SKAIS1, EBS, AVE ja SKAIS2 rakendustest. SKAIS2s on kasutusel elatisabiteenus, puude raskusastme tuvastamine, sotsiaaltoetuse teenus, peretoetused ja abivahendite teenus. Sotsiaalkindlustusameti teenuste kasutajate jaoks on arendatud Sotsiaalkindlustusameti iseteenindus, kus kasutaja saab enda jaoks vajalikke toiminguid teha lihtsalt ja kiirelt. Iseteeninduses kuvatakse praegu isikuandmetega seotud infot, isikule maksete teostamise infot, perehüvitiste teenuseid ja abivahendite teenust.
SKA kliendil on iseteeninduse kaudu võimalik saada operatiivselt infot talle võimaldatud teenustest, pakutavatest teenustest (proaktiivsete teenuste info), vajadusel esitada oma pöördumisi, jälgida teenuste menetlusprotsessi, saada teated ja teavitusi teenuste/toetuste saamise või lõppemiste kohta. Hetkel puudub kasutajatel iseteeninduses ülevaade dokumentidest ja teabest, mida SKA tema kohta omab.
3. Hankelepingu eesmärk
Käesoleva hankelepingu eesmärgiks on:
3.1. Olemasoleva "notification" mooduli refaktoreerimine ning uue kliendipöördumiste mooduli loomine.
3.2. SKAIS2 LIVE AR/iseteeninduses "Suhtlus ja teavitused" päringute optimeerimine.
4. Tellitavad tööd
Järgnevalt kirjeldatakse hankelepingu alusel teostatavad tööd. Nõuetekohased tööd tuleb üle anda hiljemalt 14.02.2022.
Juhul, kui töö käigus selgub täiendavaid ärinõudeid või detaile, mille realiseerimine on küll vajalik, kuid ei mahu punktis 4 kirjeldatud skoopi, tehakse ühine taasesitamist võimaldavas vormis otsus (Tellija ja Täitja poolt) vastavalt töö mahule ja/või kriitilisuse astmele, kas täiendavat tööd teostatakse käesoleva või uue lepingu raames.
Juhul, kui töö käigus selgub, et mõistlik on punktis 4 kirjeldatud skoobist midagi välja jätta, teeb selle otsuse taasesitamist võimaldavas vormis Tellija. Hankelepingu mahu muutumine, st täiendavate tööde tellimine või skoobis kirjeldatud tööde teostamata jätmine, lepitakse Poolte vahel kokku hankelepingu lisana.
Punktides 4.1.-4.3. on välja toodud loetelu teostatavatest põhitöödest, mis täitjal tuleb teostada. Antud loetelule lisaks kohustub täitja teostama ka muud tööd, mis on vajalikud teenuse nõuetekohaseks toimimiseks.
4.1. Olemasoleva "notification" mooduli refaktoreerimine ning uue kliendipöördumiste mooduli loomine, sh:
• Uue KP eraldiseisva teenuse (mooduli) loomine;
• "Notification" teenusest front-end üleviimine uude KP moodulisse;
• "Notification" teenusest back-end koodi üleviimine uude KP teenusesse;
• FF funktsionaalsus;
• Queue "notification" mooduli jaoks;
• Scheduler (cron);
• Andmebaasi tabelid. Schema.;
• Olemasolevate teavituste migratsioon Kliendipöördumiste schemasse;
• Olemasoleva "Notification" teenuse koodi puhastamine;
• Liideste ümber seadistamine Notification -> Kliendipöördumine.
4.2. SKAIS2 LIVE AR/iseteeninduses "Suhtlus ja teavitused" päringute optimeerimine.
4.3. Migratsioon
Migreeritavate andmete ulatus ja kirjete arv lepitakse Tellijaga kokku arenduse detailanalüüsi käigus.
4.3.1 Migratsiooni skoobi kirjeldus
• Olemasolevate teavituste migratsioon Kliendipöördumiste schemasse.
5. Tööprotsess ja tulemid
Järgnevalt täpsustatakse Täitjaga sõlmitud raamlepingus (nr 3-9/2307-1) kirjeldatud tingimusi tööprotsessi, dokumenteerimise, töökorralduse, testimise ja mittefunktsionaalsete nõuete osas.
5.1. Tööprotsess
• Tööraamistik peab tuginema etapiviisilisele planeerimisele, võimaldades arendusmeeskonna prioriteete jooksvalt muuta;
• Tööraamistik peab võimaldama süsteemset ülevaadet iga kokkulepitud töö saavutustest;
• Tööraamistik peab võimaldama arendusmeeskonna tulemuslikkuse (kasvu) jälgimist ajas;
• Tööraamistik peab tagama, et arendusmeeskond tegeleb omal initsiatiivil enda tulemuslikkuse parandamisega ja parendusettepanekute esitamisega.
• Täpsem protsess lepitakse kokku tööde käigus.
5.2. Dokumentatsioon
Vastavalt alapunktis 4 kirjeldatud skoobile tuleb töö käigus luua ja täiendada SKAIS2 dokumentatsiooni, milleks on minimaalselt:
• Funktsionaalsuse ja äriprotsesside kirjeldused kokkulepitud kujul (nt BPMN standard, diagrammid ja kirjeldused Confluence’is) koos ärireeglitega, mida peab olema hiljem võimalik täiendada järgnevates etappides lisanduva funktsionaalsuse alusel ning siduda tervikliku protsessi- ja ärireeglite kirjeldusega.
• Tehniline dokumentatsioon (nt paigaldusjuhendid, Confluence keskkonnas).
• Andmemudel.
Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus.
5.3. Töökorraldus
Projekti töökorraldus toetub kodukorrale. Täitja peab tagama piisava kaasamise ja ülevaadete andmise Tellijale.
5.3.1 Tööde üleandmine
Arendustööde lähtekoodi tarne toimub pideva integreerimise (continuous integration) teel.
Tööde järjekord ja UAT tagasiside andmise aeg lepitakse kokku tööde käigus taasesitamist võimaldavas vormis (Tellija ja Täitja poolt).
Tööd annab Täitja üle jooksvalt, vastavalt nende valmimisele – Tellija kontrollib seejärel töö nõuetekohasust ning annab vajadusel tähtaja töö parandamiseks. Töö loetakse vastuvõetuks vastavalt raamlepingu tingimustele.
Täitja teab, et tellija võib igat üle antud funktsionaalsust paigaldada toodangusse ning täitja peab tagama, et lõplikult valmimata funktsiooni protsessid on võimalik toodangust välja lülitada (feature flags). Funktsioonide sisse-välja lülitamise võimekus lepitakse Tellija ja Täitja vahel kokku tööde käigus.
5.4. Nõuded automaattestimisele
Loodav lähtekood peab olema kaetud 80% ulatuses ühiktestidega, 50% ulatuses integratsiooni/süsteemi/”end-to-end” automatiseeritud testidega. Testidega kaetakse serveripoolne ja kasutajaliidese kood. Kaetavuse kontrolliks ja raporteerimiseks seatakse Tellija koodihoidla keskkonnas (Gitlab) üles pideva integratsiooni töövoog, mis seadistatakse koostoimima SonarQube koodi ja testide kaetavuse analüsaatoriga.
Automaattestid peavad üle antavas lähtekoodis continuous-integration’i töövoo edukalt läbima. Samuti peab Täitja peab hoolt kandma, et varasemalt loodud testid jäävad töö lõpetamisel edukalt
läbitavaks. Nõuete muutumisel peab Täitja viima testid vastavusse uute nõuetega või neid eemaldama, kui selliseid nõudeid enam ei eksisteeri.
Kasutajaliidese testimise osakaal kogu testimise mahust peab olema mõistlik (mitte ületades 30%), rakendades seda kriitilisele funktsionaalsusele (lepitakse tööde käigus kokku). 50% kasutajaliidese testimisest peab olema automatiseeritud ja korduvkasutatav tööde käigus kokkulepitud raamistikul (nt Selenium).
5.5. Koormustestimised
• Iseteenindus peab toetama paralleelset minimaalselt 200 päringut (siinkohal on oodatav arendajapoolne hinnang, kas see on piisav päringute maht, vajadusel tõsta arvu).
• API teenustele ning keskmine päringu teenindamise aeg ei tohi olla suurem kui 2 sekundit.
Nõude täitmise kontrolliks tuleb luua koormustestid. Koormustestide tegemine lepitakse Tellija Täitja poolt kokku tööde käigus.
Nõudest eraldi tuleb vaadelda staatiliste failide allalaadimist – need tuleb http serveris puhverdada.
5.6. Mittefunktsionaalsed nõuded
Mittefunktsionaalsete nõuete täitmisel tuleb lähtuda järgnevast:
• Uue funktsionaalsuse loomisel tuleb lähtuda raamlepingus (nr 3-9/2307-1) ja selle lisades kirjeldatud nõuetest.
◦ Täpsemad mittefunktsionaalsed nõuded, millest lähtuda, asuvad Confluence keskkonnas: Mittefunktsionaalsed nõuded arendustele
5.6.1 Nõuded kiirusele ja latentsusele
Allpool kirjeldatud nõuded kehtivad ainult SKAIS2 sisemisele rakendusele ehk väliste süsteemide vasteaegasid ei loeta ajalise nõude sisse.
• Tühja veebivormi avanemine ei tohi kesta üle 2s.
• Andmetega veebivormi avanemine ei tohi kesta üle 4s.
• Menetluse jaoks andmete otsimine ei tohi kesta üle 5s.
• Menetluse andmete salvestamine ei tohi kesta üle 4s.
• Menetluse jaoks andmete värskendamine ei tohi kesta üle 4s.
• Üle interneti infosüsteemi kasutamisel võib lisanduda 2s viivitus.
Teenuse kvaliteedi tõstmiseks on poolel õigus teha teisele poolele ettepanekuid kiiruse ja latentsuse nõuete muutmiseks. Muudatuste korral kirjeldatakse kasutuslugude vastuvõtukriteeriumidesse mittefunktsionaalse nõudena.
5.7. Tulemid
Toimivad kliendisuhtluse ja info kättesaadavuse teenused vastavad skoobile ja nõuetele. Valminud tööde tulemid antakse üle hiljemalt 14.02.2022 üleandmise-vastuvõtmise aktiga, tööde tulemid peavad sisaldama:
• Viiteid dokumentatsioonile Confluence’is;
• Tööde üleandmise-vastuvõtmise akti, mis peab sisaldama tehtud tööde loendit Jira väljavõttena;
• Viiteid koodile GitLabis;
• Koodianalüüsi, mis sisaldab väljavõtet TEHIKu SonarQube keskkonnast, kust on näha testide kaetavuse protsent.
6. Tööde teostamise tähtaeg
Kõikide eelnevalt kirjeldatud tööde üleandmise (so Jira piletid "Ready for AT" ja toodangu keskkonda paigaldatav kvaliteetne lähtekood) lõpptähtaeg on 14.02.2022. Tööde üleandmisele järgneb Tellija poolne Tööde testimine mõistliku aja jooksul ja vajadusel Täitja poolne paranduste tegemine üle antud Töödes, kui testimise käigus ilmneb, et Tööd ei ole lõpptähtajaks teostatud nõuetekohaselt.