E-pakalpojuma izmitināšana

Līdz šī gada maijam Latvija.gov.lv portālam notiks jaunas versijas ieviešana, kas attieksies arī uz pakalpojumiem, kas veidoti uz Latvija.gov.lv e-pakalpojumu platformas. Jaunās versijas dizaina risinājums, balstoties uz lietojamības testu rezultātiem un nozares labo praksi, uzlabos piekļūstamību atbilstoši WCAG standartam un vienkāršos portāla navigāciju, lai nodrošinot  vienotu un ērtu lietotāja pieredzi portālā.

VDAA vērš uzmanību, ka esošo e‑pakalpojumu pieejamība un darbība netiks pārtraukta. Vienlaikus iestādēm būs jāpārskata un jāpielāgo savus e‑pakalpojumus, lai tie atbilstu jaunajam dizaina ietvaram un spēkā esošajām vadlīnijām, tostarp lietojamības un piekļūstamības prasībām.

Ņemot vērā, ka pašreizējais (oranžais) dizains būs pieejams līdz 2027. gada 30. jūnijam un pēc tam tas vairs netiks atbalstīts, aicinām iestādes savlaicīgi plānot nepieciešamos resursus un darbus, lai nodrošinātu e-pakalpojumu pielāgošanu jaunajam dizainam plānveidīgi un bez ietekmes uz pakalpojumu nepārtrauktību. Papildu informācija un metodiskie materiāli tiks nodrošināti pakāpeniski.

Lietotājiem ar piekļuvi portāla testa videi jau ir pieejami jaunie e-pakalpojumu piemēri un dizaina Storybook, nodrošinot iespēju iepazīties ar paredzētajām izmaiņām:

1. e-pakalpojumu piemēri SPA un MPA tehnoloģijām: https://portal-test.vraa.gov.lv/Search/?sp=mvcdev%20reactdev

2. HTML Storybook, kas tiek izmantots par pamatu MPA e-pakalpojumiem: https://eservices-test.vraa.gov.lv/EservicePlatform.Controls.Html.Full.Dev/?path=/story/atoms-colors--brand-colors

3. HTML Storybook, kas tiek izmantots par pamatu SPA e-pakalpojumiem: https://eservices-test.vraa.gov.lv/EservicePlatform.Controls.React.Full.Dev/?path=/story/atoms-colors--brand-colors

4. Mvc bibliotēkas, kas tiek izmantota MPA e-pakalpojumos Helpers: https://eservices-test.vraa.gov.lv/EservicePlatform.Controls.Mvc.Dev/doc/index.html

• Ievēro! - Pirms pakalpojuma digitalizēšanas iestāde iepazīstas un ievēro turpmākā sadarbības procedūrā:
  Lejupielādēt: E-pakalpojumu izveides baušļi

1. Pieteikšanās e-pakalpojuma izstrādei un e-pakalpojuma reģistrēšana ietver darbības, kuras nepieciešamas veikt, lai sagatavotos e-pakalpojuma izstrādes un ieviešanas procesa sākšanai.

2. E-pakalpojuma ieviešanas process ietver norādes par nepieciešamajiem resursiem un kārtību, kādā tiek veikta e-pakalpojuma un tā darbību nodrošinošo tīmekļa pakalpju izstrāde un nodotas piegādes Aģentūrai.

3. Akcepttestēšana ietver akcepttestēšanas procesa darbības, kuras nepieciešamas veikt, lai būtu iespējams e-pakalpojumu un tā darbību nodrošinošās tīmekļa pakalpes ieviest produkcijas vidē.

4. E-pakalpojuma uzstādīšana un darbināšana produkcijas vidē apraksta kārtību, kādā tiek apstripināta  e-pakalpojuma vai e-pakalpojuma izmaiņu uzstādīšana produkcijas vidē.

5. Visa procesa laikā ir pieejams VDAA konsultatīvais atbalsts iestādēm un izstrādātājiem, rakstot uz e-pastu atbalsts@vdaa.gov.lv.

! Jauna e‑pakalpojuma izstrādē vai būtiskā pilnveidē jāizmanto jaunais dizains

Aicinām iestādes, kas uzsāk jauna e‑pakalpojuma izstrādi vai veic būtisku esošā pakalpojuma pilnveidi, turpmāk izmantot jauno vienoto dizainu.

Pašlaik jaunais dizains atrodas testēšanas fāzē un tā izmantošanai nepieciešama individuāla piekļuve, kas iestādei jāpieprasa VDAA.
Lai saņemtu piekļuves:

• izejas koda piemēriem un veidnēm ar jauno dizainu,
• repozitorijam ar nepieciešamajām bibliotēkām jauno e‑pakalpojumu izstrādei,

lūdzam rakstīt uz atbalsts@vdaa.gov.lv, tēmā norādot "Piekļuves e-pakalpojumu jaunajam dizainam".
Atbildīgā VDAA kontaktpersona nodrošinās visu nepieciešamo informāciju un tehniskos resursus.

Vienlaikus atgādinām, ka arī esošo e-pakalpojumu pārstrāde uz jauno dizainu ir savlaicīgi jāieplāno. Pašreizējais (oranžais) dizains būs pieejams līdz 30.06.2027., pēc tam tas vairs netiks atbalstīts.

1. Iestāde izvērtēja sniegto pakalpojumu atbilstoši "Valsts pārvaldes e-pakalpojumu noteikumiem", pieņēma lēmumu elektronizēt pakalpojumu un veic izpēti, lai gūtu priekšstatu par e-pakalpojumu izstrādes un izvietošanas iespējām, izmantojot VDAA infrastruktūru.

   Iedzīvotājiem un uzņēmējiem paredzētus e-pakalpojumus izvieto portālā Latvija.gov.lv.

2. Iestāde, kas vēlas veikt e-pakalpojuma izmitināšanu portālā Latvija.gov.lv, aizpilda e-pakalpojumu reģistrācijas veidlapu norādot visu nepieciešamo informāciju par e-pakalpojumu, un nosūta to Aģentūrai elektroniskā dokumenta veidā uz e-adresi.

   Svarīgi! Vēstulei jābūt parakstītai ar drošo elektronisko parakstu ar laika zīmogu.

3. Aģentūra, pamatojoties uz saņemto pieteikuma veidlapu, reģistrē e-pakalpojumu, piešķirot tam identifikatoru, sniedz iestādei informāciju par e-pakalpojuma identifikatoru un e-pakalpojuma ieviešanas kontaktpersonu no Aģentūras puses.

4. Iestāde aizpilda veidlapu par tiesību pieprasīšanu iestādes e-pakalpojuma izstrādātājiem, kā arī darbiniekiem, kas veiks e-pakalpojuma testēšanu, kā arī API Pārvaldnieka veidlapu API publicēšanai un nosūta abas veidlapas Aģentūrai elektroniskā dokumenta veidā uz e-adresi. 

   Svarīgi! Vēstulei ir jābūt parakstītai ar drošo elektronisko parakstu ar laika zīmogu.

5. Aģentūra nodrošina piekļuves tiesību piešķiršanu, pamatojoties uz pieteikuma veidlapās norādīto informāciju.

1. E-pakalpojumu vadlīniju izpēte. Izstrādātāji un iestāde veic vadlīniju izpēti, lai izveidotu e-pakalpojumu, kas atbilst gan norādītajām veiktspējas, gan arī lietojamības un piekļūstamības prasībām.

   Saistošā dokumentācija e-pakalpojumu izstrādei:

   • E-pakalpojumu arhitektūras izstrādes vadlīnijas
   • E-pakalpojumu vizuālā izskata ievērošanas vadlīnijas
   • E-pakalpojuma izveidošanas ceļvedis Latvija.lv portālam
   • API aprakstīšanas un publicēšanas vadlīnijas

2. API Pārvaldniekā pieejamo tīmekļa pakalpju izpēte. Iestāde kopā ar izstrādātāju izvērtē API Izstrādātāju portālā jau pieejamās tīmekļa pakalpes. Gadījumā, ja kādu no tīmekļa pakalpēm nepieciešams izmantot e-pakalpojuma izpildē, iestāde sazinās ar tīmekļa pakalpes pārzini par tīmekļa pakalpes izmantošanu e-pakalpojumā.

3. E-pakalpojuma izstrādes veikšana. Izstrādātāji atbilstoši vadlīnijām izstrādā e-pakalpojumu un tā darbību nodrošinošās tīmekļa pakalpes. Izstrādes procesā iespējams izmantot pieejamās rokasgrāmatas un programmatūru (sk.punktu 1.)

4. E-pakalpojuma nodevuma piegāde. Izstrādātāji veic e-pakalpojuma piegādi, piegāžu kārtību saskaņojot ar Aģentūru, nosūtot e-pastu uz piegades@vdaa.gov.lv. Pirmajā piegādē jābūt iekļautam arī aizpildītam e-pakalpojuma apraksta šablonam, lai Aģentūra veiktu e-pakalpojuma izpildes reģistrēšanu VISS e-pakalpojumu katalogā.

   Reģistrē izstrādātos API Publicētāju testa vides portālā.

