Pöördumine

Lisa 1 Tehniline kirjeldus

Lapse saamise sündmusteenuse MVP arendustööd

1. Mõisted ja lühendid

Mõiste/Lühend Kirjeldus

SKA Sotsiaalkindlustusamet

TEHIK Tervise ja Heaolu Infosüsteemide Keskus

SOM Sotsiaalministeerium

MVP Minimal viable product

2. Ülevaade

Lapse saamise sündmusteenuse näol on tegemist esimese sammuga, et kasutajatele

sündmusteenuse põhist lähenemist pakkuda. Oluliseks tegevuseks selle pakkumisel on teabe

ajakohasena hoidmine ning uuendamine vastavalt kasutajate tagasisidele. Sihtgrupiks on eelkõige

esmakordsed sünnitajad, kellel puudub varasem kogemus lapse saamise sündmusteenuse

tarbimisel, kuid seejuures ei tohiks unustada ka korduvsünnitajate vajadusi, kelle puhul üldine

protsess on varem läbi tehtud. Viimaste puhul on olulisemad aga detailsemad nüansid, näiteks

milliselt tuleks toimida kui lapsed sünnivad väikese vahega.

Infoteenuse eesmärgiks on anda kasutajale ülevaade erinevatest tegevustest ja kohustustest

lapseootusel ja pärast seda. Ajajoon visualiseerib kasutajale, milliseid tegevusi millises järjestuses

peaks tegema, millisel ajal tegema peab ning milliseid hüvitisi perioodis kasutada saab.

Eesmärgiks on võimaldada:

 kasutajal teada saada enda jaoks olulised tegevused (siestades lapse eeldatava sünnitähtaja);

 võimaldada kasutajal saada kiirelt ülevaade tegevustest raseduse jooksul;

 kasutajal näha, millised on olulised teemad, millega peaks praegusel hetkel tegelema ja et oskaks vastavalt planeerida enda tegevusi.

Kasutajale tekib laiem teadmine võimalustest, hüvedest ja kohustustest seoses lapse saamisega.

3. Lepingu eesmärk

Lepingu eesmärgiks on Lapse saamise sündmusteenuse MVP arendustööde teostamine.

4. Tellitavad tööd

Järgnevalt kirjeldatakse hankelepingu alusel teostatavad tööd. Nõuetekohased tööd tuleb üle anda

hiljemalt 15.12.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.

Punktis 4.1. 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. Lapse saamise sündmusteenuse MVP tööde kirjeldus

Lapse saamise sündmusteenuse MVP prototüüp on leitav siit.

Komponent Funktsionaalsus Kirjeldus

1 Back-end komponent

Mikroteenuse tehniline põhi ja andmebaas

Töö tulemusena valmib Java back- end teenus, mis pakub API liidest ajajoone komponendile. Teenus vahendab andmebaasist teenuse abitekstid ajajoone komponendile. Kõik ajajoone abitekstid sisestatakse otse süsteemi (peavad olema muudetavad liidese kaudu) .

2 Vajalike alussüsteemide kasutuselevõtt

Vajalike alussüsteemide kasutuselevõtt, et võimaldada koodi hoiustamist, ehitamist ning paigalduspakettide publitseerimist (nt Gitlab).

3 Logimine Vajalikud arendused logide transpordiks ning vaatamiseks logihaldus vahendis (nt Graylog).

4 Monitooring Vajalikud arendused rakenduse “tervise” jälgimiseks (nt Prometheus).

5 Front-end komponent

Kasutajaliidese (UI) tehniline põhi

Töö tulemusena valmib kasutajaliidese komponentide raam, kuhu paigutatakse ajajoone komponent. Adminliidese loomine Angulari1 veebiraamistikul, mis võimaldab peakasutaja(te)l lapse saamise sündmusteenuses olevaid abitekste hallata: lugeda, lisada, muuta ja kustutada. Abitekstide teema viidete ja/või abitekstide

1 https://angular.io/

siltide (label/tag) halduse loomine, mille abil on võimalik kokku viia abitekstid ajajoonel, 'seotud artiklid' ning huvitada võivad abistavad tekstid.

6 Ajajoon (FE komponent)

Ajajoone komponendi loomine

Töö tulemuseks on front-end komponent, mis suudab kuvada interaktiivset ajajoont vastavalt seadistatud andmestruktuuri põhjale. Uute kasutajaliidese elementide loomine sh ikoonid ja nende ühildamine olemasoleva disainiraamistikuga ning sobitamine teenuse kuvadel kasutamiseks, mh. erinevate seadmete tugi (nt. mobiilid, brauserid) ning kohaldamine eri sisuga andmete kuvamisel. Komponent luuakse sõltumatuks tema sisust, mis võimaldab seadistatava andmestruktuurina ette anda mida ajajoonel kuvatakse.

