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 Mikroteenuse tehniline Töö tulemusena valmib Java back- komponent põhi ja andmebaas 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 Vajalike alussüsteemide kasutuselevõtt 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 Kasutajaliidese (UI) Töö tulemusena valmib komponent tehniline põhi 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 Ajajoone komponendi Töö tulemuseks on front-end komponent) loomine 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 Ajajoone integreerimine back-end back-end-iga teenusega 8 Juurdepääsetavuse Aadressirea (URL) parameetrite parameetrite lisamise abil juurdepääsetavuse võimaluse loomine parameetrite lisamise võimaluse loomine komponendile (reavahe, keel, kontrastsus): vastavalt seadistatud parameetritele ka kuvatakse ajajoon. 9 Oluliste teemade Oluliste teemade ('Sind Töö tulemusena luuakse komponent (FE ja võiksid huvitada komponent, mis kuvab vähemalt BE) järgmised teemad') kahte teemaplokki vastavalt komponendi loomine 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' Seotud artiklid' Töö käigus võetakse kasutusele komponent komponendiga liidestus 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 Kasutaja eelistuste Töö käigus võetakse kasutusele riigiportaali kasutamine riigiportaali riigiportaali eesti.ee keskkonna eesti.ee-ga eesti.ee põhjal 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 Töö käigus tehakse kasutuselevõtt ettevalmistused ja võetakse kasutusele veebianalüütika jälgimise tööriist Matomo. 13 Dokumentatsioon Infoteenuse arendamisel Tööde käigus tekkinud eriilmeline tekkiv ja kaasnev dokumentatsioon sh dokumentatsioon 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.