Leping

TEHIK SKAIS2 ja SKAIS1 vaheline liides Töötukassa andmevahetuse jaoks [Document subtitle] Anti Urm 9.10.2017 Ajalugu Kuupäev Muutja Kommentaar 09.10.2017 Anti Urm Dokumendi loomine 11.10.2017 Anti Urm Lisatud Töötukassa jaoks andmete väljavõtu tingimused 20.10.2017 Anti Urm SKAIS1 baasiprotseduuride sisend- ja väljundparameetrite täpsustused 23.10.2017 Anti Urm Mittefunktsionaalsete nõuetesse lisatud Masspäringu käivituse sageduse nõude 07.12.2017 Anti Urm Tabeli SKAIS1_SKAIS2_TK kasutusele võtmine ning sellega seotud tööprotsessi muudatused. 09.03.2017 Anti Urm SKAIS1 tabelisse SKAIS1_SKAIS2_TK lisandus 4 (vastus9...vastus12) vastuse välja juurde. SKAIS1 poolt koostatud XML vastus ei mahtunud 8 välja sisse ära, selle tõttu tuli välju juurde tekitada. Muudatused punase tekstiga 1 Dokumendi eesmärk Dokument kirjeldab SKAIS1 ja SKAIS2 vahelist andmevahetuse liidest. 2 Lühendid SKA Sotsiaalkindlustusamet TK Töötukassa TVT Töötukassa töövõimetoetus 3 Sissejuhatus TK vajab SKA-st töövõimetuste, puude ning pensionide, hüvitiste ja toetuste andmeid. TK vajab andmeid kahel erineval kujul:  Masspäring – päritakse andmeid korraga mitme isiku kohta (~60 000 isikut korraga)  Üksikpäring – päritakse andmeid ühe isiku kohta SKAIS2 infosüsteemi arendatakse TK jaoks vastavad X-tee andmevahetuse teenused. Kuna SKAIS2 ei sisalda kõiki vajalikke andmeid, siis on vaja SKAIS1st pärida täiendavaid andmeid. 4 Üksik- ja Masspärigu andmestiku jagunemine infosüsteemides Nr Andmestik Infosüsteem 1. Toovoimetus SKAIS1 2. Hyvitised SKAIS1 2.1. hyvitisedRahalised SKAIS1 2.2. Valjamaksed SKAIS1 3. valismaaPensionid SKAIS1 4. Puuded SKAIS2 5 Tehnilise lahenduse kirjeldus deployment Deployment Model «device» «device» SKAIS2 rak TKIS Components:: XteeProv ider Components:: TKIS klient tkToovoimPuueHyvitised tkToovoimPuueHyvitisedMassTeenusVastus tkToovoimPuueHyvitisedMassTeenus (from Serverid) (from Serverid) «device» SKAIS1 DB «use» «use» «device» Components:: SKAIS2 DB TK_Hyv _Pue_Yks DB-Link Components:: Üksikpäring «use» Components:: Masspäring (sünonüüm) (sünonüüm) SKAIS1_SKAIS2_TK DB-Link DB-Link «use» «column» «use» ID: NUMBER(18) PARING: NUMBER(18) ISIKUKOOD: VARCHAR2(20 CHAR) (from Serverid) VASTUS1: VARCHAR2(4000 CHAR) VASTUS2: VARCHAR2(4000 CHAR) VASTUS3: VARCHAR2(4000 CHAR) DB-Link VASTUS4: VARCHAR2(4000 CHAR) VASTUS5: VARCHAR2(4000 CHAR) «use» VASTUS6: VARCHAR2(4000 CHAR) VASTUS7: VARCHAR2(4000 CHAR) VASTUS8: VARCHAR2(4000 CHAR) Components:: TK_Hyv _Pue_Mass (from Serverid) SKAIS2 infosüsteemi luuakse kolm X-tee andmevahetuse teenust, mis hakkavad teenindama Üksik- ja Masspäringuid. SKAIS1 andmebaasi luuakse andmevahetuse jaoks kaks andmebaasi protseduuri üksik- ja masspäringu jaoks ning andmebaasi vahetabel. SKAI2 pöördub SKAIS1 andmebaasi protseduuride ja vahetabeli poole DB-Link protokolli vahendusel. Infovoog üksikpäringu korral: 1. Töötukassa esitab päringu SKAIS2.tkToovoimPuueHyvitised X-tee teenusele 2. SKAIS2 adapterserver: 2.1. Salvestab SKAIS1_SKAIS2_TK vahetabelisse otsitava isikukoodi ja päringu sessiooni tunnuse. 2.2. käivitab SKAIS1 üksikpäring protseduuri (TK_Hyv_Pue_Yks) 2.2.1.SKAIS1 andmebaasis kogutakse TK poolt küsitud andmed 2.2.2.Üksikpäringu protseduur salvestab vastuse SKAIS1_SKAIS2_TK tabelisse 2.2.3.SKAIS1 üksikpäringu protseduur teavitab oma töö lõppemisest 2.3. SKAIS1_SKAIS2_TK tabelist loetakse SKAIS1 andmed 3. SKAIS2 adapterserver kogub SKAIS2 andmebaasist TK poolt küsitud andmed 4. SKAIS2 adapterserver liidab SKAIS1 ja SKAIS2 andmebaasidest saadud andmed 5. SKAIS2 adapterserver väljastab TK-le andmed. Infovoog masspäringu korral: 1. Töötukassa esitab päringu SKAIS2.tkToovoimHyvitisedPuudedMass X-tee teenusele 2. SKAIS2 adapterserver väljastab TK-le sessiooni tunnuse. 3. SKAIS2 adapterserver: 3.1. Salvestab SKAIS1_SKAIS2_TK vahetabelisse otsitava isikukoodid ja päringu sessiooni tunnuse. 3.2. käivitab SKAIS1 masspäring protseduuri (TK_Hyv_Pue_Mass) 3.2.1.SKAIS1 andmebaasis kogutakse TK poolt küsitud andmed 3.2.2.Masspäringu protseduur salvestab vastused SKAIS1_SKAIS2_TK tabelisse 3.2.3.SKAIS1 masspäringu protseduur teavitab oma töö lõppemisest 3.3. SKAIS1_SKAIS2_TK tabelist loetakse SKAIS1 andmed 4. SKAIS2 adapterserver kogub SKAIS2 andmebaasist TK poolt küsitud andmed 5. SKAIS2 adapterserver liidab SKAIS1 ja SKAIS2 andmebaasidest saadud andmed 6. SKAIS2 adapterserver salvestab tulemuse andmebaasi koos sessiooni tunnusega 7. Töötukassa esitab päringu SKAIS2.tkHyvitisedPuudedMassTeenusVastus 8. SKAIS2 adapterserver proovib leida TK-st saadud sessiooni tunnusele vastavaid päringu andmeid andmebaasist. 9. SKAIS2 adapterserver väljastab TK-le andmed 5.1 SKAIS1 infosüsteemis SKAIS1_SKAIS2_TK tabeli reeglid 1. Mass ja üksikpäringu algatamisel salvestatakse otsitavate isikute isikukoodid SKAIS1_SKAIS2_TK tabelisse. Üksikpäringu korral tekib ainult üks isikukood. Masspäringu korral salvestatakse kõik päringu seisundis olnud isikute koodid eraldi kirjetena. Otsitavad isikukoodid salvestab tabelisse SKAIS2. 2. Erinevate päringute eristamiseks salvestatakse iga isikukoodiga koos ka päringu unikaalne tunnus (PARING). Päringu unikaalse tunnuse tekitab SKAIS2. 3. SKAIS1 protseduurid TK_Hyv_Pue_Mass ja TK_Hyv_Pue_Yksik loevad SKAIS1_SKAIS2_TK tabelist päringu tunnuse järgi isikukoodid, kelle kohta Töötukassa soovib informatsiooni saada ning otsib vajalikud andmed SKAIS1 andmebaasist. Informatsiooni otsitakse korraga ainult ühe isiku kohta. 4. Iga isiku kohta koostab SKAIS1 protseduur vastuse, mis on XML formaadis.  5. Tekkinud XML tükeldatakse 4000 tähemärgisteks stringideks SKAIS1 protseduuri poolt ning salvestatakse VASTUS1 ... VASTUS12 väljadele. 5.2 SKAIS1 andmebaasi protseduur üksikpäringu jaoks (TK_Hyv_Pue_Yks) Päringu sisend: Parameetri nimetus Andmetüüp Päring NUMBER Perioodi alguse kuupäev Date Perioodi lõpu kuupäev Date Vastuse XML struktuur on kirjeldatud „tkToovoimPuueHyvitised.xsd“ dokumendis. Andmestik: Üksikpäring peab väljastama kõikide pensionite, toetuste ja hüvitiste andmed, mida SKA osutas küsitud perioodi vahemikus. 5.3 SKAIS1 andmebaasi protseduur masspäringu jaoks (TK_Hyv_Pue_Mass) Päringu sisend: Parameetri nimetus Andmetüüp Päring NUMBER Perioodi alguse kuupäev Date Perioodi lõpu kuupäev Date Vastuse XML struktuur on kirjeldatud „tkToovoimPuueHyvitisedMassTeenusVastus.xsd“ dokumendis Andmestik: Hüvitiste plokis väljastatakse ainult pensionide ja prokuröri töövõimetushüvitise andmed, mida SKA osutas küsitud perioodi vahemikus. Töövõimetuse ja puude plokis väljastatakse kõik andmed, mida SKA osutas küsitud perioodi vahemikus. 5.4 Tabeli SKAIS1_SKAIS2_TK kirjeldus Välja Andmetüüp Kohustuslik Kirjeldus nimetus ID NUMBER YES Andmebaasi rea unikaalne tunnus PARING NUMBER YES Mass või üksikpäringu unikaalne tunnus ISIKUKOOD VARCHAR2(20 CHAR) YES Otsitava isiku isikukood VASTUS1 VARCHAR2(4000 Mass või üksikpäringu vastus otsitava CHAR) isikukohta VASTUS2 VARCHAR2(4000 -„- CHAR) VASTUS3 VARCHAR2(4000 -„- CHAR) VASTUS4 VARCHAR2(4000 -„- CHAR)  VASTUS5 VARCHAR2(4000 -„- CHAR) VASTUS6 VARCHAR2(4000 -„- CHAR) VASTUS7 VARCHAR2(4000 -„- CHAR) VASTUS8 VARCHAR2(4000 -„- CHAR) VASTUS9 VARCHAR2(4000 -„- CHAR) VASTUS10 VARCHAR2(4000 -„- CHAR) VASTUS11 VARCHAR2(4000 -„- CHAR) VASTUS12 VARCHAR2(4000 -„- CHAR) 6 Mittefunktsionaalsed nõuded SKAIS1 Üksikpäring vastamiseaeg maksimaalselt 2sek Üksikpäringute arv päevas maksimaalselt 2000 Maksimaalne samaaegselt käivituvate Üksikpäringute arv 400 SKAIS2 Üksikpäringu vastamise aeg maksimaalselt 4sek Töötukassa käivitab Masspäringut üks kord kuus, orienteeruvalt kuu viimasel või uue kuu esimesel tööpäeval, enne Töötukassa oma toetuste väljamaksete teostamist. Masspäringus maksimaalne isikute arv 60 000 SKAIS2 Masspäringule vastamise aeg maksimaalselt 2h SKAIS1 Masspäringule vastamise aeg maksimaalselt 1,5h  HANKELEPING nr 3-9/836-1 Tervise ja Heaolu Infosüsteemide Keskus, registrikood 70009770, aadress Uus-Tatari 25/Veerenni 13, Tallinn, keda esindab põhimääruse alusel direktor Katrin Reinhold (edaspidi nimetatud „Tellija“ ) ja Tieto Estonia Aktsiaselts, registrikood 10137025, asukoht Tammsaare tee 47, 11316 Tallinn, keda esindab põhikirja alusel juhatuse liige Anneli Heinsoo (edaspidi nimetatud „Töövõtja“), edaspidi nimetatud eraldi „Pool“ või koos „Pooled“, sõlmisid raamlepingu nr 1.8-2/6370 alusel käesoleva hankelepingu (edaspidi nimetatud „Leping“) alljärgnevas. 1. Lepingu ese 1.1. Lepingu esemeks on Lisas 1 kirjeldatud tööd koos garantiiteenustega (edaspidi Töö). 1.2. Töö garantii algab vastavalt raamlepingu punktile 10.3. 2. Lepingu hind 2.1. Tellija kohustub tasuma Töö eest kokku 5742 (viis tuhat seitsesada nelikümmend kaks) eurot koos käibemaksuga. 2.2. Töövõtja esitab Tellijale arve pärast Töö üleandmise-vastuvõtmise akti mõlema Poole poolt allkirjastamist. 3. Töö üleandmise ja vastuvõtmise tingimused 3.1. Töövõtja annab Lisas 1 kirjeldatud Töö üle Lisas 1 sätestatud tingimustel 19.04.2018. 4. Autoriõigused 4.1. Töövõtja annab Tellijale üle Lepingu alusel loodud tarkvara osas autoriõigused vastavalt Raamlepingu punktile 8. 5. Poolte vahelised teated ja kontaktisikud 5.1. Teadete edastamine toimub üldjuhul telefoni, e-posti, faksi või posti teel. Juhul, kui teate edastamisel on olulised õiguslikud tagajärjed, peavad teisele poolele edastatavad teated olema edastatud kirjalikku taasesitamist võimaldavas vormis. Informatiivset teadet võib edastada ka telefoni teel. 5.2. Teate edastamise hetkeks loetakse faksi või elektronkirja tehniliselt tõendatud saatmise hetk või kirjaliku teate allkirjaga tõendatud vastuvõtmise hetk. 5.3. Tellija kontaktisikuteks Lepingu täitmisel on: 5.3.1. Martin Hunt, sotsiaalkaitse talituse juhataja, Tervise ja Heaolu Infosüsteemide Keskus, tel. +372 7943 979, e-post [email protected], 5.3.2. Anti Urm, tootejuht, Tervise ja Heaolu Infosüsteemide Keskus, tel 794 3803, e- post: [email protected], 5.4. Tellija volitatud esindajaks Töövõtjale vajaliku informatsiooni andmisel, Töö kvaliteedi kontrollimisel, Töö vastuvõtmisel ja Töö üleandmise-vastuvõtmise akti allkirjastamisel on: 5.4.1. Anti Urm, tootejuht, Tervise ja Heaolu Infosüsteemide Keskus, tel 794 3803, e- post: [email protected]. 5.5. Töövõtja kontaktisikuteks Lepingu täitmisel on: 5.5.1. Svetlana Netsunajeva, projektijuht, telefon: +372 538 97050, e-posti aadress: [email protected], 5.5.2. Vallo Hannus, telefon +372 534 24418, e-posti aadress: [email protected]. Vallo Hannus täidab Töövõtja kontaktisiku ülesandeid juhul, kui Svetlana Netsunajeva ei saa neid ülesandeid täita. 6. Lepingu kehtivus 6.1. Leping on koostatud eesti keeles ja allkirjastatud digitaalselt. 6.2. Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni poolte poolt oma Lepinguliste kohustuste täitmiseni. 7. Lõppsätted 7.1. Lepingu täitmisel tekkinud vaidlused ja lahkarvamused lahendavad pooled läbirääkimiste teel. Kokkuleppe mittesaavutamisel lahendatakse vaidlused Harju Maakohtus. 7.2. Lepingu täitmisel ja Lepingust tulenevate vaidluste lahendamisel lähtutakse Eesti Vabariigi õigusaktidest. 7.3. Pooled ei tohi Lepingust tulenevaid õigusi ja kohustusi üle anda kolmandatele isikutele ilma teise poole kirjaliku nõusolekuta. 7.4. Lepingu dokumendid koosnevad käesolevast Lepingust, Lepingu Lisadest ning Lepingu muudatustest, milles pooled võivad kokku leppida Lepingu allakirjutamise järgselt. 7.5. Lepingu lahutamatuteks osadeks Lepingu sõlmimise hetkel on järgmised dokumendid: 1) Lisa 1 Hankelepingu tööde kirjeldus; 2) Lisa 2 SKAIS1 ja SKAIS2 vahelise andmevahetuse liidese kirjeldus. 8. Poolte allkirjad: Tellija Töövõtja: Katrin Reinhold Anneli Heinsoo Direktor Juhatuse liige LISA 1 HANKELEPING nr 3-9/836-1 HANKELEPINGU TÖÖDE KIRJELDUS 1 Tööde kirjeldus Jr.nr Arendus- Arendustöö nimetus Arendustöö lühikirjeldus töö kood 1 BAC-52 Töötukassa päringu Tänane probleem: tähemärkide arvu Töötukassa mass- ja üksikpäringu testimise käigus suurendamine selgus, et SKAIS1s tekkiv XML suurus ületab SKAIS1 ja SKAIS2 vahelises andmevahetuse liideses lubatud tähemärkide arvu. Probleemi lahendamiseks on vaja teostada järgmist: 1.SKAIS1 tabelisse SKAIS1_SKAIS2_TK lisada juurde 4 (vastus9...vastus12) vastuse välja. 2.SKAIS1 mass- ja üksikpäringu protseduuridesse lisada ka eespool nimetatud väljade täitmine. 3.SKAIS2 mass- ja üksikpäringu protseduurid peavad eespool nimetatud väljade andmeid lugema ja töötlema. Realiseeritav lahendus SKAIS2: SKAIS2 Töötukassa mass- ja üksikpäringu protseduurid peavad SKAIS1 andmetabelite juurde lisatavate väljade andmeid lugema ja töötlema. Kirjeldus toodud lepingu lisas 2. 2 Töökorraldus 2.1 Projekti meeskond Projekti meeskonna moodustavad Tellija ja Töövõtja töötajad. Tagamaks Tellijale ülevaade loodavast süsteemist ja planeerimaks edasisi töid, korraldab Töövõtja jooksvalt dokumentatsiooni, prototüüpide ja valminud arenduste läbivaatust ning testimist koos Tellija töötajatega. 2.2 Analüüs Töövõtja viib läbi intervjuusid ja töökoosolekuid Tellija esindajatega ja andmevahetuspartnerite esindajatega analüüsi täpsustamiseks ning täiendavalt vajaliku informatsiooni ja andmestiku kogumiseks. Tellija vastab Töövõtja poolt tekkinud küsimustele ühe tööpäeva jooksul. Materjalide ja informatsiooni põhjal teostab Töövõtja analüüsi ja koostab andmemudeli ning tulemitele vastava dokumentatsiooni vastavalt punktile 2.6. Kasutajaliidese või teatud funktsionaalse osa kirjeldamisel loob vajadusel visuaalsed prototüübid. Kui analüüs vajab Tellija poolset kinnitamist, siis edastatakse see Lepingu punktis 5.3 nimetatud Tellija esindajatele. Tellija kinnitab analüüsi 3 (kolme) tööpäeva jooksul. 2.3 Arendus Arendustöö sisendiks on analüüsi käigus kinnitatud kasutuslood, loogiline ja tehniline andmemudel ja vajadusel neid illustreerivad prototüübid, mis antakse Tellijale üle koos loodud Tarkvaraga. 2.4 Testimine Samaaegselt arendamisega valmistab Töövõtja kasutuslugude baasil ette testlood kriitilisele funktsionaalsusele. Töövõtja annab valminud ja edukalt testitud Töö ning sellega kaasneva dokumentatsiooni üle Tellijale testimiseks ja vastuvõtmiseks. Töövõtja teavitab Lepingu punktis 5.3 nimetatud Tellija esindajaid hiljemalt 5 (viis) kalendripäeva enne Töö või selle vahetulemuse Tellijale üleandmist, et Töö on valmis Tellija ja kolmandate osapoolte testimiseks. Vastavalt Tööde projektiplaanile tagab Tellija vastava testimiskompetentsi olemasolu. Tellija viib vastuvõtutestimised läbi Tellija prelive keskkonnas, välja arvatud SKAIS2 poolt pakutavad andmevahetusteenused, mille vastuvõtutestimised toimuvad Tellija testkeskkonnas. Vastuvõtutestimise käigus testib Tellija tarnitud Töö kogu funktsionaalsust. Kõik testimiste tulemused fikseeritakse testiraportis. Tellija testimise juhendi ja testraporti malli koostab Töövõtja. Tellija vaatab Töö üle ja vajadusel esitab Töövõtjale kirjalikult oma pretensioonid seoses Töö mittevastavusega Lepingule 10 (kümne) tööpäeva jooksul pärast Töö üleandmist. Töövõtja peab tegema Töös parandused Poolte poolt kokkulepitud aja jooksul. Pooled panustavad ühiselt, et Lisa 1 punktis 1 kirjeldatud Tööd jõuavad üleandmise-vastuvõtmise akti allkirjastamiseni ning toodangusse. 2.5 Tulemite vastuvõtmine Punktis 2.6 nimetatud Tellija poolt vastu võetud tulemid fikseeritakse Tööde üleandmise- vastuvõtmise aktiga. Juhul, kui kolmandate osapoolte tegevuse või tegevusetuse tõttu ei ole võimalik Tööd Lepingus sätestatud tähtaegadel üle anda, kohustub Töövõtja Töö üle andma Poolte poolt kokkulepitud tähtajal. 2.6 Tulemid Töö käigus loodav lahendus (edaspidi ka Tulem) antakse üle koos täiendatud dokumentatsiooniga, mis vastab tehtud tööle ja tarkvaraarenduse heale tavale, jälgitavuse (traceability) põhimõttele ning mis sisaldab planeerimisel kokku lepitud tulemeid järgnevast loetelust: 1) detailanalüüs: a) muudatused kasutuslugudes, ärianalüüsi ja detailanalüüsi dokumentides; b) vastavalt lahenduse ulatusele uued ja täiendatud Enterprise Architecti mudelis: - kasutuslood; - nõuded; - olekudiagrammid; - tingimusmaatriksid; 2) rakenduse lähtekood, mis on testitud nii Töövõtja kui ka Tellija poolt (paigaldatud Tellija testkeskkonda); 3) tehniline spetsifikatsioon (antakse üle koos rakenduse lähtekoodiga): a) detailne füüsiline andmemudel; b) klassifikaatorite loetelud;  c) ülevaade teostatud muudatustest lähtekoodis, andmebaasi struktuuris, skriptides jt. süsteemi osades; 4) testimine: a) ärikriitiliste testlugude nimekiri; b) testimise aruanded; c) automaat-testide skriptid; 5) kasutusjuhendid: a) muudatused kasutusjuhendites ja administreerimisjuhendites. 3 Tööde ajakava Jrk Arendus- Arendustöö nimetus Tööde üleandmise nr töö kood tähtpäev 1 BAC-52 Töötukassa päringu tähemärkide arvu 19.04.2018 suurendamine 4 Tööde maksumus Töö jrk Töö nimi Maht Maksumus Maksumus nr (töötundides) (EUR km-ta) (EUR km-ga) Töötukassa päringu 1 tähemärkide arvu 87 4785 5742 suurendamine Ühe töötunni hind ilma käibemaksuta on 55 EUR. 5 Kaasatud Töövõtja spetsialistid Hankelepingu täitmiseks on kaasatud järgmised Töövõtja töötajad märgitud rollides: - projektijuht; - arendajad; - analüütikud; - testijad; - arhitekt. Lisaks kaasatakse vastavalt vajadusele teisi antud projektiga seotud Töövõtja töötajaid. 6 Tellija spetsialistid Hankelepingu täitmiseks on kaasatud järgmised Tellija töötajad märgitud rollides: - projektijuht; - teenuste haldur; - tarkvara arhitekt, - testijad. Lisaks kaasatakse vastavalt vajadusele teisi antud projektiga seotud Tellija töötajaid.