Pöördumine

Lisa 1

Tehniline kirjeldus

1. Mõisted ja lühendid

Mõiste / Lühend Kirjeldus

ADRArhitektuuriline otsus (Architecture Decision Record)

AQOracle Advanced Queuing — Oracle andmebaasi sisseehitatud sõnumijärjekorra mehhanism

Big Bang migratsioonSuur ühekordne migratsioon, kus kogu süsteem viiakse ühe katkestusakna jooksul vanalt platvormilt uuele (vastandina inkrementaalsele teenusepõhisele migratsioonile)

BLOB / CLOBBinary / Character Large Object — binaar- või tekstifaili sisu salvestamine andmebaasi

CutoverTootmiskeskkonna ümberlülitus vanalt süsteemilt (Oracle) uuele (PostgreSQL)

DoDValmisoleku kriteeriumid (ingl k Definition of Done) — Tellija ja Täitja vahel kokku lepitud tingimuste kogum, mille täitmisel loetakse töö edukalt lõpetatuks ja vastuvõetuks

Dual-databaseÜleminekuperioodi muster, kus rakendus toimib paralleelselt nii Oracle kui PostgreSQL andmebaasi vastu, võimaldades tagasipööramist

EBSMajandustarkvara Oracle E-Business Suite

Edasimineku või peatamise otsus

Ingl k Go/No-Go decision — projekti vaheetapi lõpus tehtav otsus, kas projekt on järgmise etapi käivitamiseks valmis (edasi minna) või vajab parandusi enne edasiliikumist (peatada)

GAP-analüüsLahknevusanalüüs, olemasoleva SKA infosüsteemi analüüs vastu arhitektuuri tulevikuvisiooni (TO-BE), et selgitada välja ja prioriseerida lahknevuste (GAP) likvideerimiseks vajalikud tööd

JPAJava Persistence API — Java rakenduskihi standard relatsiooniandmebaasi kasutamiseks

Liquibase changesetLiquibase'i terminoloogias üks andmebaasi muudatuste atomic komplekt, mis on versioonihalduses ja teostatav korrastatud järjestuses

POCKontseptsiooni tõestus (Proof of Concept)

PostgreSQLVabavaraline relatsiooniandmebaasi mootor — käesoleva lepingu sihtplatvorm

SKASotsiaalkindlustusamet

SKAIS1Sotsiaalkaitse infosüsteem (vananenud platvormil)

SKAIS2Sotsiaalkaitse infosüsteem uus rakendus (hõlmab Ametnikurakendust ja Iseteenindust)

2. Ülevaade

Sotsiaalkindlustusamet (SKA) kasutab ülesannete täitmiseks sotsiaalkaitse infosüsteemi, mis koosneb SKAIS1,

EBS ja SKAIS2 rakendustest. Tegemist on infosüsteemiga, mida on arendatud hulk aastaid nii, et uute

funktsionaalsuste loomise kõrval ei ole jätkunud ressurssi tehnoloogilise ajakohasuse tagamiseks. Süsteemis

tekkinud oluliste kitsaskohtade leevendamiseks käivitati 2025. aastal SKA infosüsteemi arhitektuuri

tulevikuvisiooni (TO-BE lahenduse) väljatöötamise projekt, mille käigus loodi arhitektuuri reeglistik, millele

peavad vastama teostatavad arendused ning migreerimisplaan. Ühtlasi kaardistati probleemid ja eesmärgid,

teostati GAP-analüüs, st analüüsiti olemasolevat lahendust vastu TO-BE arhitektuuri, et selgitada välja ja

prioriseerida GAP likvideerimiseks vajalikud tööd. Lisaks oli juba varasemast teada kitsaskohti (nt seotud

andmebaasidega), mis vajavad lahendamist.

Antud leping koondab SKAIS2 andmebaasidega seotud arhitektuuriliste tööde eeltööd, et tagada tuleviku

kindlus ja toimepidamine. Selle lepingu tööde tulem võimaldab edasi minna laiapindsemate

migratsioonitöödega. Antud lepingu skoobis on andmebaasi arhitektuuri kirjeldus (ADR-ide kujul) ning esimese

