B03 Valsts budžeta izpilde: mērķa shēma, avota un mērķa datu līgumi, pārveidošanas noteikumi

- schemas/valsts-budzeta-izpilde-0.1.xsd
- contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml (Valsts kases CSV)
- contracts/B03-valsts-budzeta-izpilde.odcs.yaml (ģenerēts no XSD)
- mappings/B03-izpilde.yaml, docs/IZPILDE.md; CHANGELOG 0.2.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016679RwmHsuTFfxt26wP6rk

docs/IZPILDE.md

@@ -0,0 +1,65 @@
+# Valsts budžeta izpilde (B03)
+
+Budžeta likums (B15) ir plāns. Izpilde ir fakts: cik katra iestāde katru mēnesi faktiski saņēmusi un izlietojusi pa programmām, apakšprogrammām un klasifikācijas kodiem. Šajā repozitorijā glabājas izpildes **definīcijas**; pašus datus publicē Valsts kase, un VDE tos ielādē no turienes.
+
+## Kas kur atrodas
+
+| Datne | Saturs |
+|---|---|
+| `schemas/valsts-budzeta-izpilde-0.1.xsd` | Mērķa shēma: izpildes fakti uz tiem pašiem identifikatoriem, kas budžeta likumā |
+| `contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml` | Avota līgums: ko VDE sagaida no Valsts kases CSV datnes (kolonnas, secība, kodi, pieļaujamās vērtības) |
+| `contracts/B03-valsts-budzeta-izpilde.odcs.yaml` | Mērķa līgums: pārveidotie izpildes fakti; ģenerēts no XSD |
+| `mappings/B03-izpilde.yaml` | Pārveidošanas noteikumi: avota kolonna → shēmas atribūts, vērtību vārdnīcas, identifikatora un sasaistes ar likumu noteikumi |
+
+Datu mapes izpildei nav. Autoritatīvā datu kopija ir Valsts kases publikācija; katru mēnesi atkārtoti glabāt 300 000+ rindu git repozitorijā nav jēgas.
+
+## Avots
+
+Valsts kase, datu kopa „Valsts budžeta izpilde pa iestādēm, budžeta programmām/apakšprogrammām un klasifikācijas kodiem” Latvijas Atvērto datu portālā (CC0). Viena CSV datne katram gadam; kārtējā gada datne tiek aizstāta katru mēnesi. Summas ir mēneša apjoms, nevis uzkrājums no gada sākuma. Datnē ir tikai izpilde — nav apstiprinātā un precizētā plāna.
+
+## Plūsma
+
+```
+data.gov.lv (Valsts kase, CSV)          ProcessGit Budget-as-Code (šis repozitorijs)
+        │                                  shēma · avota līgums · mērķa līgums · pārveidošanas noteikumi
+        ▼                                                      │
+VDE savienotājs (katru dienu 03:30 UTC) ◄──────────────────────┘ lasa tajā pašā commit
+  1. pārbauda, vai datne portālā mainījusies (ja nē — izlaiž)
+  2. avota līguma pārbaudes: kolonnas un secība, vērtības, atslēgas unikalitāte
+  3. Bronze: cac_bronze.vk_budget_execution — rindas, kā saņemtas
+  4. pārveidošana pēc mappings/B03-izpilde.yaml → BudgetExecution dokumenti (pa 20 000 ierakstiem), katrs pārbaudīts pret XSD
+  5. Silver: cac_silver.budget_execution — izpildes fakti ar likuma mērķi (purpose)
+  6. mērķa līguma pārbaudes: identifikatori unikāli, summas sakrīt ar avotu, resors zināms
+  7. Gold: plāns pret izpildi pa resoriem un apakšprogrammām; izpilde pa mēnešiem
+```
+
+## Sasaiste ar budžeta likumu
+
+Izpildes fakts saņem atribūtu `purpose`, ja tā paša gada likumā ir šī resora apakšprogramma (`lv-vb-GGGG.pr.RR.PP.AA.SS`) vai — ja nav — programma. Pretējā gadījumā `lawMatch="none"`: parasti tā ir programma vai apakšprogramma, kas izveidota gada laikā (piemēram, finansējums no 74. resora „Gadskārtējā valsts budžeta izpildes procesā pārdalāmais finansējums”).
+
+Kopējās vērtības:
+
+| Vērtība | Avotā | Likumā (B15) |
+|---|---|---|
+| Resors | `Ministrija_Atslega` | Purpose `kind="resort"`, Actor `code` |
+| Programma, apakšprogramma | `Programma_Atslega`, `Apaksprogramma_Atslega` | Purpose `code` |
+| Budžeta veids | `Budzeta_tips_Atslega` P / S | `fund` basic / special |
+| Bloks | `Buzeta_bloks` | `block` core / eu |
+| Funkcija | `Funkcija_zemakaja_limeni_Atslega` | Purpose `function` |
+| Saistību veids | `Saistibu_veids_Atslega` | `commitmentKind` |
+| EKK grupa | `Vienotais_EKK_Atslega_4_limenis` | Allocation `code` (izdevumi) |
+| Iestāde | `Iestades_NMR` | — (likumā nav iestāžu līmeņa) → VPK ID caur B01 |
+
+## Ko salīdzinājums parāda un ko nē
+
+- Plāns ir **pieņemtais** likums. Gada laikā apropriācijas mainās (74. resora pārdale, apropriāciju pārdale un palielināšana saskaņā ar Likumu par budžetu un finanšu vadību, likuma grozījumi). Šīs izmaiņas vēl nav datu kopā, tāpēc izpilde virs 100 % vai programma bez plāna ne vienmēr nozīmē pārkāpumu.
+- Izpilde ir „Visu resoru NETO – bez transfertiem” (`consolidation="net"`). Nekonsolidētu izpildi iegūst, saskaitot visas četras konsolidācijas pazīmes.
+- Valsts pamatbudžeta nodokļu ieņēmumi šajā avotā nav; `flow="resource"` ir iestāžu līmeņa resursi izdevumu segšanai.
+
+## Nākamie avoti
+
+| Kas | Turētājs | Statuss |
+|---|---|---|
+| Precizētais plāns (tāmes ar grozījumiem) | Valsts kase | Iespējams `opendata.kase.gov.lv/api/v1/valsts_budzeta_tames`; jānoskaidro vaicājuma parametri |
+| Valsts konsolidētā budžeta ieņēmumu izpilde (nodokļi) | Valsts kase, VID | Jāpārbauda |
+| Mērķdotāciju izlietojums pašvaldībās | Valsts kase (pašvaldību budžeti) | Jāpārbauda |