Valdibas-Deklaracija-as-Code/README.md

Valdības deklarācijas datukopa

Mašīnlasāma struktūra valdības deklarācijai un visam, kas no tās izriet: rīcības plānam, izpildes gaitai un saitēm ar tiesību aktiem. Viena datu kopa datu noliktavai, ko vienlīdz var lasīt cilvēks un MI aģents.

Autors: PPP Asociācija (PPPA), Country as Code. Shēmu versija 0.2, melnraksts.

Deklarācijas pamatdokuments ir XML datne atbilstoši shēmai; Word un PDF ir eksports no šiem datiem.

Datu modelis

Valdību reģistrs (valdibas.xml)          dimensijas: Valdība, Organizācija
        │
        ├── Deklarācija            lv-dekl-…            ← parakstītais teksts (1. līmenis), burtiski
        │     Sadaļa → Uzdevums (.uNNN) ← galvenā vienība
        │
        │
        └── Rīcības plāns          lv-mk-….rp           ← MK rīkojums; pasākumi .uNNN.pN (1–5 uz uzdevumu)
              Pasākums → Rezultāts (.dN) · Izpildes gaita (.zGGGGMMDD) · TA lieta · NAP kods

Tiesiskais pamats:

• Ministru kabineta iekārtas likuma 14. un 15. pants: deklarācijas saturs un rīcības plāns triju mēnešu laikā.
• Ministru kabineta kārtības rullis (MK noteikumi Nr. 606), 13.–26. punkts un pielikums: rīcības plāna ailes; ne vairāk kā pieci pasākumi uz uzdevumu; apstiprināšana ar MK rīkojumu; izpildes gaitas pārskati.

Deklarācijas formātu neviens normatīvais akts nenosaka. Kārtības rullis paredz tikai to, kas no deklarācijas izriet, un rīcības plāna pirmās trīs ailes ir pati deklarācija: sadaļa, uzdevuma numurs, uzdevuma teksts.

Saturs

Dati (data/) — autoritatīvās datnes

Datnes nosaukums ir objekta identifikators.

Datne	Saturs
data/lv-dekl-2026-05-28.xml	Deklarācija par Andra Kulberga vadītā Ministru kabineta iecerēto darbību (28.05.2026): viss teksts, 11 sadaļas, 52 uzdevumi
data/lv-dekl-2026-10-10.xml	Jaunas valdības deklarācijas projekts (status="draft"): PPPA Latvijas Nacionālā MI stratēģija pppa-mis-2026-09-10 — 3 pīlāri kā nodaļas, 5 mērķi kā apakšnodaļas, 27 rīcības kā uzdevumi u053–u079; no Kulberga deklarācijas pārņemti atbilstošie uzdevumi u015, u021, u039 (derivedFrom)
data/lv-mk-2026-05-28.rp.xml	Valdības rīcības plāns tās īstenošanai (MK rīkojums Nr. 449, 27.07.2026): 185 pasākumi 52 uzdevumiem, teksts burtiski no likumi.lv; atbildīgās institūcijas ar CaC ID
data/organizacijas.xml	Valsts institūciju reģistrs (CaC ID): 165 valsts budžeta iestādes un 16 citas institūcijas un grupas; uzturētājs — Valsts kanceleja
data/valdibas.xml	Valdību reģistrs: piecas valdības (2016–2026)
data/processgit.viewer.json	ProcessGit skatītāja manifests: atverot deklarāciju, rīcības plānu vai organizāciju reģistru ProcessGit, tie tiek attēloti redaktorā (editor/)

ProcessGit skatītājs ielādē skatīto datni no repozitorija un saistītās datnes no tās pašas mapes pēc identifikatora (deklarācija ↔ rīcības plāns ↔ organizāciju reģistrs). Pievienojot jaunu deklarāciju vai rīcības plānu, tās datnes nosaukums jāpievieno manifesta edit_allow sarakstam.

Shēmas (schemas/)