kolme teenusega POC, mis valideerib eelanalüüsis pakutud lähenemist praktikas ja kalibreerib edasiste

etappide töömahuhinnangud.

2.1. GAP 1.9. Andmebaasi arhitektuur

Täna on SKAIS-is ajaloolistel põhjustel kasutatud andmebaasi arhitektuuri andmete kirjeldamiseks mitmeid

erinevaid viise. Samuti on SKAIS-i paljudel teenustel kasutusel monoliitne andmebaas, mis seab keerukust igale

uuele ning muudetavale ärifunktsioonile. GAP 1.9 töö eesmärgiks on kaardistada mõistlikud viisid, kuidas

kirjeldada ärilisi ja tehnilisi andmeid. Kuidas rakendada mikroteenuste arhitektuuri toetavat andmebaasi ning

kuidas liikuda vabavaralise andmebaasi PostgreSQL poole.

1. Eelnevalt on koostatud SKAIS Oracle → PostgreSQL migratsiooni eelanalüüs (vt lisainfo allpool), mis

annab tervikpildi migratsiooni ulatusest, peamistest riskidest, lahtistest arhitektuuriotsustest ja

soovituslikust etapilisest tegevuskavast. Eelanalüüsi peamised järeldused:

2. Migratsioon Oracle → PostgreSQL on teostatav, kuid eeldab etapilist teenusepõhist lähenemist; ühtset

suurt migratsiooniaega (big bang) ei ole võimalik korraldada.

3. Käesoleva lepingu skoop kattub eelanalüüsis kirjeldatud Etapp 1-ga ja hõlmab paralleelselt nii

programmiüleste arhitektuursete lähteotsuste kinnitamist (ADR-ide vormis) kui ka kõrge riskiga

teemade praktilist valideerimist POC-idega. Eelanalüüsi Etapid 2–4 (teenusepõhine detailanalüüs,

lainete migreerimine ja monoliidi migratsiooniotsus) tellitakse eraldi lepingutega GAP 3.5 ja sellele

järgnevate tööde teostamise raames.

4. Eelanalüüs identifitseerib vähemalt 13 lahtist programmiülest arhitektuuriotsust (eelanalüüsi peatükk

4.1), mis tuleb enne suuremate migratsioonitööde alustamist lukustada.

5. Kõrgeima riskiga tehnilised teemad on Oracle AQ asendamine, skeemiülesed sõltuvused, BLOB-

failihoidla migreerimine, auditlogi mehhanism ning identiteedikonteksti realiseerimine PostgreSQL-is.

6. Käesoleva lepinguga lukustatakse need lähteotsused ADR-idena ja valideeritakse nende rakendatavust

kolme teenuse POC-iga, et anda otsustamiseks kindel alus järgmise faasi (lainete migratsioon)

tellimiseks.

Käesoleva lepingu skoobist on väljas SKAIS2 monoliidi (`skais2`) andmebaasi migratsioon, süsteemiülene

Oracle → PostgreSQL cutover, ajalooliste andmete massmigratsioon ja Oracle-i tootmissüsteemi

dekommissioneerimine ning EBS ja SKAIS1 andmebaaside migratsioon. Need on GAP 3.5 (Andmebaasi

migratsioon) skoop ning tellitakse eraldi lepinguga käesoleva lepingu väljundite alusel.

2.2. Sõltuvus paralleelsete GAP-töödega

GAP 1.9 on eeltingimuseks GAP 3.5 (Andmebaasi migratsioon) tööde sisukokkuleppele — SKAIS Arhitektuur

TO-BE GAP-maatriksis on GAP 3.5 sõnastatud nii, et selle töö skoop ja maht sõltuvad GAP 1.9 tulemitest.