7 Front-end integreerimine back-end-iga

Ajajoone integreerimine back-end teenusega

8 Juurdepääsetavuse parameetrite lisamise võimaluse loomine

Aadressirea (URL) parameetrite abil juurdepääsetavuse parameetrite lisamise võimaluse loomine komponendile (reavahe, keel, kontrastsus): vastavalt seadistatud parameetritele ka kuvatakse ajajoon.

9 Oluliste teemade komponent (FE ja BE)

Oluliste teemade ('Sind võiksid huvitada järgmised teemad') komponendi loomine

Töö tulemusena luuakse komponent, mis kuvab vähemalt kahte teemaplokki vastavalt sellele, mida on kasutaja märkinud lapse sünnikuupäevaks ajateljel või valinud ajateljel. Töö käigus luuakse vajalikud back-end teenused, front-end komponendid ning pannakse komponendid vastavalt seadistusele tööle.

10 'Seotud artiklid' komponent

Seotud artiklid' komponendiga liidestus

Töö käigus võetakse kasutusele RIA poolt arendatud 'Seotud artiklid' komponent, mis kuvab seotud artiklite kuva/vaate vastavalt sellele, mida on kasutaja

märkinud lapse sünnikuupäevaks ajateljel või valinud ajateljel. Töö käigus lisatakse LST projekti NPM teek ning kuvatakse vastavat komponenti põhivaates ajajoone all.

11 Integratsioon riigiportaali eesti.ee-ga

Kasutaja eelistuste kasutamine riigiportaali eesti.ee põhjal

Töö käigus võetakse kasutusele riigiportaali eesti.ee keskkonna poolt jagatavad kasutaja eelistused, Töö tulemusena kuvatakse sündmusteenusesse liikumisel kasutajaliidest selles keeles, mida kasutaja valis riigiportaali eesti.ee keskkonnas ning samuti tema ligipääsetavuse eelistustega (nt kontrastne pilt, suurem reavahe).

12 Veebianalüütika kasutuselevõtt

Töö käigus tehakse ettevalmistused ja võetakse kasutusele veebianalüütika jälgimise tööriist Matomo.

13 Dokumentatsioon Infoteenuse arendamisel tekkiv ja kaasnev dokumentatsioon

Tööde käigus tekkinud eriilmeline dokumentatsioon sh kasutusjuhendid, protsesside kirjeldused, arhitektuuri, protsessi jms joonised (vt punkti 5.2)

5. Tööde teostamine

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 infoteenusega

tekkivat ja kaasnevat 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).

 Andmemudelid

 jms Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus. Nõuded

dokumentatsioonile kirjeldatud „Nõuded infosüsteemi dokumentatsioonile“2 juhendis, mis on leitav

TEHIKu kodulehel arendusjuhendite alt.

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, tarneprotsess, üleandmise aeg ja UAT tagasiside andmise aeg lepitakse kokku tööde

käigus taasesitamist võimaldavas vormis (Tellija ja Täitja poolt).

Tööd antakse üle kasutades TEHIKu Kubernetese3 platvormi ja Helm4 tööriista. Detailne protsess

vaadatakse Täitjaga enne tööde algust vajadusel üle.

Töö üleandmisel kontrollib Tellija üle töö nõuetekohasuse ning annab vajadusel tähtaja töö

parandamiseks.

5.4 Nõuded automaattestimisele5

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

2 https://www.tehik.ee/sites/default/files/2021-01/AV-3834696-280920-1325-44.pdf 3 https://kubernetes.io/ 4 https://helm.sh/ 5 https://www.tehik.ee/sites/default/files/2021-01/AV-72518077-280920-1256-30.pdf

5.5 Koormustestimised

Rakendus 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. Koormustestid peavad olema juhitavad

muutujatega ehk seadistatavad. 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.

o Täpsemad mittefunktsionaalsed nõuded, millest lähtuda, asuvad Confluence keskkonnas: Mittefunktsionaalsed nõuded arendustele

 RIA mittefunktsionaalsed nõuded – https://e-gov.github.io/MFN/

 Digiriigi ristfunktsionaalsed nõuded – https://koodivaramu.eesti.ee/e-gov/cfr

5.7 Tulemid