Datne	Saturs
schemas/valdibas-deklaracija-0.2.xsd	Deklarācija
schemas/valdibas-deklaracijas-ricibas-plans-0.2.xsd	Valdības deklarācijas rīcības plāns: pasākumi, rezultāti, atbildīgie, termiņi, izpildes gaita; katrs pasākums norāda deklarācijas uzdevumu
schemas/organizaciju-registrs-0.2.xsd	Organizāciju reģistrs: CaC ID (SS-IIII; ministrija — SS-0000), reģistrācijas numurs, nosaukums, saīsinājumi, augstākā institūcija
schemas/cac-valdiba-kopejie-0.2.xsd	Kopīgie tipi (identifikatori, datumi) un valdību reģistrs

Rīki, dokumentācija, avoti

Mape / datne	Saturs
docs/IDENTIFIKATORI.md	Identifikatoru veidošanas noteikumi
tools/validate.py	Pārbaude: XSD, datņu nosaukumi, identifikatori, saites starp datnēm, kārtības ruļļa 18. un 20. punkts, termiņi
tools/test_validate.py	Negatīvie testi pārbaudītājam
tools/projekts_no_mi_strategijas.py	Veido deklarācijas projektu no MI stratēģijas XML un pārņem atbilstošos avota deklarācijas uzdevumus
tools/ricibas_plans_no_likumi.py	Pārveido rīcības plānu no likumi.lv lapas uz XML un salīdzina plāna ailes 1–3 ar deklarāciju
tools/organizacijas_no_vdvc.py	Izveido organizāciju reģistru no VDVC reģistra un Valsts kases saraksta
tools/ids.py	Identifikatoru veidošana
editor/Valdibas_deklaracijas_datukopa.html	Redaktors vienā HTML datnē: valdības deklarācija (lasīšana, rediģēšana), rīcības plāns ar CaC ID, institūciju reģistrs, jaunas deklarācijas projekts, shēmas, apraksts; eksportē XML un Word
source/pdf/	Deklarācijas avota PDF
source/ricibas-plans/	MK rīkojuma Nr. 449 avoti: likumi.lv lapa (.mhtml) un PDF
source/organizacijas/	VDVC reģistrs un Valsts kases „Valsts budžeta iestāžu saraksts” (01.09.2023)
source/v0.1/	Iepriekšējā (v0.1) shēma un dati

Pārbaude

pip install lxml
python3 tools/validate.py            # data/
python3 tools/test_validate.py

Pārbaudītājs ziņo E (kļūda), W (brīdinājums), I (informācija). Pašreizējie dati: 0 kļūdas, 1 brīdinājums — 10 deklarācijas uzdevumiem rīcības plānā ir vairāk nekā pieci pasākumi (kārtības ruļļa 18. punkts).

Ko shēma nodrošina

• Uzdevumam ir divas paralēlas numerācijas: drukātais numurs (@number) un pastāvīgs identifikators (@id); jaunas deklarācijas projektā katrs uzdevums norāda avota uzdevumu (@derivedFrom).
• Katram elementam ir globāli unikāls identifikators, piemēram lv-dekl-2026-05-28.u012, lv-mk-2026-05-28.rp.u001.p3.
• Rīcības plāns ir salīdzināms arī tad, ja ailes atšķiras no pielikuma: Metadata/Column sasaista avota aili ar shēmas lauku.
• Izpildes gaita ir laika rinda: viens ieraksts katrā pārskata periodā, ar pierādījumu (dokumenta numurs un datums, TA lieta).
• Ārējie identifikatori ir saglabāti: TA lietas numurs, publikāciju sistēmas ID, NAP kodi.

Datu līgumi (ODCS)

contracts/*.odcs.yaml — datu līgumi pēc Open Data Contract Standard v3, ģenerēti no XSD (shēma līgumā = shēma, pret kuru dati tiek validēti). Līgumā: objekti un lauki ar tipiem, obligātumu, šabloniem un aprakstiem no XSD; kvalitātes noteikumi; atjaunošanas biežums; turētājs. Datu ezers (lakehouse.weget.cc, „Valsts kā kods”) katru dienu ielādē datus kopā ar līgumu un pārbauda tos pret līgumu.