5. E-pakalpojuma nodevuma piegādes uzstādīšana testa vidē. Aģentūra 10 darbdienu laikā veic piegādes uzstādīšanu testa vidē un no e-pasta piegades@vdaa.gov.lv informē par to iestādi un izstrādātājus.

6. Uzstādītā nodevuma testēšana testa vidē. Iestāde un izstrādātāji veic e-pakalpojuma testēšanu. Neatbilstību gadījumā atgriežas uz 3. soli, lai veiktu labojumus.

   Nepieciešamības gadījumā e-pakalpojuma testēšanā var iesaistīties Aģentūras e-pakalpojuma ieviešanas kontaktpersona, par to iestādes pārstāvjiem vienojoties ar Aģentūras kontaktpersonu.

   E-pakalpojuma darbināšanas nodrošināšanai izstrādātās tīmekļa pakalpes Aģentūra papildus rekomendē testēt arī ārpus e-pakalpojuma izpildes vides, lai pārliecinātos par to pozitīvajiem un negatīvajiem testēšanas scenārijiem, kā arī veiktspēju. 

1. Akcepttestēšanas veikšana. Ja e-pakalpojuma testēšana ir veiksmīga un nav nepieciešami labojumi, var organizēt e-pakalpojuma uzstādīšanu produkcijas vidē. Pirms uzstādīšanas produkcijas vidē ir nepieciešams veikt akcepttestēšanu, vairākkārt izpildot gan pozitīvos, gan negatīvos scenārijus. Pēc akcepttestēšanas veikšanas iestāde informē Aģentūru par laika periodu, kurā veikta akcepttestēšana. Saņemot informāciju no iestādes, Aģentūra sagatavo pārskatu par e-pakalpojuma atbilstību vadlīnijām, pārskata paraugs ir pieejams šeit.

2. Auditpierakstu sagatavošana. Aģentūras atbildīgā kontaktpersona sagatavo auditpierakstus par iestādes norādīto laika periodu.Iestāde tiek informēta par rezultātu. Ja akcepttestēšanas dati atbilst VISS vadlīniju prasībām un E-pakalpojumu akceptēšanas nosacījumiem, Aģentūra gatavo akcepttestēšanas aktu (solis 3.), savukārt, ja ir nepieciešams uzlabot rādītājus, Aģentūra informē iestādi par nepieciešamību veikt labojumus (solis 4.).

3. Akcepttestēšanas akta izveidošana. Aģentūra sagatavo akcepttestēšanas aktu, kas apstiprina, ka e-pakalpojumu var uzstādīt produkcijas vidē.

4. Organizē nepieciešamo labojumu veikšanu. Ja akcepttestēšanā secināts, ka e-pakalpojums neatbilst VISS vadlīnijām, izstrādātāji veic nepieciešamos labojumus un piegādā programmatūras labojumus.

5. E-pakalpojuma demonstrācija Aģentūras atbalsta dienesta darbiniekiem. Lai Aģentūras atbalsta dienests e-pakalpojuma ekspluatācijas laikā varētu nodrošināt e-pakalpojuma izmantotājiem pilnvērtīgu 1. līmeņa atbalstu, pirms e-pakalpojuma ieviešanas produkcijas vidē tiek organizēta e-pakalpojuma darbības demonstrācija, kā arī tiek sniegts ieskats ar e-pakalpojumu saistītajos biznesa jautājumos un procesos. E-pakalpojuma darbību testa vidē Aģentūras atbalsta dienesta darbiniekiem demonstrē iestādes pārstāvis, par demonstrācijas laiku pirms tam vienojoties ar Aģentūras e-pakalpojuma ieviešanas kontaktpersonu.

   Ja demonstrācijas laikā tiek konstatētas tehniskās vai vizuālās neatbilstības VISS vadlīnijām, iestādei nepieciešams veikt labojumus. 

6. Akcepttestēšanas akta saskaņošana. Iestāde un Aģentūras kontaktpersonas savstarpēji e-pastos saskaņo sagatavoto akcepttestēšanas aktu un organizē tā abpusēju parakstīšanu.

1. Tīmekļa pakalpju piekļuves tiesību pieprasījums produkcijas vidē. Gadījumā, ja iestāde e-pakalpojumā izmanto citas iestādes API (tīmekļa pakalpi/es), iestādei jāsazinās ar tīmekļa pakalpes pārzini, lai pieprasītu piekļuves tiesības produkcijas vidē. Pēc tīmekļa pakalpes pārziņa pieprasījuma Aģentūra atver piekļuvi produkcijas vidē.