Lapse saamise sündmusteenuse MVP arendustööd vastavad skoobile ja nõuetele. Valminud tööde

tulemid antakse üle hiljemalt 15.12.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 tulemid ja tähtaeg

Lapse saamise sündmusteenuse MVP arendustööd antakse üle hiljemalt 15.12.2022 (so Jira piletid

"Ready for AT" ja toodangu keskkonda paigaldatav kvaliteetne lähtekood). Tööde üleandmisele

järgneb tellija poolne tööde vastuvõtmisaeg mõistliku aja jooksul.

Hankelepingu Projekt

Hankeleping nr 3-9/.....

Lapse saamise sündmusteenuse MVP arendustööd

Tervise ja Heaolu Infosüsteemide Keskus, registrikood 70009770, aadress Pärnu mnt 132,

Tallinn, keda esindab põhimääruse alusel direktor Margus Arm (edaspidi tellija), ja

AS Helmes, registrikood 10364097, aadress Lõõtsa tn 6, Tallinn 11415, keda esindab volikirja

alusel Eliis Väert (edaspidi täitja),

edaspidi eraldi pool või koos pooled, sõlmisid raamlepingu nr 3-9/2307-1 alusel käesoleva hankelepingu (edaspidi leping) alljärgnevas:

1. Lepingu ese

1.1. Lepingu esemeks on lisas 1 (tehniline kirjeldus) punktis 4 nimetatud tööd koos

garantiiteenustega (edaspidi tööd).

1.2. Lepingu tööde maht on kuni 2000 töötundi.

1.3. Vajadusel on tellijal õigus tellida lepingu esemega seotud täiendavaid töid kuni

20% ulatuses kokkulepitud mahust, eeldusel, et hankelepingu üldist olemust ei

muudeta.

1.4. Täiendavate tööde tellimine ja sellega kaasnevad muudatused lepingu täitmisel

lepitakse poolte vahel kokku vähemalt kirjalikku taasesitamist võimaldavas

digitaalselt allkirjastatud vormis.

2. Tööde üleandmise ja vastuvõtmise tingimused

2.1. Täitja annab töö üle hiljemalt 15.12.2022.

2.2. Tellitavad tööd antakse vastuvõtutestimiseks üle vastavalt lepingu lisas 1

kokkulepitud tingimustele.

2.3. Tellija vaatab töö üle vastavalt raamlepingu tingimustele.

2.4. Töö antakse üle üleandmise ja vastuvõtmise aktiga (edaspidi ka akt).

2.5. Koos üle antava tööga annab täitja tellijale üle kõik tööde intellektuaalse omandi

õigused vastavalt raamlepingus kirjeldatule.

3. Lepingu hind

3.1. Kui lepingu maksumus ei ole kokku lepitud fikseeritud summana ja tööde teostamine

toimub töötunnipõhisel arvestusel, tasub tellija üksnes lepingu alusel tellitud ja

teostatud töötundide eest. Täitja esitab iga kalendrikuu lõpus allkirjastatud

ajaaruande järgmise kalendrikuu 5. tööpäevaks, millelt kajastuvad teostatud

töötunnid ja nende jooksul teostatud tööd. Viimane ajaaruanne esitatakse koos

aktiga.

3.2. Ühe töötunni maksumuseks tööde teostamisel on ... (summa sõnadega) eurot

ilma käibemaksuta.

3.3. Arve esitatakse e-arvena, pärast akti tellija poolt allkirjastamist.

3.4. Täitja annab tellijale arve tasumiseks tähtaja minimaalselt 21 kalendripäeva alates

arve laekumisest. Arvel tuleb märkida raamlepingu ja hankelepingu number,

riigihanke viitenumber ja tellija kontaktisiku nimi.

4. Poolte vahelised teated ja kontaktisikud

4.1. Teadete edastamine toimub üldjuhul telefoni, e-posti, või posti teel. Juhul, kui teate

edastamisel on olulised õiguslikud tagajärjed, peavad teisele poolele edastatavad

teated olema edastatud taas-esitamist võimaldavas vormis (s.o kirjalikus vormis või

e-posti teel). Informatiivset teadet võib edastada ka telefoni teel.

4.2. Teate edastamise hetkeks loetakse elektronkirja tehniliselt tõendatud saatmise hetk

või kirjaliku teate allkirjaga tõendatud vastuvõtmise hetk.

4.3. Tellija kontaktisikuks lepingu täitmisel on: Gerli Raadik, sotsiaalkaitse talituse

projektijuht, telefon +372 5129 310, e-post: [email protected].