Käesoleva lepingu väljundid (kinnitatud ADR-id, POC-tulemid ja tagastusringi edasimineku või peatamise otsus

on GAP 3.5 detailse migratsiooniplaani ja teenuste lainete kava koostamise sisendiks.

 SKAIS Oracle → PostgreSQL migratsiooni eelanalüüs on leitav:

o https://wiki.sm.ee/spaces/SKAIS2/pages/441766028/SKAIS+Oracle+- +PostgreSQL+migratsiooni+eelanal%C3%BC%C3%BCs

 Seotud GAP-projektid SKAIS Arhitektuur TO-BE lehel:

o 3.5 Andmebaasi migratsioon (sõltub GAP 1.9 tulemitest)

o 3.9 Andmebaasi schema sõltuvuste kaotamine

o 3.10 Andmebaasi versioneerimine

o 3.6.1 Andmete krüpteerimine

3. Töö eesmärk

Töö eesmärgiks on luua SKAIS2 andmebaaside kasutamise põhimõtted ja neid toetavad arhitektuurilised

otsused (ADR-id). Lähtudes seejuures Oracle → PostgreSQL migratsiooni eelanalüüsi tulemist valideeritakse

loodud põhimõtteid kolme teenuse POC-i kaudu. Töö tulemina esitatakse järgmiste tööde (GAP 3.5) skoop ja

sellest tulenev mahuhinnang.

POC-teenuste PostgreSQL-versioonid loovutatakse Tellijale tootmiskvaliteediga lähtekoodina. Tellija (TEHIK

või Tellija valitud kolmanda osapoole partner) paigaldab need toodangusse omal valitud aja ja korra alusel.

4. Tellitavad tööd

Lepinguga tellitakse SKAIS2 andmebaaside ümberstruktureerimise põhimõtted ja nende valideerimine kolme

mikroteenusega vähemalt järgmises ulatuses:

 Eelanalüüsi (peatükk 4.1) lahtistele otsuskohtadele ADR-ide loomine — lepinguga lukustatakse vähemalt 13 programmiülest arhitektuuriotsust, sh näiteks:

o Oracle AQ ja scheduleri asendamine PostgreSQL-i alternatiividega;

o krüpteerimislähenemine ja võtmehalduse infrastruktuur;

o identiteedikonteksti tehniline teostus PostgreSQL-is;

o auditlogi arhitektuurivalik;

o dual-database perioodi mudel ja tagasipööramise strateegia;

o JPA päringustrateegia ja uute entiteetide primaarvõtme tüüp.

 Kolme SKAIS2 mikroteenuse — `notification`, `offering` ja `disability-application` — andmebaasi detailanalüüs ja POC migratsioon Oracle-ist PostgreSQL-i. Teenused on valitud Tellija ja arhitektuuripartnerite ühisarutelu tulemusena, lähtudes eelanalüüsi peatükis 5.2 toodud kandidaatidest ja riskide katvuse põhimõttest.

 Migratsioonilahenduse ja tagasipööramise strateegia tehniline analüüs ja teostus POC-teenuste tasemel, sh dual-database mustri valideerimine ja feature flag'idega juhitavad lugemise ja kirjutamise suunad.

 Taaskasutatav migratsioonitestimise ja andmemigratsiooni baasraamistik, mis on aluseks järgnevatele migratsioonilainetele.

 Testimisstrateegia ja valmisoleku kriteeriumid (DoD) iga POC-teenuse jaoks — sh vastutuste jaotus testimisel, nõutavate automaattestide minimaalne kogum ja kvaliteedikriteeriumid POC-teenuse vastuvõtuks.

 POC-tulemuste tagastusring koos töömahu kalibreerimisega ning edasimineku või peatamise otsus järgmise faasi (GAP 3.5) käivitamiseks.

 Muud arendusvajadused, mis selguvad analüüsi käigus ja on olulised realiseerida käesoleva lepingu skoobis.

 Tööde loetelu tekib eelnevalt kokkulepitud backlogi alusel ja hallatakse Jiras.

5. Tööprotsess ja tulemid

Järgnevalt täpsustatakse täitjaga sõlmitud lepingus 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 tehnilise kirjelduse punktis 4 (tellitavad tööd) 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.

 Kasutusjuhendid.

 Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus, kuid see peab vastama minimaalselt järgnevatele nõuetele: Nõuded arendusprojektide dokumentatsioonile SKAISi näitel - SKAIS2 - Sotsiaalministeeriumi wiki

5.3. Töökorraldus

Projekti töökorraldus toetub raamlepingu kodukorrale (lisa 5) ja töökorralduslikele kokkulepetele. Täitja peab

tagama piisava kaasamise ja ülevaadete andmise Tellijale.

5.4. Tööde üleandmine

Arendustööde lähtekoodi tarne toimub pideva integreerimise (continuous integration) teel. Tööde järjekord,

üleandmise aeg ja UAT tagasiside andmise aeg lepitakse kokku tööde käigus taasesitamist võimaldavas vormis

(tellija ja täitja poolt).

Töö üleandmisel kontrollib tellija üle töö nõuetekohasuse ning annab vajadusel tähtaja töö parandamiseks.

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.5. Nõuded automaattestimisele

Automaattestimise nõuete täitmisel tuleb lähtuda nõuetest, mis on leitavad siit: Automaattestide nõuded.

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

POC-teenuse PostgreSQL-versioon peab edukalt läbima ka olemasolevad süsteemiülesed regressiooni- ja

suitsutestid, tõendamaks, et andmebaasi vahetus ei ole rikkunud teenuse väliseid API-lepinguid.

5.6. 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 ja täitja poolt

kokku tööde käigus.

Nõudest eraldi tuleb vaadelda staatiliste failide allalaadimist – need tuleb http serveris puhverdada.

5.7. Mittefunktsionaalsed nõuded

Mittefunktsionaalsete nõuete täitmisel tuleb lähtuda järgnevast:

 Uue funktsionaalsuse loomisel tuleb lähtuda raamlepingu (nr 3-9/3443-1) ja selle lisades kirjeldatud nõuetest

 Täpsemad mittefunktsionaalsed nõuded, millest lähtuda on leitavad siit: Mittefunktsionaalsed nõuded

5.8. Tulemid

Valminud ja üleantavate tööde tulemid peavad sisaldama:

 Eelanalüüsi peatüki 4.1 otsustest lähtuvaid ADR-e;

 POC-ide käigus tuvastatud täiendavate otsustuskohtade kaardistust;

 Kolme POC-teenuse Liquibase changeseti ja PostgreSQL-versioonide tootmiskvaliteediga lähtekoodi (toimivad dual-database mustris);

 Taaskasutatavat migratsioonitestimise ja andmemigratsiooni baasraamistikku;

 Töömahu kalibratsioonidokumenti ja tagastusringi protokolli koos edasimineku või peatamise otsusega;

 Viiteid dokumentatsioonile Confluence’is;

 Viiteid tehtud töödele (Jira piletitena);

 Viiteid koodile GitLabis.

5.9. Tööde teostamise tähtaeg

Tööde üleandmise (so Jira piletid "Ready for AT" ja toodangu keskkonda paigaldatav kvaliteetne lähtekood) tähtaeg on 30.11.2026. Tööde üleandmisele järgneb tellija poolne tööde testimine mõistliku aja jooksul ja vajadusel täitja poolne paranduste või täienduste tegemine, kui tööd ei ole tähtajaks teostatud nõuetekohaselt või tellijal tekib vajadus väiksemamahuliste täienduste koheseks realiseerimiseks. Tööd loetakse teostatuks tööde üleandmise-vastuvõtmise akti tellija poolt allkirjastamise hetkest. Tellijal on õigus pikendada tööde üleandmise tähtaega, kui ilmneb tööde ajakavas täitjast sõltumatuid olulisi viivitusi.

Hankeleping nr ...

Tervise ja Heaolu Infosüsteemide Keskus (edaspidi tellija), registrikood 70009770, aadress Pärnu

mnt 132, 11317 Tallinn, keda esindab põhimääruse alusel direktor Margus Arm ja

Nortal AS (edaspidi täitja), registrikood 10391131, aadress Lõõtsa tn 6, 11415 Tallinn, keda esindab

volikirja alusel ärijuht Olga Golubeva,

edaspidi eraldi pool või koos pooled, sõlmisid raamlepingu nr 3-9/3443-1 alusel käesoleva

hankelepingu (edaspidi leping) alljärgnevas:

1. Lepingu ese

1.1. Lepingu esemeks on riigihanke „GAP 1.9 andmebaasi arhitektuur“ dokumentides olevas

tehnilises kirjelduses nimetatud tööd (edaspidi tööd).

1.2. Lepingu tööde maht onkuni 300 000 (kolmsada tuhat) eurot ilma käibemaksuta.

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

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

2.2. Töötunni põhise lepingu korral esitab täitja eelmise kuu töötundide ajaaruande, mis sisaldab

teostatud töötunde ja nende jooksul teostatud töid. Ajaaruanne esitatakse allkirjastatult

hiljemalt järgmise kalendrikuu 5. tööpäeval. Viimane ajaaruanne esitatakse koos aktiga.

2.3. Tellitavad tööd antakse vastuvõtutestimiseks üle vastavalt lepingu tehnilises kirjelduses

kokkulepitud tingimustele.

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

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. Lepingu täitmine toimub töötunnipõhisel arvestusel, tellija tasub üksnes lepingu alusel

tellitud ja teostatud töötundide eest.

3.2. Ühe töötunni maksumuseks lepingu täitmisel on ... ( ) eurot käibemaksuta.

3.1. Täitja esitab tellijale e-arve pärast töö üleandmise-vastuvõtmise akti allkirjastamist.

4. Poolte vahelised teated ja kontaktisikud

4.1. Teadete edastamisel ja kätte toimetamisel lähtutakse raamlepingu regulatsioonist.

4.2. Tellija kontaktisikuks lepingu täitmisel on Ott Mihailov, tel 5257813, e-post

[email protected] või tema asendaja.

4.3. Täitja kontaktisikuks lepingu täitmisel on Tormis Lilleväli, tel 56615767, e-post

[email protected] või tema asendaja.

5. Lõppsätted

5.1. Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni poolte poolt oma

lepinguliste kohustuste täitmiseni.

5.2. Lepingu dokumendid koosnevad riigihanke alusdokumentidest, sh lepingu lisadest, lepingu

muudatustest ja pakkumusest.

5.3. Lepingu lahutamatuteks osadeks lepingu sõlmimise hetkel on järgmised dokumendid, mida

ei allkirjastata koos lepinguga:

5.3.1. Lisa 1 - Tehniline kirjeldus;

5.3.2. Lisa 2 – Pakkumus (ei allkirjastata koos lepinguga)

6. Poolte allkirjad

Tellija: Täitja:

HANKIJA NIMI: Tervise ja Heaolu Infosüsteemide Keskus Pakkumusettepaneku nimetus: „GAP 1.9 andmebaasi arhitektuur“ Käesolevaga teeb Tervise ja Heaolu Infosüsteemide Keskus (Hankija) Teile ettepaneku esitada pakkumus „GAP 1.9 andmebaasi arhitektuur“ teostamiseks raamlepingu nr 3-9/3443-1 alusel.

Pakkumuse esitamise tähtaeg on 11.06.2026 kell 14:00. Pakkumus saata e-posti aadressile

[email protected].

Pakkumus tuleb esitada eesti keeles ja digitaalselt allkirjastatuna.

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

Alternatiivsete pakkumuste esitamine ei ole lubatav. Pakkumus peab olema jõus minimaalselt 30

päeva.

Pakkumusena tuleb esitada:

- Tööde teostamiseks planeeritud meeskonnaliikmed isikuliselt, tuues välja ka

meeskonnaliikmete roll;

- Tööde teostamise ühe töötunni hind (ilma käibemaksuta).

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 300 000 eurot (ilma km-ta). Pakkumuse esitamisega kinnitab pakkuja, et

lepingu tähtaja saabumiseks on teostatud Hankelepingu eseme tehnilises kirjelduse (lisas 1) punktis

4 kirjeldatud tööd. Pakkujal ei ole õigust tööde teostamiseks nõuda ajapikendust, 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. Hankelepingu eseme tehniline kirjeldus; Lisa 2. Hankelepingu projekt.