2. Pieprasījums par e-pakalpojuma uzstādīšanu produkcijas vidē. Pēc akcepttestēšanas akta parakstīšanas, iestāde uz e-pastu piegades@vdaa.gov.lv un Aģentūras e-pakalpojuma ieviešanas kontaktpersonai nosūta pieprasījumu par e-pakalpojuma uzstādīšanu produkcijas vidē. Nepieciešams norādīt pilnu e-pakalpojuma nodevumu, kuru jāuzstāda un kurā iekļauts: 

   • e-pakalpojuma pirmkods un izpildkods;

   • e-pakalpojuma instrukcija, apraksts un noteikumi;

   • e-pakalpojuma un tā saturošo tīmekļa pakalpju, ja tās izveidotas e-pakalpojuma ietvaros, tehniskā dokumentācija (programmatūras prasību specifikācija, programmatūras projektējuma apraksts).

   Līdz e-pakalpojuma darbināšanas ekspluatācijā uzsākšanai iestādei ir jāizveido arī atbilstošu pakalpojuma aprakstu VIRSIS.

3. E-pakalpojuma uzstādīšana produkcijas vidē. Pēc akcepttestēšanas akta parakstīšanas un iestādes pārstāvja pieprasījuma par e-pakalpojuma uzstādīšanu produkcijas vidē saņemšanas 10 darbadienu laikā tiek veikta e-pakalpojuma uzstādīšana produkcijas vidē.

4. Pārbaude produkcijas vidē. Iestādes darbinieki pārbauda, vai e-pakalpojuma darbība produkcijas vidē ir korekta.

5. E-pakalpojuma darbināšana un uzturēšana produkcijas vidē. E-pakalpojums tiek darbināts produkcijas režīmā. Procesa ietvaros tiek sniegts konsultatīvais atbalsts e-pakalpojuma pārzinim (iestādei), kā arī e-pakalpojuma izmantotājiem.

   5.1. E-pakalpojuma uzturēšana produkcijas režīmā - par e-pakalpojumu atbildīgajai iestādei ir pienākums sekot līdzi aktuālākajai pieejamai e-pakalpojuma veidnes versijai, un regulāri (vismaz reizi gadā) nodrošināt savā pārziņā produkcijas vidē esošo e-pakalpojumu migrāciju uz jaunāko veidnes versiju.

   5.2. Ja Aģentūra, veicot pārbaudes, konstatē, ka e-pakalpojums izmanto veidni, kurai ir starpība ar aktuālo (aktuālā veidne ir tā, kurai ir augstāks numurs un par kuru ir publicēta Migrācijas instrukcija attiecīgajā mapē) veidnes versiju pārsniedz 18 mēnešus, tad Aģentūrai pieņem lēmumu par e-pakalpojuma atpublicēšanu, informējot par to iestādi, līdz iestāde veic e-pakalpojuma atjaunošanu.

Risinājuma vide tiek būvēta balstoties uz konteinerizācijas (docker) principiem, izmantojot kubernetes orķestrācijas platformu. E-pakalpojumu platformas risinājumu var iedalīt četrās daļās:

1. Publiskā zona (epak-public) jeb e-pakalpojumu grafiskās saskarnes un to apkalpojošais slānis, kurā e-pakalpojumi var tikt veidoti kā viens vai atsevišķi konteineri. E-pakalpojumu front-end veidošanai tiks nodrošinātas ReactJS (priekš single page application e-pakalpojumiem) un MVC .NET core (priekš multiple page application e-pakalpojumiem) dizaina kontroļu bibliotēkas. Komponentes, to attēlošanas piemērs un to izmantošana tiks aprakstīti izmantojot story bok (https://storybook.js.org/) funkcionalitāti.

2. Sistēmas zona, kura e-pakalpojumu izstrādātājiem jāizmanto, lai realizētu saziņu ar VISS infrastruktūru. Tajā atradīsies arī kopīgs autorizācijas serviss, kā arī tiks eksponēti kopējie CDN resursi.

3. Iekšējā zona, kurā atradīsies e-pakalpojumu platformas API – REST servisi, kas nodrošinās pieeju pie esošajām VISS infrastruktūras Koplietošanas komponentēm.

4. VISS & LVP infrastruktūras servisi - tiešā veidā e-pakalpojumos nav paredzēts izmantot.