4.4. Tellija kontaktisikuks lepingu täitmisel on: Monika Heinrand, sotsiaalkaitse talituse

juhataja, telefon +372 5114 240, e-post: [email protected].

4.5. Täitja kontaktisikuks lepingu täitmisel on: Aleksandr Knjazetski, projektijuht, telefon

+372 58 553 059, e-post: [email protected].

4.6. Täitja kontaktisikuks lepingu täitmisel on: Eliis Väert, projektijuht, telefon +372 5021

150 , e-post: [email protected].

5. Lepingu kehtivus

5.1. Leping jõustub sellele poolte poolt allakirjutamisest ja kehtib kuni poolte poolt oma lepinguliste kohustuste täitmiseni.

5.2. Tellijal on õigus leping igal ajal üles öelda, teatades sellest 60 kalendripäeva ette.

6. Lõppsätted

6.1. Lepingu täitmisel tekkinud vaidlused ja lahkarvamused lahendavad pooled läbirääkimiste teel. Kokkuleppe mittesaavutamisel lahendatakse vaidlused Harju Maakohtus.

6.2. Lepingu täitmisel ja lepingust tulenevate vaidluste lahendamisel lähtutakse Eesti Vabariigi õigusaktidest.

6.3. Pooled ei tohi lepingust tulenevaid õigusi ja kohustusi üle anda kolmandatele isikutele ilma teise poole kirjaliku nõusolekuta.

6.4. Lepingu dokumendid koosnevad käesolevast lepingust, lepingu lisadest ning lepingu muudatustest, milles pooled võivad kokku leppida lepingu allakirjutamise järgselt.

6.5. Lepingu lahutamatuteks osadeks lepingu sõlmimise hetkel on järgmised dokumendid:

6.5.1. Lisa 1 - Hankelepingu eseme tehniline kirjeldus;

6.5.2. Lisa 2 - Täitja poolt esitatud pakkumus hankelepingu sõlmimiseks.

7. Poolte allkirjad

Tellija Täitja

/allkirjastatud digitaalselt/ /allkirjastatud digitaalselt/

HANKIJA NIMI: Tervise ja Heaolu Infosüsteemide Keskus Pakkumusettepaneku nimetus: „Lapse saamise sündmusteenuse MVP arendustööd“ Käesolevaga teeb Tervise ja Heaolu Infosüsteemide Keskus (Hankija) Teile ettepaneku esitada pakkumus Lapse saamise sündmusteenuse MVP arendustööde teostamiseks raamlepingu nr 3-9/2307-1 alusel.

Pakkumus tuleb esitada hiljemalt 02.09.2022 kell 11:00 e-posti aadressile

[email protected]. Pakkumus tuleb esitada eesti keeles ja digitaalselt allkirjastatult

pakkuja allkirjaõigusliku isiku poolt.

Pakkumus esitatakse tehnilises kirjelduses (lisa 1) toodud tööde teostamiseks.

Alternatiivsete pakkumuste esitamine ei ole lubatav.

Pakkumusena tuleb esitada:

- Tööde teostamiseks planeeritud meeskonnaliikmed isikuliselt, tuues välja ka meeskonnaliikmete rollid (vajadusel võib tellimuse käigus Poolte kokkuleppel meeskonnaliikmeid lisada). Meeskonnaliikmete lisandumisel tuleb esitada nende kohta ka andmed riigihankes teatavaks tehtud vormil, mille alusel hankija andmeid kontrollib;

- Tööde teostamise ühe töötunni hind (ilma käibemaksuta). Alltöövõtjate kasutamisel tuleb pakkumuses vastav info välja tuua.

Töid teostatakse jooksva tunnihinna arvestuse põhiselt. Tööde ajaaruandes tuuakse välja

tööde teostamiseks kulunud töötunnid isikute lõikes, seostades nimetatud isikud Jiras logitud

tööülesannete ja kirjeldatud tegevustega.

Töid tellitakse mahus kuni 2000 töötundi. Pakkumuse esitamisega kinnitab pakkuja, et

lepingu tähtaja saabumiseks on teostatud tehnilises kirjelduse (lisas 1) punktis 4 toodud

tööd. Pakkujal ei ole õigust tööde teostamiseks nõuda täiendavat tasu või väljamakseid.

Küsimuste tekkimise korral palun võtke ühendust enne pakkumuse esitamise tähtaega aadressil [email protected]. Pakkumusettepanekuga koos edastatavad dokumendid:

Lisa 1. Tehniline kirjeldus; Lisa 2. Hankelepingu projekt.