Hankelepingu projekt
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
_____ (edaspidi täitja), registrikood_______., aadress ________, keda esindab põhikirja alusel _____,
edaspidi eraldi pool või koos pooled, sõlmisid raamlepingu nr 3-9/4283-1 alusel käesoleva
hankelepingu (edaspidi leping) alljärgnevas:
1. Lepingu ese
1.1. Lepingu esemeks on „SKAIS2 üleviimine REST-põhistele rahvastikuregistri x-tee
teenustele ja kaasnevad parendused SKAIS2 infosüsteemis“ Tehnilises kirjelduses
nimetatud tööd (edaspidi tööd).
1.2. Lepingu tööde maht on kuni 1 200 000 (üks miljon kakssada tuhat) eurot ilma käibemaksuta.
2. Töö üleandmise ja vastuvõtmise tingimused
2.1. Täitja annab töö üle vastavuses lepingu lisas 1 kirjeldatud projekti vaheetappide ajakavale,
lepingu lõpptähtaeg on 31.12.2027.
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 lisas 1 „Tehniline
kirjeldus“ 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 ____ (maksumus sõnadega) eurot
käibemaksuta.
3.3. Arve esitatakse e-arvena, pärast akti tellija poolt allkirjastamist.
3.4. Täitja esitab tellijale e-arve pärast töö üleandmise-vastuvõtmise akti allkirjastamist. Arvel
tuleb märkida raamlepingu ja hankelepingu number, lepingu osa viitenumber, riigihanke
viitenumber ja tellija kontaktisiku nimi.
3. Poolte vahelised teated ja kontaktisikud
3.1. Teadete edastamisel ja kätte toimetamisel lähtutakse raamlepingu regulatsioonist.
3.2. Tellija kontaktisikuks lepingu täitmisel on Maiu Nagel, projektijuht, tel +372 5090 782, e-post
[email protected] või Epp Laanepõld, Heaolu valdkonnajuht, telefon +372 512 9729, e-
post:
[email protected]
3.3. Täitja kontaktisikuks lepingu täitmisel on ________, tel ________, e-post ______.
4. Lõppsätted
4.1. Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni poolte poolt oma
lepinguliste kohustuste täitmiseni.
4.2. Lepingu dokumendid koosnevad riigihanke alusdokumentidest, sh lepingu lisadest, lepingu
muudatustest ja pakkumusest.
4.3. Lepingu lahutamatuteks osadeks lepingu sõlmimise hetkel on järgmised dokumendid, mida
ei allkirjastata koos lepinguga:
4.3.1. Lisa 1 - Tehniline kirjeldus;
4.3.2.Lisa 2 – Pakkumus;
4.3.3. Lisa 3 – Isikuandmete töötlemise tingimused.
5. Poolte allkirjad
Tellija: Täitja:
Lisa 1
Tehniline kirjeldus - SKAIS2 üleviimine REST-põhistele rahvastikuregistri x-tee
teenustele ja kaasnevad parendused SKAIS2 infosüsteemis
1. Mõisted ja lühendid
Mõiste/Lühend Kirjeldus
MVP (Minimal viable product) siin: SKAIS2 infosüsteemis
Rahvastikuregistri SOAP X-tee teenuste pealt üle minek REST
X-tee teenustele
REST REST (representational state transfer) on tarkvaraarhitektuuri
laad, mis seab veebirakenduse loomisele kindlad piirid. REST
arhitektuuri põhiidee seisneb selles, et tehakse erinevat tüüpi
päringuid REST-arhitektuuriga üles seatud erinevatele URI-dele,
mis seejärel vastavad sobiva vastusega. Vastuse vorming ei ole
kindlaks määratud ja oleneb rakenduse tüübist. Levinumad
vormingud on JSON, HTML ja XML.
RR Rahvastikuregister, andmekogu, mis koondab Eesti kodanike,
Eestis elukoha registreerinud Euroopa Liidu kodanike ja Eestis
elamisloa või elamisõiguse saanud välismaalaste peamisi
isikuandmeid. Registrit haldab ja arendab vastutava töötlejana
Siseministeerium.
SOAP SOAP (algselt tähenduses Simple Object Access Protocol 'lihtne
objektipöördusprotokoll') on arvutivõrkudes kasutatav protokoll,
millega veebiteenused vahetavad omavahel struktuurseid
andmeid. Kasutab andmete ülekandmisel XML-vormingut.
SKA Sotsiaalkindlustusamet
SKAIS1 Sotsiaalkaitse infosüsteem (vananenud platvormil)
SKAIS2 Sotsiaalkaitse infosüsteem uus rakendus (hõlmab
Ametnikurakendust ja Iseteenindust)
SMIT Siseministeeriumi infotehnoloogia- ja arenduskeskus
STAR, STAR2 Sotsiaalteenuste ja -toetuste andmeregister
UAT Vastuvõtutestimine (user acceptance test)
2. Ülevaade
Siseministeeriumi infotehnoloogia- ja arenduskeskus (SMIT) arendab 2025-2026.a välja uued X-tee
teenused, sest rahvastikuregister liigub tänaste SOAP X-tee teenuste pealt kaasaegsamate REST X-
tee teenuste pakkumise poole.
Muudatus nõuab arendustöid ka rahvastikuregistri X-tee teenuste kasutajatelt. Lisaks vajadusele
minna üle SOAP X-tee teenuste pealt üle REST X-tee teenustele on vajalik sellega kaasnevalt
lahendada erinevad teadaolevad ning tööde käigus täiendavalt selguda võivad SKAIS2 ärilised ja
tehnilised probleemid.
Hetkel teadaolevalt Rahvastikuregistri ajakava (detailsem ajaplaan avalikustatakse esimesel
võimalusel):
31.03.2025 – Teenused on testitavad DEV ja TEST keskkonnas.
31.08.2025 – Isiku andmete ja Isikute muudatuste teenused on toodangus ja kasutusele
võetavad.
31.01.2026 – Isikute otsingu teenus on toodangus ja kasutusele võetav.
31.12.2026 – Kandeteenused on toodangus ja kasutusele võetavad.
Praegu SKAIS2-es kasutusel olevad RR SOAP X-tee teenused :
POPULATION_REGISTRY_CHANGES – RRisikuandmeteMuudatused
RR456 - RR456
PERSON_PLACE_OF_STAY – RrisikuViibimiskoht
RR67_muutus - RR67_muutus
RR458 - RR458isikuTDkontroll (Kasutusel ainult Test keskkonnas).
Teenused mida eelduslikult peab SKAIS2-es kasutusele võtma - Isiku andmete teenus ja Isikute
muudatuse teenus.
Hetkeolukord:
Varasemalt teostatud tööde käigus on:
analüüsitud andmevahetust rahvastikuregistriga
o RR458 ehk elamisõiguste ja isikut tõendavate dokumentide teenus;
o RR456 ehk IK alusel Isiku detailandmete pärimine RR-st;
o RRIsikuViibimiskoht ja RRIsikuAndmeteMuudatused teenused
loodud SKAIS2 uus moodul population-registry-processing eesmärgiga hoida kõiki andmeid
seoses RR päringute protsessimisega. Isiku andmeid hoitakse endiselt olemasolevates
tabelites (näiteks isik ja skais2 mooduli tabelid);
tegeletud RR teenuste päringuvastuste veahaldusega probleemkirjete puhul;
2025.okt toodangusse viidud RRIsikuViibimiskoht ja RRIsikuAndmeteMuudatused teenuste
arendused.
Äritellija poolt on kaardistatud teenuste poolt isikuandmete kasutamine ja koostatud loetelu
isikuandmete haldusega seotud SKAIS2 teadaolevatest probleemkohtadest.
3. Hankelepingu eesmärk
Lepingu eesmärgiks on tagada SKAIS2 üle viimine SOAP-põhistelt X-tee teenustelt uutele REST-
põhistele rahvastikuregistri X-tee teenustele ning teostada sellega kaasnevalt SKAIS2 infosüsteemi
tehnilised ja äriprotsesside vajalikud prioriseeritud parendused.
4. Tellitavad tööd
4.1. Lepinguga tellitakse SKA infosüsteemi - Rahvastikuregistri jaoks vajaliku andmevahetuse SKAIS2
poolsed arendused ning sellega seonduvad äriliste protsesside ja tehnilise lahenduse parendustööd,
sh vähemalt:
RR SOAP X-tee teenustelt REST X-tee teenustele ülemineku ja SKAIS2 infosüsteemis
kaasnevate parendustööde detailanalüüs sh võttes arvesse:
o MVP (SKAIS2 infosüsteemis Rahvastikuregistri SOAP X-tee teenuste pealt üle minek
REST X-tee teenustele);
o tellija poolt kirjeldatud RR andmehaldusega ja äriliste protsessidega seotud
teadaolevate lahendamist vajavate probleemide ja/või muudatusvajaduste
prioriseeritud nimekirja;
o SKAISi arhitektuuri manifesti;
Arenduskoobi täpsustamine, prioriseeritud tööde nimekirja (backlog) loomine koostöös SKA
ja TEHIKuga. Nimekiri peab olema kirjeldatud detailsusega, mille alusel on võimalik iga töö
suurusjärku hinnata;
Arendusskoobi teostusmahu hindamine - prioriseeritud tööde nimekirjas (backlogis)
olevatele töödele esialgsete mahuhinnangute täpsustamine;
Projekti vaheetappide detailse kava täpsustamine koostöös tellijaga lähtuvalt RR SOAP X-tee
teenuste pealt üle minek REST X-tee teenustele Rahvastikuregistri poolt täpsustavatest
tähtaegadest ja detailanalüüsi tulemustest
Tööde teostamine lähtuvalt täpsustatud vaheetappide kavast ja vahetähtaegadest;
Arenduste testimise tagasiside alusel lahenduse täiendused ja parendused;
SKA teenuste jaoks vajaliku RR andmevahetuse TO-BE protsessi tervikvoo
o teiste andmesüsteemide (STAR, SKAIS1, RR) arenduste käigus täpsustuvatest
detailidest tulenevad SKAIS2 muudatusvajadused;
o teiste SKAIS2 moodulite arendus- ja/või täiendusvajadused;
Tööde käigus täpsustakse automaattestidega kaetud funktsionaalsus ja koormustestide
skoop.
Tööd tuleb üle anda vastuvõtutestimisteks vastavalt käesoleva dokumendi punktis 6 toodud
ajakavale.
4.2. Tööde loetelu tekib eelnevalt kokkulepitud backlogi alusel ja hallatakse Jiras:
Eelanalüüsi suunatud ülesanded (analüüsi task), mille tulemusel valmivad mahuhinnangutega
kasutajalood (story’d) ja tehnilised eeldustööd (technical taskid);
Arendusse suunatud kasutajalood (story’d) ja tehnilised eeldustööd (technical taskid) backlog
staatuses vastavalt tööde järjekorrale (rank).
4.3. Tellijal on õigus koostöös täitjaga täpsustada ja/või korrigeerida hankega tellitavate tööde skoopi
ja/või ajaplaani juhul kui tööde elluviimise käigus selgub selleks põhjendatud vajadus.
4.4. Juhul, kui töö käigus selgub täiendavaid ärinõudeid või detaile, mille realiseerimine on küll vajalik,
kuid ei mahu punktis 4.1 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.1 kirjeldatud skoobist midagi välja jätta, teeb
selle otsuse taasesitamist võimaldavas vormis Tellija.
4.5. Hankelepingu mahu muutumine, st täiendavate tööde tellimine või skoobis kirjeldatud tööde
teostamata jätmine, lepitakse Poolte vahel kokku hankelepingu muudatusega.
4.6. 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.
5. Tööprotsess ja tulemid
Järgnevalt täpsustatakse Täitjaga sõlmitud raamlepingus (nr 3-9/4283-1) kirjeldatud tingimusi
tööprotsessi, dokumenteerimise, töökorralduse, testimise ja mittefunktsionaalsete nõuete osas.
5.1 Tööprotsess
5.1.1. Tööraamistik peab tuginema etapiviisilisele planeerimisele, võimaldades arendusmeeskonna
prioriteete jooksvalt muuta;
5.1.2. Tööraamistik peab võimaldama süsteemset ülevaadet iga kokkulepitud töö saavutustest;
5.1.3. Tööraamistik peab võimaldama arendusmeeskonna tulemuslikkuse (kasvu) jälgimist ajas;
5.1.4. Tööraamistik peab tagama, et arendusmeeskond tegeleb omal initsiatiivil enda
tulemuslikkuse parandamisega ja parendusettepanekute esitamisega;
5.1.5. Täpsem töökorraldus lepitakse kokku pärast lepingu sõlmimist;
5.1.6. Tööde loetelu tekib eelnevalt kokkulepitud backlogi alusel ja hallatakse Jiras:
5.1.6.1. Eelanalüüsi suunatud ülesanded (analüüsi task), mille tulemusel valmivad
mahuhinnangutega kasutajalood (story’d) ja tehnilised eeldustööd (technical taskid);
5.1.6.2. Arendusse suunatud kasutajalood (story’d) ja tehnilised eeldustööd (technical taskid)
backlog staatuses vastavalt tööde järjekorrale (rank).
5.2 Dokumentatsioon
Vastavalt punktis 4 kirjeldatud skoobile tuleb töö käigus luua ja täiendada SKAIS2 dokumentatsiooni,
milleks on minimaalselt:
5.2.1. 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.
5.2.2. Tehniline dokumentatsioon (nt paigaldusjuhendid, Confluence keskkonnas).
5.2.3. Andmemudel.
5.2.4. Dokumentatsiooni täpsed liigid ja sisu formaat lepitakse kokku tööde käigus kuid see peab
vastama minimaalselt TK Lisa 2 – Nõuded arendusprojektide dokumentatsioonile SKAISi
näitel kirjeldatud nõuetele ning nõuded liidestuste dokumenteerimisele on kirjeldatud TK
Lisa 3 – Andmevahetusteenuse kirjelduse mall (draft).
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, ü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.4 Nõuded automaattestimisele
Automaattestimise nõuete täitmisel tuleb lähtuda nõuetest, mis on leitavad TEHIK arendusjuhendid
veebilehelt menüüpunktist Automaattestide nõuded.
Testidega kaetakse serveripoolne ja vajadusel ka kasutajaliidese kood. Kaetavuse kontrolliks ja
raporteerimiseks seatakse Tellija koodihoidla keskkonnas (Gitlab) üles pideva integratsiooni töövoog,
mis seadistatakse koos toimima 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.
5.5 Koormustestimised
Koormustestide tegemine lepitakse Tellija Täitja poolt kokku tööde käigus.
5.6 Mittefunktsionaalsed nõuded
5.6.1. Mittefunktsionaalsete nõuete täitmisel tuleb lähtuda järgnevast:
5.6.1.1. Loodud kasutajaliidesed peavad vastama Euroopa standardi EN 301 549 V3.2.1 nõuetele.
5.6.1.2. Uue funktsionaalsuse loomisel tuleb lähtuda raamlepingus (nr 3-9/4283-1) ja selle lisades
kirjeldatud nõuetest ning SKAISi Arhitektuurimanifestist.
5.6.1.3. Täpsemad mittefunktsionaalsed nõuded, millest lähtuda, on leitavad TEHIK
arendusjuhendid veebilehelt menüüpunktist Mittefunktsionaalsed nõuded.
5.6.2. 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.
API teenustele ning keskmine päringu teenindamise aeg ei tohi olla suurem kui 2 sekundit.
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
Valminud tööde tulemid antakse üle hiljemalt 31.12.2027 üleandmise-vastuvõtmise aktiga, tööde
tulemid peavad sisaldama:
Viiteid dokumentatsioonile Confluence’is;
Viited tehtud töödele (Jira piletitena);
Viiteid koodile GitLabis.
Toimiv rakendus ja paigaldusjuhend
6. Tööde teostamise ajakava ja tähtaeg
Siseministeeriumi infotehnoloogia- ja arenduskeskus (SMIT) poolt ei ole veel avaldatud täpset uutele
RR REST teenustele ülemineku ajakava ja tehnilist dokumentatsiooni kuid on teavitatud, et
dubleerivate, sama funktsionaalsust võimaldavate, teenuste töös hoidmine on väga kulukas, mistõttu
plaanitakse need teenused, mida asendavad isiku andmete ja isikute muudatuste teenus, sulgeda
2026. aasta lõpuks. Detailsem ajaplaan avalikustatakse esimesel võimalusel. Sellest tulenevalt võivad
täpsustuda ka punktis 6.1 toodud vaheetappide ajakava ja tähtajad.
6.1. Projekti käigus teostatavate tööde vaheetappide ajakava ja tähtajad on toodud alljärgnevas
tabelis, detailsem tegevusplaan ja vahetähtajad täpsustatakse projekti käigus lähtuvalt vaheetappide
alguses teostatava detailanalüüsi tulemustest:
Etapp Vastuvõtutestimiseks üle antava Arendustööde Lõpptähtaeg
funktsionaalsuse kirjeldus, sh seonduvad üleandmise
tööd tähtaeg1 (hiljemalt)
6.1.1. SKAIS2 üle viimine SOAP-põhistelt X-tee Hiljemalt 31.12.2026
teenustelt uutele REST-põhistele 01.10.2026, SOAP x-tee
rahvastikuregistri X-tee teenustele Min-lt 2 kuud enne teenuste sulgemise
SOAP X-tee aeg, täpsustub
teenuste sulgemist - vastavalt
ajakava täpsustub rahvastikuregistri
vastavalt REST X-tee
rahvastikuregistri teenustele
REST X-tee ülemineku
teenustele ajakavale
ülemineku ajakavale
6.1.2. SKAIS2 isikuandmete haldusega seotud Täpsustatakse Täpsustatakse
tehnilise lahenduse parendused: projekti käigus projekti käigus
- RR teenuste töötluse ja lähtuvalt lähtuvalt
töötlusreeglite viimine population- detailanalüüsi detailanalüüsi
registry-processing moodulisse tulemustest tulemustest
- SOAP päringute ümbertegemine
REST-le
- RabbitMQ implementeerimine uues
rakenduses
- OT protsessimootoris vanade
protsesside eemaldamine
6.1.3. RR REST-põhistele teenustele ülemineku Täpsustatakse Täpsustatakse
raames SKAIS2 ärilistes protsessides projekti käigus projekti käigus
vajalike lähtuvalt lähtuvalt
korrastuste/paranduste/muudatuste detailanalüüsi detailanalüüsi
teostamine vastavuses äritellija (SKA) tulemustest tulemustest
poolt seatud prioriteetsuse järjestusele.
6.1.3.1 Andmete küsimise loogikad ja süsteemi
protsesside parandused
6.1.3.2 Vajadusel uute kuvade loomine ja/või
muutmine
6.1.3.2 Andmejälgija täpsemate/teenuste põhiste
eelseadistatud põhjenduste andmise
võimaluse loomine
1
Kõikide eelnevalt kirjeldatud arendustööde vastuvõtutestimiseks (so Jira piletid „Ready for AT“ ja toodangu
keskkonda paigaldatav kvaliteetne lähtekood) üleandmise lõpptähtaeg
6.1.3.4 Täiendavate andmepäringute käivitamise
funktsionaalsuse loomine kasutajakuvasse.
6.1.3.5 Sisendi andmine RR REST x-tee teenustele
ülemineku projektist tulenevate
muudatusvajaduste kohta teiste teenuste
protsessides ja kuvades
6.1.3.6 Detailanalüüsi tulemusel selguda võivad
vajalikud prioriteetsed muudatused
6.1.4. Vajadusel lisaks: Jooksvalt 31.12.2027
- Testimise tagasiside alusel
lahenduse täiendused ja
parendused;
- SKA infosüsteemi RR
andmevahetuse TO-BE protsessi
tervikvoo teiste andmesüsteemide
(SKAIS1, STAR, RR) arenduste
käigus täpsustuvatest detailidest
tulenevad SKAIS2
muudatusvajadused ja/või teiste
SKAIS2 moodulite arendus- ja/või
täiendusvajadused.
6.1.5. Tugiperioodil tehtavad tööd, lõpptähtaeg Täpsustatakse 31.12.2027
projekti käigus
lähtuvalt
detailanalüüsi
tulemustest
6.2. SKAIS2 arenduste teostajal kohustuslik kinni pidada detailanalüüsi tulemustest lähtuvalt
täpsustatud ajakavas toodud vahetulemite üleandmise tähtaegadest.
6.3. Kõikide eelnevalt kirjeldatud arendustööde vastuvõtutestimiseks (so Jira piletid "Ready for AT" ja
toodangu keskkonda paigaldatav kvaliteetne lähtekood) üleandmise lõpptähtaeg on sätestatud
punktis 6.1 ja täpsustatakse projekti käigus lähtuvalt detailanalüüsi tulemustest.
Lepingu lõpptähtaeg on 31.12.2027.
6.4. 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.
6.5. Tööd loetakse teostatuks tööde üleandmise-vastuvõtmise akti tellija poolt allkirjastamise
hetkest.
6.6. Punktis 6.1.1 ja 6.1.2 toodud arendustööde vastuvõtutestimiseks üleandmise lõpptähtaeg on
kriitiline ja ei või nihkuda hilisemaks, mistõttu täitjal on kohustuslik kinni pidada punktis 6.1.1 ja 6.1.2
toodud vahetähtaegadest.
Muudatused punktis 6.1 toodud ajakavas on võimalikud vaid tulenevalt arendustööde käigus
selgunud asjaoludest kokkuleppel tellijaga tingimusel, et see ei ohusta järgnevate vaheetappide
tähtaegu ja/või hanke objekti tarnimise tähtaega ning muudatusega ei muudeta lepingu üldist
olemust.
7. Tehnilise kirjelduse (ehk TK) lisad:
- TK Lisa 1 – SKAISi Front-end arendusreeglid;
- TK Lisa 2 – Nõuded arendusprojektide dokumentatsioonile SKAISi näitel;
- TK Lisa 3 – Andmevahetusteenuse kirjelduse mall (draft)
Lisa 3
ISIKUANDMETE TÖÖTLEMISE TINGIMUSED
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
AS HELMES, (edaspidi volitatud töötleja), registrikood 10364097, aadress Lõõtsa tänav 6 Tallinn
11415, keda esindab volikirja alusel Julia Mozberg,
on sõlminud käesoleva isikuandmete töötlemise lepingu hankelepingu nr 3-9/4283-.... lisana nr 3
(edaspidi leping):
1. Ese ja eesmärk
1.1. Lepingu esemeks on volitaja ja volitatud töötleja (edaspidi koos nimetatud kui pooled)
vaheliste tingimuste sätestamine seoses SKAIS tööde käigus käsitletavate andmete
töötlemisega.
1.2. Isikuandmete vastutavaks töötlejaks on Sotsiaalkindlustusamet, kes on andud
Volitajale 16.10.2018 teenuslepinguga nr 1-10/1486-1 (p 3.8) õiguse kaasata
isikuandmete töötlemiseks täiendavaid volitatud töötlejaid seoses
Sotsiaalkindlustusameti (edaspidi SKA) infosüsteemide arendamise, hooldamise või
muu taolise eesmärgi täitmiseks.
1.2.1. Ligipääs isikuandmetele võimaldatakse vajaduspõhiselt üksnes konkreetset
tööülesannet täitvale isikule ja üksnes mahus, mis on vältimatult vajalik ilmnenud
vea kõrvaldamiseks.
1.2.2. Volitatud töötlejal on õigus saada ligipääs isikuandmete töötlemiseks üksnes
raamlepingu nr 3-9/4283-1 täitmiseks, täpsemalt on õigus saada ligipääs
raamlepingus kokku lepitud toodangu-eelses ja toodangukeskkonnas tekkivate
vigade juurpõhjuste tuvastamiseks ja lahendamiseks, mida ei ole võimalik teisel
viisil lahendada.
1.3. Lepingu täitmiseks on volitatud töötleja isikuandmete töötlemisega seotud tegevused
lepingu alusel piiratud hankelepingu täitmiseks vajalike tegevustega.
2. Isikuandmed
2.1. Volitatud töötlejale võivad hankelepingu täitmise käigus teatavaks saada volitaja poolt
hallatavas infosüsteemis või andmekogus töödeldavad isikuandmed (SKAIS
põhimääruse § 7 -15 kirjeldab võimalikud isikuandmete koosseisud):
2.1.1. isiklikud andmed, nt inimese nimi, sünniaeg, isikukood, isikut tõendava
dokumendi andmed;
2.1.2. kontaktandmed, nt aadress, telefoninumber ja e-posti aadress;
2.1.3. eriliigilised isikuandmed, nt andmed isiku või tema pereliikme terviseseisundi,
majandusliku seisundi või perekonna kohta
2.1.4. jne
3. Volitatud töötleja kohustused
3.1. Volitatud töötleja on kohustatud:
3.1.1. tagama lepingueelsete läbirääkimiste ja lepingu täitmise käigus volitajalt ükskõik mis
vormis saadud isikuandmete konfidentsiaalsuse ja mitte edastama ega võimaldama
sellele teabele juurdepääsu kolmandale isikule ilma volitaja sellekohase selgesõnalise
kirjaliku nõusolekuta;
3.1.2. tagama, et lepingu täitmise raames töödeldavaid isikuandmeid ei edastata väljapoole
Euroopa Liidu liikmesriikide ja Euroopa Majandusühendusse kuuluvate riikide
territooriumi ilma volitaja sellekohase selgesõnalise kirjaliku nõusolekuta;
3.1.3. kasutama ja töötlema isikuandmeid üksnes hankelepingu täitmiseks ja volitaja
dokumenteeritud juhiste alusel, välja arvatud juhul, kui volitatud töötleja on
kohustatud teavet töötlema volitatud töötleja suhtes kohalduva õiguse alusel. Viimati
nimetatud juhul teavitab volitatud töötleja volitajat vastava kohustuse olemasolust
enne teabe töötlemist;
3.1.4. võimaldama juurdepääsu isikuandmetele ainult nendele isikutele, kellel on selleks oma
tööülesannete täitmiseks vajadus ning tagab, et need isikud on teadlikud ning järgivad
isikuandmete töötlemis alaseid nõudeid ja õigusakte, nad on saanud asjakohase
koolituse eelmainitud nõuete kohta, on võtnud endale konfidentsiaalsuskohustuse või
neile kehtib asjakohane seadusest tulenev konfidentsiaalsuskohustus;
3.1.5. teavitama volitajat toimunud või põhjendatult kahtlustatavast lepingu punktis 3.1.4.
sätestatud konfidentsiaalsuskohustuse rikkumisest viivitamatult;
3.1.6. täitma kõiki kehtivaid isikuandmete töötlemisalaseid nõudeid, andmete turvalisust
puudutavaid ning isikuandmete kaitse alaseid Euroopa Liidu ja Eesti Vabariigi
õigusakte ja muid eeskirju;
3.1.7. rakendama alltoodud organisatsioonilisi, füüsilisi ja infotehnilisi turvameetmeid
isikuandmete kaitseks juhusliku või tahtliku volitamata muutmise; juhusliku hävimise
ja tahtliku hävitamise eest ning õigustatud isikule andmete kättesaadavuse
takistamise eest, volitamata töötlemise, sh avalikustamise eest:
3.1.7.1. vältima kõrvaliste isikute ligipääsu isikuandmete töötlemiseks kasutatavatele
seadmetele;
3.1.7.2. ära hoidma andmete omavolilist lugemist, kopeerimist ja muutmist
andmetöötlussüsteemis, samuti andmekandjate omavolilist teisaldamist;
3.1.7.3. ära hoidma isikuandmete omavolilist salvestamist, muutmist ja kustutamist ning
tagama, et tagantjärele oleks võimalik kindlaks teha, millal, kelle poolt ja
milliseid isikuandmeid salvestati, muudeti või kustutati või millal, kelle poolt ja
millistele isikuandmetele andmetöötlussüsteemis juurdepääs saadi;
3.1.7.4. tagama, et igal andmetöötlussüsteemi kasutajal oleks juurdepääs ainult temale
töötlemiseks lubatud isikuandmetele ja temale lubatud andmetöötluseks;
3.1.7.5. tagama andmete olemasolu isikuandmete edastamise kohta: millal, kellele ja
millised isikuandmed edastati, samuti selliste andmete muutusteta säilimise;
3.1.7.6. tagama, et isikuandmete edastamisel andmesidevahenditega ja andmekandjate
transportimisel ei toimuks isikuandmete omavolilist lugemist, kopeerimist,
muutmist või kustutamist;
3.1.7.7. pidama arvestust isikuandmete töötlemisel kasutatavate tema kontrolli all
olevate seadmete ja tarkvara üle, dokumenteerides järgmised andmed:
3.1.7.7.1. seadme nimetus, tüüp ja asukoht ning seadme valmistaja nimi;
3.1.7.7.2. tarkvara nimetus, versioon, valmistaja nimi ja kontaktandmed.
3.1.8. teavitama kirjalikult volitajat turvameetmete rikkumisest, mis põhjustab, on
põhjustanud või võib põhjustada töödeldavate isikuandmete juhusliku või
ebaseadusliku hävitamise, kaotsimineku, muutmise või loata avalikustamise või neile
juurdepääsu viivitamata, kuid mitte hiljem kui kakskümmend neli tundi pärast sellest
teada saamist. Juhul, kui rikkumisest teadasaamine langeb nädalavahetusele või
riiklikule pühale, kohustub volitatud töötleja volitajat kirjalikult teavitama
viivitamatult, kuid mitte hiljem kui nelikümmend kaheksa tundi pärast rikkumisest
teada saamist. Kirjeldatud teates tuleb vähemalt:
3.1.8.1. kirjeldada isikuandmetega seotud rikkumise laadi, sealhulgas puudutatud
andmesubjektide liike ja arvu ning puudutatud kirjete liike ja arvu;
3.1.8.2. teatada andmekaitsespetsialisti või mõne teise täiendavat teavet andva
kontaktisiku nimi ja kontaktandmed;
3.1.8.3. soovitada meetmeid isikuandmetega seotud rikkumise võimalike negatiivsete
mõjude leevendamiseks;
3.1.8.4. kirjeldada isikuandmetega seotud rikkumise võimalikke tagajärgi;
3.1.8.5. kirjeldada volitatud töötleja poolt pakutud või võetud meetmeid
isikuandmetega seotud rikkumisega tegelemiseks ja
3.1.8.6. esitada muud teavet, mis on mõistlikult nõutav, et volitaja saaks täita
kohaldatavaid andmekaitse õigusakte, sealhulgas riigiasutustega seotud
teavitamise ja avaldamise kohustusi, näiteks teavet, mis on nõutav
andmesubjekti tuvastamiseks.
3.1.9. lõpetama eelnevalt kirjeldatud rikkumised või tegema kõik endast oleneva nende
lõpetamiseks ja kohaldama meetmeid isikuandmetega seotud rikkumise
lahendamiseks, sealhulgas vajaduse korral rikkumise võimaliku kahjuliku mõju
kõrvaldamiseks ja leevendamiseks;
3.1.10. kustutama, niivõrd kui see on võimalik, lepingu lõppemisel kõik tööde teostamise
käigus teatavaks saanud isikuandmed ja nimetatute koopiad 30 päeva jooksul, v.a
juhul, kui õigusaktidest tuleneb teisiti;
3.1.11. tegema volitajale kättesaadavaks kogu teabe, mida volitaja peab vajalikuks lepingus
sätestatud kohustuste täitmise tõendamiseks;
3.1.12. võimaldama volitajal või volitaja poolt määratud audiitoril teha seoses isikuandmete
töötlemisega auditeid ja kontrolle ning panustama nendesse.
4. Lõppsätted
4.1. Volitatud töötleja ei või oma lepingujärgseid kohustusi anda üle kolmandale isikule ega
kaasata oma lepingujärgsete kohustuste täitmiseks kolmandat isikut.
4.2. Isikuandmete konfidentsiaalsena hoidmise kohustus jääb kehtima ka pärast käesoleva
lepingu lõppemist tähtajatult.
4.3. Isikuandmete konfidentsiaalsena hoidmise kohustus ei laiene teabe avaldamisele
volitatud töötleja audiitorile ja advokaadile.
4.4. Leping on kehtiv poolte poolt allkirjastamisest kuni hankelepingu järgsete kohustuste
täitmiseni, v.a konfidentsiaalsuskohtustus, mis kehtib tähtajatult.
5. Poole allkirjad
Volitaja: Volitatud töötleja:
/Allkirjastatud digitaalselt/ /Allkirjastatud digitaalselt/
HANKIJA NIMI: Tervise ja Heaolu Infosüsteemide Keskus
Pakkumusettepaneku nimetus: „SKAIS2 üleviimine REST-põhistele rahvastikuregistri x-tee teenustele ja
kaasnevad parendused SKAIS2 infosüsteemis“
Käesolevaga teeb Tervise ja Heaolu Infosüsteemide Keskus (Hankija) Teile ettepaneku esitada pakkumus
„SKAIS2 üleviimine REST-põhistele rahvastikuregistri x-tee teenustele ja kaasnevad parendused SKAIS2
infosüsteemis“ teostamiseks raamlepingu nr 3-9/4283-1 alusel. Hankeleping sõlmitakse tulenevalt vajadusest
realiseerida SKAIS2 üle viimine SOAP-põhistelt X-tee teenustelt uutele REST-põhistele rahvastikuregistri X-tee
teenustele ning teostada sellega kaasnevalt SKAIS2 infosüsteemi tehnilised ja äriprotsesside vajalikud
prioriseeritud parendused.
Hankija soovib hankelepingu sõlmida ühe partneriga. Hankija soovib kõrvale kalduda raamlepingu
„Sotsiaalkaitse valdkonna teenuste arendus- ja hooldustööd“ nr 3-9/4283-1 tellimuse esitamise korrast ja
pöörduda kohe paremusjärjestuselt järgmise pakkumuse teinud raamlepingu täitja poole tuginedes
raamlepingu punktile 6.2.4, Pakkumuse esitamise tähtaeg on 09.02.2026 kell 16:00 (võib esitada ka varem).
Pakkumus saata e-posti aadressile
[email protected].
Pakkumus tuleb esitada eesti keeles ja digitaalselt allkirjastatult.
Pakkumus esitatakse Hankelepingu eseme tehnilises kirjelduses (Lisa 1) toodud tööde teostamiseks.
Alternatiivsete pakkumuste esitamine ei ole lubatav.
Töid tellitakse mahus kuni 1 200 000 eurot (ilma km-ta). Lepingu täitmist rahastatakse riigieelarve raames.
Töid teostatakse jooksva tunnihinna arvestuse põhiselt lähtudes projekti vaheetappide ajakavast ja
vaheetappide raames kavandatud funktsionaalsusest. 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.
Projekti käigus teostatavate tööde aluseks on vajadus vajadusele minna üle rahvastikuregistri SOAP X-tee
teenuste pealt üle uutele REST X-tee teenustele, millega kaasnevalt soovitakse kaasnevalt lahendada erinevad
teadaolevad ning tööde käigus täiendavalt selguda võivad SKAIS2 ärilised ja tehnilised probleemid. Projekti
vaheetappide detailne sisu täpsustatakse vaheetappide alguses teostatava analüüsi käigus, mille tulemusena
täpsustatakse ka vaheetappide detailsem ajaplaan. Ajaplaani võib mõjutada ka rahvastikuregistri
rahvastikuregistri REST teenustele ülemineku detailsema ajaplaani selgumine, mis hetkel ei ole veel
avalikustatud. Projekti vaheetappide sisu kirjeldus ja hetkel teadaolev ajakava on toodud Hankelepingu eseme
tehnilise kirjelduse (Lisas 1) punktis 6. Vaheetappide käigus loodav funktsionaalsus tuleb
vastuvõtutestimiseks üle anda tähtaegadeks:
1.vaheetapp: RR REST-põhistele teenustele üleminek - hiljemalt 01.10.2026;
Ülejäänud vaheetapid: vastavalt analüüsi tulemina täpsustatud vahetähtaegadele;
Kõikide kirjeldatud tööde lõpptähtaeg on 31.12.2027.
Pakkuja meeskond peab olema koheselt valmis täistööajaga panustama üksnes selle projekti õnnestumisse.
Pakkumusena tuleb esitada:
1. Tööde teostamiseks planeeritud meeskonnaliikmed isikuliselt, tuues välja ka meeskonnaliikmete
roll. Tööde teostamiseks peavad täitja meeskonda kuuluma minimaalselt 1 analüütik, 1 arhitekt, 4
arendajat, 1 testija ning projektijuht, kes vastutab tööde korrektse ja tähtajalise elluviimise ning
tellijaga suhtluse eest. Töid peavad teostama pakkumuses nimetatud isikud. Kui meeskonnaliikmed
erinevad riigihankes pakutud meeskonnast, tuleb pakkujal esitada nõuetele vastavate
meeskonnaliikmete andmed etteantud vormil koos pakkumusega;
2. Tööde teostamise ühe töötunni hind (ilma käibemaksuta);
3. Tööde teostamise detailne projektiplaan, mis lähtub Hankelepingu tehniline kirjeldus (Lisas 1)
punktis 6 toodud vaheetappide ajakavast.
Pakkumuse esitamisega kinnitab pakkuja, et pakkuja on suuteline kinni pidama Hankelepingu eseme tehnilise
kirjelduse (Lisas 1) punktis 6 toodud vaheetappide ajakavast ja lepingu tähtaja saabumiseks on teostatud
Hankelepingu eseme tehnilises kirjelduse (lisas 1) punktis 4 toodud 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 (koos lisadega)
Lisa 2. Hankelepingu projekt.
Lisa 3. Isikuandmete töötlemise tingimused.
Front-end arendusreeglid
FE arendusreeglid
Versioon: 1.0
Lühendid
FE – Front-end
BE – Back-end
FF – Mozilla Firefox
IE – Internet Explorer
UI – User interface (kasutajaliides)
SEO – Search engine optimization
Eesmärk ja sihtgrupp
FE arendusreeglid on mõeldud kõigile FE ja BE arendajatele. Reeglite järgimine on kohustuslik.
Veebilehitsejate tugi
A klass: IE10+, Chrome (viimane versioon), FF (viimane versioon), Microsoft Edge (viimane versioon)
Lõpptulem ei tohi kujundusest erineda, välja arvatud veebilehitsejate implementatsioonist tulenevad erandid (näide: selectboxi native
kujundus on veebilehitsejates omavahel erinev ja see on lubatud)
B klass: Safari
Visuaalselt korrektne, aga võib erineda algsest kujundusest. Optimeerimise ja kodeerimise lihtsustamise eesmärkidel ei pea näiteks toetama
ümarad nurkasid, gradiente jne.
Stiililehed
Üks peamine stiilileht nimega main.css, kus sees loogilises järjestuses kommentaaridega eristatult kõik rakenduse stiilid.
Printimise jaoks on print media abil eraldi kuvatav stiilifail, mille eesmärk on kuvada sisuosa ilma illustreerivate elementideta. Ära peidetud on navigatsiooni
elemendid, mis prinditud versioonis ei ole olulised.
Kataloogide stuktuur
gfx – CSSid koos CSSis defineeritud piltidega.
images – HTMLis lingitud pildid. Alamkataloogid vajadustel komponendi põhistele elementidele, kui on ühes komponendis kasutusel rohkem kui 15 pilti.
fonts – rakenduses kasutatavad fondi failid.
scripts – rakenduses kasutatavad JS failid.
CSSi haldamine
CSSi stiilidel on üks haldaja ja vastutaja, kes on kursis kõigi muudatustega. Tema kohustus on üle vaadata teiste poolt kirjutatud CSS ja vastavalt
vajadusele muuta või saata tagasi arendajale parandamiseks.
CSSi haldamise eesmärk on, et ainult CSSi haldaja ja/või FE meeskond kirjutab CSSi. Arendajad peavad pöörduma CSSi haldaja ja/või FE meeskonna
poole, kui on muudatusi vaja. CSSi haldaja koordineerib teiste arendajate tööd.
BE arendajad tohivad stiile kirjutada ainult põhilise stiilifaili lõppu pärast vastavat kommentaari. Enda arendused peavad olema kommenteeritud nii, et
CSSi haldaja saaks võimalikult kiirelt koodi üle vaadata ning sobivasse asukohta paigutada ja vajadusel koodi muuta.
Eelnev kirjeldab olemas oleva koodi muutmist või väikseid uusi arendusi olemas olevas raamistikus. Uute arenduste korral tuleb tellida FE antud ala
spetsialist, kellele on edastatud antud dokument. Kui uue koodi kirjutada ei ole CSSi haldaja on haldajal kohustus ülevaadata uus kood.
Illustreerivad pildid
Illustreerivad pildid peavad olema lisatud CSSi abiga.
Pildid on optimeeritud. Salvestamisel valitud sobiv laiend vastavalt suurusele ja kvaliteedile. Võimalusel kasutatud Fireworksi, PNG optimizerit või
antud hetkel sobivat vahendit vähendamaks piltide mahtu.
Photoshopis tuleks pildid salvestada save for web abil. JPG puhul võib salvestada 75-80% ilma, et oleks visuaalset kadu. Kui pildi suuruseks on u
150KB, siis kontrollida üle optimeerimise võimalused.
CSSis ja HTMLis lingitud pildid asuvad eraldi kataloogis.
CSSis lingitavad illustreerivad pildid asuvad CSSiga samas kataloogis. Eelistada illustreerivate piltide kuvamist läbi CSSi.
HTMLis lingitud piltide nimetamisel arvestada SEOd ja ühtset stiili.
CSSi pildid nimetada sarnase loogikaga. Ikoonide alguses on icon_, taustapiltidel bg_ logodel logo_, nimekirjadel ul_ ja komponentide spetiifiliste
piltidel puhul selle classi nimetus.
Pildi nimed on läbivalt inglise keeles ja semantiliste nimetusega. Ei tohi kirjeldada pildil olevat värvi.
Semantika
Front-end kood peab vastama semantika reeglitele, välja arvatud juhul, kui kokkulepitud kasutatav raamistik ei võimalda seda saavutada.
Kodeerimisel tuleb arvestada responsive (kohandub iseenesest ümber erinevatele ekraanisuurustele) versioonile üleminekuga.
Olulisemad punktid
Classi nimed on üldised või komponendi spetsiifilised
Classi nimedes ei tohi olla kasutatud visuaalseid kirjeldusi.
Näiteks värvid, suurused jne.
Kasutada semantiliselt korrektseid HTMLi elemente.
Näiteks nimekirjade puhul peab olema kasutatud UL või OL tagi vastavalt sisule.
BR ei tohi kasutada.
Layouti loomisel ei tohi kasutada tabeleid.
Inline elemendi sisse ei tohi panna block elemente.
Paragraafide sisse ei tohi kirjutada DIVe.
Vältida tühjade HTMLi elementide kasutamist.
Re-usable front-end
1. Enne kodeerimist tutvuda olemasolevate komponentidega.
2. Võimalusel kasutada olemasolevaid elemente.
3. Kujunduses olevate väikeste erinevuste puhul pakkuda välja ühtlustamise võimalusi ja lahendusi.
4. Kasutada üldiseid classi nimetusi ja arvestada kodeerimisel, et antud stiile oleks võimalik kasutada läbivalt. Erandite puhul kasutada eraldi classi
nimetust.
5. Kodeerimisel arvestada, et uue elemendi muutmine ja haldamine oleks võimalikult lihtne. Näiteks arvestada keelsusega. Võimalusel vältida keelte
jaoks erandite tegemist.
HTMLi reeglid
HTML peab valideeruma kasutades https://validator.w3.org HTML valideerimisvahendit.
Inline CSSi ei tohi kirjutada ja kasutada.
Cellpadding'uid ja cellspacing'uid ei tohi kasutada HTMLis.
Võimalusel kirjutada optimeeritud koodi ja vältida üleliigseid elemente ja defineeringuid.
Kasutada läbivalt ühtset stiili.
Jutumärkideks on topelt jutumärgid
näide class="style01"
Arenduse failid on ühe tabi abil trepitud.
Arvestada SEO soovitusi
Vajadusel illustreeritavatel piltidel korrektsed alt väärtused.
Meta tagid vastavalt kaasaegsetele nõudmistele.
Piltide või ikoonide puhul, mis on kasutusel linkidena, kasutada title tagi. Title sisu peab kasutajale andma informatsiooni, et kuhu see link
kasutaja suunab.
Näide logo title väärtus on "Avalehele"
HTMLis vältida ja eemaldada üleliigsed kommentaarid.
CSSi reeglid
Kehtib FE arendaja poolt loodud stiililehtede kohta. Ei kehti juhul, kui kokkulepitud kasutatav raamistik ei võimalda seda saavutada.
CSS peab valideeruma kasutades https://jigsaw.w3.org/css-validator/ CSS valideerimisvahendit.
CSSi treppimine
Selektori ja loogeliste sulgude vahele üks tühik.
Üks tab enne atribuuti (laiuselt võrdne nelja tühikuga).
Selektorid ja atribuudid on eraldi ridadel.
Näide
ul*{
****margin:*0;
}
Selectori blokkide vahel tühjad read eraldamaks erinevaid elemente aga üldiselt ilma tühja reata.
h1 {
font-size: 34px;
}
h2 {
font-size: 24px;
}
a {
color: #08c;
}
a:focus,
a:hover {
color: #ff6;
}
Esimese taseme ja teise taseme kommentaari ees ja järgi üks tühi rida.
CSSis blokkide järjekord:
normalize/reset, global
common
vastavalt struktuurile header, content ...
Plugina CSSid, kui on tegemist pluginaga, mida kasutatakse samade stiilidega erinevates asukohtades, siis antud CSS lisada eraldi faili.
media queries
CSS Atribuutide järjekord:
display: ;
position: ;
top: ;
float: ;
clear: ;
width: ;
height: ;
overflow: ;
margin: ;
padding: ;
outline: ;
border: ;
background: ;
list-style: ;
table-layout: ;
border-collapse: ;
vertical-align: ;
text-align: ;
text-indent: ;
text-transform: ;
line-height: ;
word-spacing: ;
color: ;
font: ;
cursor: ;
visibility: ;
opacity: ;
z-index: ;
content: ;
quotes: ;
CSS3
Ühikud
Eelistatult läbivalt kasutada pixleid.
0 väärtuse korral ühik pole vajalik. 0em == 0px == 0
Class' ja ID nimetused läbivalt väikeste tähtedega, semantilised ja eralduseks kasutatud sidekriipsu.
Näide: data-table-outer
Classide nimetamisel kasutada läbivalt inglise keelt.
ID kasutada ainult juhul, kui ollakse täiesti kindel, et seda elementi tulevikus ei kasutata lehel korduvalt. Näiteks lehe layout päis, jalus, menüü.
CSSis on kaks taset kommentaare.
1. esimene tase
/**
=Kommentaar
*/
2. teine tase
/** =Kommentaar */
Kommentaarid läbivalt inglise keeles. Vajadusel rakenduse spetiifilisi mõisteid kasutada eesti keeles.
Välja kommenteeritud koodi ei tohi jätta alles.
Margin ja paddingute korrektne kasutamine. Paddingut kasutada antud elemendi sisse nn õhu jätmiseks ja marginit väljapoole.
Tekstide joondamisel vältida line-heighti abil joondamist ja eelistada paddingut.
Floatide clearimiseks on class clear, mis läheb floatitud elementide ümber olevale tagile.
.clear:before,
.clear:after {
content: " ";
display: table;
}
.clear:after {
clear: both;
}
CSS kirjutada ainult selleks mõeldud faili. Inline CSSi ja HTMLi failis eraldi <style> kasutada ei tohiks. Võimalusel vältida ka visuaalsete stiilide
defineerimist JS failides.
Pildi URLi lisamisel jutumärke ei ole vaja kasutada.
Vältida veebilehitsejaspetiifilisi häkke.
Kodeerimisel arvestada mõistlikkuse piirides "Web Content Accessibility Guidelines (WCAG) 2.0" soovitusi.
http://www.w3.org/WAI/WCAG20/quickref/
http://kristjankure.com/
Optimeerimine FE tehnikate abil
https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Writing_efficient_CSS
tbody#select-01 => #select-01
#navigation li a => #nav a
tr.tr-name td.td-name => .td-name
HTMLis olevatele piltide määrata kõrgus ja laius, kui on võimalik. Eesmärk vähendada re-flow'ed.
Gradientide, ümarate nurkade jne puhul kasutada CSS3 ning vanematel veebilehitsejatel peab kujundus välja nägema visuaalselt korrektne aga
ei pea olema visuaalselt identne. Kontrollida veebilehitseja võimalusi siit http://caniuse.com/.
Kui on võimalik illustreerivad pildid nt nooled, bulletid asendada CSS3 lahendusega, siis seda võimalust kasutada. Kui vajadus tühja elementi
kasutada, siis selle asemel kasutada CSSis before'i võimalust. Selle juures tuleks arvestada veebilehitsejate tuge ja kasutajamugavust
mõistlikuse piirides. Informatsioon peab olema arusaadav ja kättesaadav ka B klassi veebilehitseja toele.
Reflow ja repaint'iga arvestamine.
CSSi reseti asemel kasutada normalize.
Värvid kirjutada koodi abil (soovitavalt hex aga vajadusel rgba) ja läbivalt väikeste tähtedega. Võimalusel lühendada kolme tähelisteks.
#ffffff => #fff
#ff88aa => #f8a, #ff0000 => #f00
Võimalusel CSSi väärtused tõsta kokku ühele reale.
Border-top, border-left, border-bottom, border-right => border
CSSis ei tohi kasutada * lahendust määramaks kõigile elementide CSSi väärtuseid.
Important kasutamist CSSi failis vältida.
Normalize/reseti puhul ei tohiks olla defineeritud elemente, mida praktikas ei kasutata. Uue projekti alguses tuleks reset/normalize optimeerida ja
vajadusel jooksvalt juurde lisada elemente.
Võimalusel ja vajadusel kasutada sprite tehnikat.
Pluginatega kaasa tulevat CSSi peab ülevaatama, optimeerima ja järjekorda uuendama.
Kujundus
Linkidele, nuppudele alati korrektsed :hover, :focus ja :active staatused määrata.
hoveri ja fookuse puhul on eesmärk tuua visuaalselt element rohkem esile ja paremini loetavaks.
aktiivse staatuse puhul tuleks jätta mulje, et nupule või lingile on vajutatud. Visuaalselt poolelt näiteks gradient on vastupidine või lingi
värv on tagasihoidlikum.
Arvestada olemasoleva kujundusega ja jälgida sellele sarnast stiili.
Ühtlustada ja jälgida lõpptulemuse joonduseid.
Nõuded arendusprojektide dokumentatsioonile SKAISi
näitel
Versioon kuupäev muutja kommentaar
0.1 04.07.2024 Epp Laanepõld esmane versioon tagasiside saamiseks
Sissejuhatus
1. Süsteemi üldine kirjeldus
1.1. Sõnastik
2. Teenuste ja kasutuslugude dokumentatsioon
2.1. Näide:
2.2. CRUD maatriks
3. Arhitektuuri dokumentatsioon
3.1. Näide:
3.2. Andmebaasi kirjeldus
3.3. Näide:
Andmebaasimudel:
4. Paigaldus ja administreerimisjuhend(TO DO)
Versiooni muudatuse kirjeldus (release notes)
5. Täitja poolt teostatud testide dokumentatsioon
Sissejuhatus
Projekti väitel annab Täitja Tellijale üle dokumentatsiooni vastavalt arendusetapi kokkulepitud tulemitele.
Dokumentatsioon luuakse ja antakse üle digitaalsel ja redigeeritaval(Confluence wiki lehena) kujul Tellija Confluence keskkonnas.
Üleandmise hetkel fikseeritakse üleantav versioon.
Dokumentatsioon peab sisaldama versiooni ajalugu, et oleks üheselt tuvastatav dokumendi versiooni sisse viidud muudatused võrreldes viimati
üleantuga.
Vajadusel vormistatakse dokumentidest PDF-versioonid.
Dokumenteerimisel valmivad joonised ja prototüübid antakse Tellijale üle ka redigeeritavate failidena (joonised on redigeeritavad, eelistatult .EAP
formaadis või draw.io). Prototüübid on redigeeritavad FIGMA tarkvaraga.
Minimaalselt peab olema kaetud arendusprojektide läbiviimisel alljärgnevad osad dokumentatsiooniga:
Süsteemi üldine kirjeldus
Teenuste/kasutuslugude dokumentatsioon
Arhitektuuri dokumentatsioon
Paigaldus ja administreerimisjuhend
Loodavate testide dokumentatsioon
Juhendid ja abimaterjal
Vajadusel migratsiooniga seotud dokumentatsioon
Mittefunktsionaalsete nõuete vastavustabel*
*vastavuste/mittevastavuste fikseerimine vorm on projektimeeskonna kokkulepe.
Iga loodav dokument peab olema:
Struktureeritud;
Loetav ja selge;
Kindlas kõneviisis ning keeleliselt korrektselt kirjutatud;
Täpsete andmeväljade nimetustega ja mõistetega;
Vormistatud lõppversioonis nii, et tekst ei sisalda enam täiendavaid kommentaare ja täpsustusi.
1. Süsteemi üldine kirjeldus
Kirjeldada mis on arendusprojekti eesmärk, loodava funktsionaalsuse põhiülesanne;
Mis on arendusprojekti taust, probleemi või hetkeolukorra kirjeldus(Sisend arenduvajaduse vormilt);
Mis on arendusprojekti skoop;
Viited õigusaktidele;
Huvigrupid ja kasutajate kirjeldus;
Liidestused teiste infosüsteemidega;
Kasutatavad klassifikaatorid.
1.1. Sõnastik
Ot Kirjeldada projektis läbivalt kasutatavaid mõisteid ja lühendeid.
sta
rv
e:
Si Ühtne projekti(de) ülene sõnastik. Mõistete selgitamisel võib kasutada näiteid, mis annavad edasi mõistete sisu ning viidata dokumentidele, milles
su: mõisted enim kasutusel on, kuid see ei ole kohustuslik.
Ül Dokument esitatakse Tellijale kinnitamiseks jooksvalt vastavalt projektiplaanile ja projekti tegevustele. Dokument on järk-järgult täienev ning
ea dokumendi lõppversioon fikseeritakse üleandmise hetkel – vastavalt projektiplaanile kas projekti vaheetappide üleandmisel ja/või lõppemisel.
nd Järgnevate projektide tulemite loomisel võidakse aluseks võtta juba eelmiste projektide käigus loodud sõnastik, mida täiendatakse.
mi
ne:
Vii Wiki
te
d:
2. Teenuste ja kasutuslugude dokumentatsioon
Eeld Süsteemi üldine kirjeldus
us
dok
ume
ndil
e:
Otst Kirjeldab detailselt üleantavaid teenuseid/kasutuslugusid.
arve:
Sisu: Kasutuslugude kirjeldamise käigus koostatakse kõikide kasutusjuhtude kirjeldused kasutaja ja süsteemi vahelise interaktsiooni vormis.
Kirjeldused luuakse mitmel erineval tasemel – kirjeldatakse süsteemi ja kasutaja vahelist interaktsiooni koos süsteemisiseste tegevustega ning
kasutaja ja süsteemi objektide vahelist interaktsiooni. Kirjeldused tehakse nii tekstiliselt kui vajadusel graafiliselt (nt. activity, sequence,
collaboration, usecase diagrammidena), et saada võimalikult hea ülevaade kasutusjuhtudest.
Dokument sisaldab:
· Kasutusloo/teenuse kirjeldust;
· Ärinõudeid ja piiranguid;
· Ärireegleid(teostatavaid kontrolle);
· Tehnilise teenuse kirjeldust(API);
· Põhiprotsess ja mõned sagedamini esinevad alternatiivsed protsessid(vastavalt vajadusele);
· Üldine kirjeldus, kuidas ja kus kajastub antud teenus/kasutuslugu tervikprotsessis;
· Nõudeid ja reegleid toetavad(sisu mõistmisele kaasaaitavad) pildid, diagrammid, tabelid, loendid jne;
· Andmevahetuse teenuste kirjeldus(andmete küsimine/vastuvõtmine, turvalisus, teenuse andmestik, klassifikaatorid, xml/xsd schemad);
· Protsesside UML vaated;
· Feature flagide nimekiri.
2.1. Näide:
2.2. CRUD maatriks
On tööriist mida kasutatakse selleks, et kaardistada kasutaja poolseid tegevusi andmebaasi tasemel. See on lühend neljast põhitoimingust, mida
rakendused saavad andmetega teha:
Loomine
Lugemine
Värskendamine/uuendamine
Kustutamine
Maatriks koosneb tabelist milles erinevad andmeükskused on paigutatud veergu ja CRUD toimingud on paigutatud piki teist telge. Iga maatriksi lõikepunkt
näitab, kas konkreetset toimingut saab teha konkreetse andmeüksusega.
3. Arhitektuuri dokumentatsioon
Eeldus Süsteemi üldine kirjeldus, teenuste ja kasutuslugude dokumentatsioon
dokume
ndile:
Otstarve: Dokumendi eesmärgiks on kirjeldada loodava süsteemi üldist ehitust. Kirjeldatakse rakenduse loogilist struktuuri, näidates ära selle
kihtideks jagunemise korda. Kirjeldatakse ka füüsilist arhitektuuri, antakse ülevaade kasutatavatest tehnoloogiatest ning vahenditest.
Sisu: Dokumendis on kirjeldatud:
· Topoloogia, süsteemi füüsiline arhitektuur(süsteemi komponendid – andmebaasiserver, rakendusserver, meiliserver, xtee server jne.)
sh süsteemi soovituslikud näitajad komponentide kaupa: näiteks andmesidekiirused, andmemahud, protsessori kiirus, mälumaht,
kettasüsteemi jõudlus jne.
· Liidesed teiste süsteemidega ja sõltuvused teistest süsteemidest;
· Kolmandate osapoolte poolt toodetud kasutatavad tarkvarad/riistvada mis on vajalikud süsteemi toimimiseks;
3.1. Näide:
3.2. Andmebaasi kirjeldus
Eeldus dokumendile: Süsteemi üldine kirjeldus, teenuse ja kasutuslugude dokumentatsioon
Otstarve: Kirjeldada andmeobjekte ja nendevahelisi seoseid.
Sisu Füüsilise andmebaasi andmetabelite ja -objektide seoste diagramm koos tabelite semantika kirjeldusega kujul:
Tabeli nimi Semantika
PERSON Siin tabelis hoitakse inimestega seotud andmestikku....
Ja olemite omaduste kirjeldustega (andmetüübid, NULL/NOT NULL, kohutuslik, semantika, jne.)kujul:
Atribuudid Tüüp NULL/NOT NULL Semantika
PERSON_ID INTEGER NOT NULL Tabeli primaarvõti
.... ...... ..... .....
3.3. Näide:
Loogiline andmemudel
Andmebaasimudel:
4. Paigaldus ja administreerimisjuhend(TO DO)
Eeldus Süsteemi üldine kirjeldus, arhitektuuri dokumentatsioon, teenuste/kasutuslugude dokumentatsioon
dokume
ndile:
Otstarve Süsteemi paigaldamiseks ja administreerimiseks loodud dokumentatsioon.
:
Sisu: Juhendis on kirjeldatud sõltuvalt tarnest:
· Süsteemi parameetrite(seadistuste) kirjeldus;
· Logimise realisatsiooni kirjeldused(kuhu, mida, logide struktuur);
· Rutiinsete hooldusprotseduuride kirjeldus(komponentide taaskäivituse vajadus parameetrite muutmisel);
· Nõuded rakenduse komponentidele;
· Andmete alglaadimine*;
· Varundusskriptid;
· Monitooringu kirjeldus.
Paigaldusjuhendis kirjeldatakse iga realiseeritud osa rakendamine koos spetsiifiliste seadistustega, sh tuuakse välja esmakordsel
paigaldusel vajalikud tegevused ning erisused. Paigaldusprotseduurid peavad olema kirjutatud selliselt, et TEHIK administraator suudab
rakenduse paigaldada ilma kõrvalise abita.
Taasteplaan vajadusel*
Versiooni muudatuse kirjeldus (release notes)
Otsta Anda tellijale ülevaade infosüsteemi versioonide muudatustest ja versiooni ülespaneku hetkel teada olevatest vigadest.
rve:
Sisu: Detailne info iga versiooniuuenduse kohta – avaldamise kuupäev, versiooni number, tehtud muudatused, viited taskidele, ülevaade
teadaolevatest probleemidest, nt. vead mis ei sisaldu selles tarnes.
5. Täitja poolt teostatud testide dokumentatsioon
Otsta Anda Tellijale ülevaade läbiviidud testimiste tulemustest. Testide dokumentatsiooni järgides peab olema Tellijal võimalik kontrollida süsteemi
rve: nõuetekohast toimimist.
Sisu: Dokumentatsioon sisaldab teostatud arenduste testimisel saadud informatsiooni:
· Testiplaan;
· Testlood;
· Testraport;
· Jms.
Dokumenteeritakse iga testimise eesmärgid, tegevused ja tulemid. Teste mitteläbinud testlugudele on lisatud parandused või ülesjäänud vead.
Sisaldab jõudlus- ja mahutestide infot ning versioonide infot.
Automaattestide puhul antakse üle kood ning ülevaade Sonarqube’is(testide nimekiri, testide käivitamise tulemus, koodi kaetus).
Viited: JIRA keskkonda kasutatakse testimispiletite haldamiseks.
Andmevahetusteenuse kirjelduse mall (draft)
Teenuse nimi
Teenuse kirjeldus
Teenuse tehniline spetsifikatsioon
Päringu ja andmetöötluse arhitektuur
Päringu näide
Päringu väljundi vastavus päriva registri X mooduli andmetabelite väärtustega
Seotud klassifikaatorid
Kasutuslood
Andmetöötlus
Veahaldus
Monitooring
Ärivajadustest lähtuv monitooring
Tehniline monitooring
Teenuse nimi
Teenuse kirjeldus
Teenuse tehniline spetsifikatsioon
Teenuse kirjeldus Link www.x-tee.ee dokumentatsiooni keskkonda
Teenuse kood RR458
Teenuse liik SOAP/REST
Teenuse WSDL x-tee.ee/catalogue-data/EE/EE/GOV/70008440/rr/173.wsdl
Versioon V2
Näidis päringu tegemiseks Mis selle all mõeldi, all näide olemas
Dokumentatsioon (Registripidajalt) RR458 dokumentatsioon
Päringu ja andmetöötluse arhitektuur
Kirjeldus ja diagramm teenusega seotud moodulitest ning nende omavahelistest suhtlustest, võiks olla valmistatud kasutades draw.io pluginat otse wikis et
hilisemad täiendused oleks lihtsasti teostatavad
Päringu näide
Üks või rohkem näiteid päringu sisust (xml) + Sisendparameetrid
NÄIDE SISEND XML
Vcurl --location 'https://xtee6.test' \
--header 'Content-type: text/xml; charset=UTF-8' \
--data '<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:iden="http://x-road.eu/xsd/identifiers" xmlns:prod="ht
tp://rr.x-road.eu/producer/rr" xmlns:xro="http://x-road.eu/xsd/xroad.xsd">
<SOAP-ENV:Header>
<xro:userId>EE11111111111</xro:userId>
<xro:id>my1XSJpzA0THmGa404Lweg</xro:id>
<xro:protocolVersion>4.0</xro:protocolVersion>
<xro:client iden:objectType="SUBSYSTEM">
<iden:xRoadInstance>ee-test</iden:xRoadInstance>
<iden:memberClass>COM</iden:memberClass>
<iden:memberCode>10364097</iden:memberCode>
<iden:subsystemCode>helmesskais2</iden:subsystemCode>
</xro:client>
<xro:service iden:objectType="SERVICE">
<iden:xRoadInstance>ee-test</iden:xRoadInstance>
<iden:memberClass>GOV</iden:memberClass>
<iden:memberCode>70008440</iden:memberCode>
<iden:subsystemCode>rr</iden:subsystemCode>
<iden:serviceCode>RR458isikuTDkontroll</iden:serviceCode>
<iden:serviceVersion>v2</iden:serviceVersion>
</xro:service>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<prod:RR458isikuTDkontroll xmlns:ns2="http://rr.x-road.eu/producer">
<request>
<Isikukood>39703030012</Isikukood>
<pohjus>pohjus</pohjus>
</request>
</prod:RR458isikuTDkontroll>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>'astuse näide
NÄIDE SISENDPARAMEETRID
Sisendparameeter Kohustuslikkus Lisainfo
Isikukood Kohustuslik Isiku isikukood
Pohjus Mittekohustuslik Päringu põhjus (kui see väli on täidetud, siis see kuvatakse andmejälgijas - Andmejälgija | RIA.)
Päringu vastuse näide
Üks või rohkem näiteid päringu vastuse sisust (xml)
NÄIDE VASTUS XML
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xrd="http
://x-road.eu/xsd/xroad.xsd" xmlns:prod="http://rr.x-road.eu/producer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:id="http://x-road.eu
/xsd/identifiers" xmlns:repr="http://x-road.eu/xsd/representation.xsd" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<xrd:client id:objectType="SUBSYSTEM">
<id:xRoadInstance>ee-dev</id:xRoadInstance>
<id:memberClass>GOV</id:memberClass>
<id:memberCode>70008440</id:memberCode>
<id:subsystemCode>viisaregister</id:subsystemCode>
</xrd:client>
<xrd:service id:objectType="SERVICE">
<id:xRoadInstance>ee-dev</id:xRoadInstance>
<id:memberClass>GOV</id:memberClass>
<id:memberCode>70008440</id:memberCode>
<id:subsystemCode>rr</id:subsystemCode>
<id:serviceCode>RR458isikuTDkontroll</id:serviceCode>
<id:serviceVersion>v2</id:serviceVersion>
</xrd:service>
<xrd:issue>elukohateate testimine</xrd:issue>
<xrd:userId>EE47905250367</xrd:userId>
<xrd:id>11ea521824f8c942c706238e71e39692d5f0190b</xrd:id>
<xrd:protocolVersion>4.0</xrd:protocolVersion>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<prod:RR458isikuTDkontrollResponse>
<request>
<isikukood>37704020965</isikukood>
<!--Optional:-->
<pohjus>1</pohjus>
</request>
<response>
<dokumendid>
<dokument>
<nimetus>ELAMISLUBA</nimetus>
<number>1009889467/TE</number>
<asutus>POLITSEI- JA PIIRIVALVEAMET</asutus>
<valjaKpv>22.04.2020</valjaKpv>
<kehtibKuni>22.04.2025</kehtibKuni>
<staatus>KEHTIV</staatus>
<isikukood>37704020965</isikukood>
<perenimi>TEHIKJK</perenimi>
<eesnimi>JUKU</eesnimi>
</dokument>
<dokument>
<nimetus>ELAMISÕIGUS</nimetus>
<number>1009930329/TO</number>
<asutus>POLITSEI- JA PIIRIVALVEAMET</asutus>
<valjaKpv>05.01.2023</valjaKpv>
<kehtibKuni>04.01.2028</kehtibKuni>
<staatus>KEHTIV</staatus>
<valjastamiseAlus>TA01</valjastamiseAlus>
<valjastamiseAluseTekst>ELKS § 22 lg 1 TO pereliikmele</valjastamiseAluseTekst>
<isikukood>37704020965</isikukood>
<perenimi>TEHIKJK</perenimi>
<eesnimi>JUKU</eesnimi>
</dokument>
<dokument>
<nimetus>ELAMISLOAKAART</nimetus>
<number>BD2002024</number>
<asutus>POLITSEI- JA PIIRIVALVEAMET</asutus>
<valjaKpv>14.05.2020</valjaKpv>
<kehtibKuni>11.12.2020</kehtibKuni>
<staatus>KEHTETU</staatus>
<isikukood>37704020965</isikukood>
<perenimi>TEHIKJK</perenimi>
<eesnimi>JUKU</eesnimi>
</dokument>
</dokumendid>
</response>
</prod:RR458isikuTDkontrollResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
NÄIDE VÄLJUNDPARAMEETRID
Väljund Andmetüüp Tingimus, kirjeldus
Dokument Dokument andmete plokk.
dokument.nimetus Tekst RRis dokumendi liigi nimetus.
dokument.number Tekst Dokumendi number, kui puudub, siis väärtus tühi.
dokument.seeria Tekst Dokumendi seeria, kui puudub, siis väärtus tühi.
Päringu väljundi vastavus päriva registri X mooduli andmetabelite
väärtustega
NÄIDE
RR458 RR458 Kommentaar DM tabel DM andmeväli DM andme Kohustu
Väljund Andmetüüp tüüp slik
nimetus Tekst Dokumendi nimetus RR, võimalikud väärtused vaata RR458 teenus cl . DOCUMENT_TYPE_ VARCHAR2 EI
assifer DO_LIIK DOCUME CL_ID (18)
NT
number Tekst Dokumendi number . DOCUMENT_NUMB VARCHAR2 EI
DOCUME ER (256)
NT
Seotud klassifikaatorid
Todo
Sihtregistri veakoodid - kui päringule ei saadud vastust
NÄIDE
Väärtus Kirjeldus
10001 Isikukoodi pikkus ei ole 11 sümbolit.
10002 Isikukoodis ei ole kõik sümbolid numbrid.
10022 Kohustuslikud sisendparameetrid puuduvad.
L134 Päringu registreerimine ei õnnestunud.
L120 Kohustuslikud sisendparameetrid &1 puuduvad.
Sihtregistri klassifikaatorid - mille vastu töötluses enda poolel teeme kvaliteedikontrolli
NÄIDE
Väärtus Väärtuse kirjeldus FormOfStudy enumi kood
E Eksternõpe EKSTERNOPE
MS Mittestatsionaarne MITTESTATS_OPE
S Statsionaarne õpe STATS_OPE
K Kaugõpe KAUGOPE
Kasutuslood
TODO - Ehk ei ole vaja?
Andmetöötlus
TODO
Kirjeldada üldiselt päringuvastuse töötlemise üldised põhimõtted ja detailselt kõigi väärtuste töötlemise reeglid koos võimalike vea väärtustega
Töötluse kirjeldusest peab olema aru saada:
Milliseid kontrolle rakendatakse
Millised andmed millisel juhul ja kuhu maha kirjutatakse (moodul, tabel, veerud)
Milliseid andmeid millisel juhul maha ei kirjutada - > veateated + veahaldus
Veahaldus
TODO
Päringu vead - kui väljaminev päring on õnnestunud, aga vastuvõtja ei saanud päringut töödeldud mingi vea tõttu päringus.
NÄIDE
Veakood Selgitus Veateade ametnikurakenduses Töötluse tulemus
RR458_IS_DOK_ISI "response": { Päring ebaõnnestus - Päring ebaõnnestus sisend andmed ei olnud
KUKOOD_VIGA1 "faultCode": "10001", RR458_IS_DOK_ISIKUKOOD_VIGA1 -"Isikukoodi pikkus piisavad, teenusest andmeid ei edastatud
"faultString": "Isikukoodi ei ole 11 sümbolit."
pikkus ei ole 11 sümbolit." Teavita SKA Tugi.
}
Viga tekib kui RR458 teenus
tagastab vea.
RR458_IS_DOK_ISI "response": { Päring ebaõnnestus - Päring ebaõnnestus sisend andmed ei olnud
KUKOOD_VIGA2 "faultCode": "10002", RR458_IS_DOK_ISIKUKOOD_VIGA2 -"Isikukoodis ei ole piisavad, teenusest andmeid ei edastatud
"faultString": "Isikukoodis ei kõik sümbolid numbrid."
ole kõik sümbolid numbrid." Teavita SKA Tugi.
}
Viga tekib kui RR458 teenus
tagastab vea.
Andmekvaliteedi vead - kui päringuvastuse töötlemisel ilmnevad saadud andmetes vead.
NÄIDE
Veakood Selgitus Veateade ametnikurakenduses Töötluse
tulemus
RR458_IS_DOK_NIMETUS_ <nimetus>ELAMISLUBA</nimetus> Andmetöötluse viga RR458_IS_DOK_NIMETUS_TYHI - dokumendil pu Dokumenti ei
TYHI udub elemendi kood. Saadud dokumenti ei salvestatud! Teavita SKA salvestata
Viga tekib juhul, kui XML-is dokument. Tugi.
nimetus on tühi.
RR458_IS_DOK_NIMETUS_ <nimetus>ELAMISLUBA</nimetus> Andmetöötluse viga RR458_IS_DOK_NIMETUS_VALE - Isiku Dokumenti ei
VALE dokumentide töötlemisel ei leitud SKAIS2 klassifikaatori tunnust salvestata
Viga tekib juhul, kui dokumendi dokumendi [nimetus] . Saadud dokumenti ei salvestatud! Teavita SKA Tugi.
liigi väärtus ei leita klasifikaatorite hulgast.
Monitooring
Ärivajadustest lähtuv monitooring
Vastavalt ärivajadustele monitooring, s.t. kirjeldada kuidas veahalduses välja tulevaid probleeme jälgida ja rakendusest väljapoole näidata.
TODO üldisem mudel äriloogiliste vigade monitoorimiseks ja haldamiseks.
Tehniline monitooring
Minimaalne tehniline monitooring iga päringu kohta:
Päringute hulk (kokku/ajaühikus)
Päringute kestus
Päringute tulemuste counter (OK vs veaolukord), TODO vajab eestikeelset sõna siia
Teenuse otspunkti hetkeseis (töötab vs maas)
Lisaks on iga päringu korral arendaja vastutus mõelda loodava teenuse spetsiifiliste monitoorimist vajavate näitajate peale tagamaks teenuse hea
jälgitavus ja probleemide ennetamine.