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
2026-10-11 10:49:19 +00:00
parent 6a89b97baf
commit 88577135b5
8 changed files with 1017 additions and 2 deletions
--- a/contracts/B03-valsts-budzeta-izpilde.odcs.yaml
+++ b/contracts/B03-valsts-budzeta-izpilde.odcs.yaml
@@ -0,0 +1,524 @@
+# ODCS v3 datu līgums: B03 Valsts budžeta izpilde (izpildes fakti uz budžeta likuma identifikatoriem)
+# Ģenerēts no schemas/valsts-budzeta-izpilde-0.1.xsd (tools/xsd_to_odcs.py, lakehouse). Shēmas daļu nelabot ar roku — labot XSD un ģenerēt no jauna.
+# Serveri un SLA pielāgoti: datu kopa tiek veidota VDE no Valsts kases CSV, nevis glabāta ProcessGit.
+apiVersion: v3.0.2
+kind: DataContract
+id: urn:pppa:cac:contract:B03
+name: Valsts budžeta izpilde (izpildes fakti uz budžeta likuma identifikatoriem)
+version: 0.1.0
+status: active
+domain: Valsts kā kods (Country as Code)
+dataProduct: Valsts budžeta izpilde
+tenant: PPP Asociācija (PPPA)
+description:
+  purpose: Valsts pamatbudžeta un speciālā budžeta izpilde pa mēnešiem, iestādēm, programmām, apakšprogrammām un klasifikācijas kodiem, pārveidota
+    uz tiem pašiem identifikatoriem, kas budžeta likumā (B15), lai plānu un izpildi var salīdzināt bez manuālas sasaistes.
+  usage: Plāna (B15) un izpildes salīdzināšana VDE; AI aģentu vaicājumi caur MCP.
+  limitations: Koncepcijas demonstrācija, nav oficiāls izdevums. Plāns ir pieņemtais likums; gada laikā veiktās apropriāciju izmaiņas vēl nav
+    iekļautas. Valsts pamatbudžeta nodokļu ieņēmumi avotā nav.
+servers:
+- server: vde
+  type: postgres
+  format: iceberg
+  description: 'VDE (Valsts datu ezerkrātuve): Silver tabula, kurā savienotājs ieraksta pārveidotos izpildes faktus'
+  customProperties:
+  - property: table
+    value: cac_silver.budget_execution
+  - property: names
+    value: cac_silver.budget_execution_name
+  - property: portal
+    value: https://lakehouse.pppa.lv/
+- server: data.gov.lv
+  type: custom
+  format: csv
+  description: Avots (Valsts kase); avota līgums contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml
+  customProperties:
+  - property: sourceContract
+    value: contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml
+  - property: mapping
+    value: mappings/B03-izpilde.yaml
+schema:
+- name: BudgetExecution
+  logicalType: object
+  physicalType: xml-element
+  physicalName: BudgetExecution
+  description: Viena budžeta gada izpilde (vai tās daļa), kā publicēta konkrētā Valsts kases datnē.
+  properties:
+  - name: id
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: lv-vbi-[0-9]{4}(\.p[0-9]{3}|\.names)?
+    description: 'Izpildes dokumenta identifikators: lv-vbi-GGGG (budžeta gads) un, ja dokuments ir sadalīts daļās, .pNNN vai .names.'
+    primaryKey: true
+    unique: true
+  - name: year
+    logicalType: string
+    required: true
+  - name: asOfMonth
+    logicalType: integer
+    required: true
+    description: Pēdējais mēnesis, par kuru datnē ir dati.
+  - name: law
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: lv-vb-[0-9]{4}(-r[0-9]+)?(\.[A-Za-z0-9_-]+)*
+    description: Tā paša gada budžeta likuma datukopa, pret kuru sasaistīti mērķi.
+  - name: generated
+    logicalType: string
+    required: true
+  - name: Source@publisher
+    logicalType: string
+    required: true
+  - name: Source@dataset
+    logicalType: string
+    required: true
+  - name: Source@url
+    logicalType: string
+    required: true
+  - name: Source@sha256
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: '[0-9a-f]{64}'
+  - name: Source@modified
+    logicalType: string
+    required: true
+    description: Datnes pēdējo izmaiņu laiks portālā.
+  - name: Source@rows
+    logicalType: integer
+    required: true
+  - name: Name
+    logicalType: array
+    required: false
+    description: Koda nosaukums, kā avotā (iestāde, resors, programma, funkcija, saistību veids, projekts, klasifikācijas kods, likuma griezuma
+      kods).
+    items:
+      logicalType: string
+  - name: Name@kind
+    logicalType: string
+    required: false
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - resort
+      - institution
+      - programme
+      - function
+      - commitment
+      - project
+      - code
+      - lawCode
+  - name: Name@key
+    logicalType: string
+    required: false
+  - name: Execution@id
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: lv-vbi-[0-9]{4}\.m(0[1-9]|1[0-2])\.[0-9a-f]{12}
+    description: 'Izpildes fakta identifikators: lv-vbi-GGGG.mMM.<12 heksadecimālas zīmes>. Zīmes ir SHA-1 no avota rindas atslēgas (mappings/B03-izpilde.yaml,
+      id.key), tāpēc atkārtotā ielādē tas pats fakts saņem to pašu identifikatoru.'
+  - name: Execution@month
+    logicalType: integer
+    required: false
+  - name: Execution@flow
+    logicalType: string
+    required: false
+    description: resource — iestādes resursi izdevumu segšanai (dotācija no vispārējiem ieņēmumiem, pašu ieņēmumi, ārvalstu finanšu palīdzība,
+      speciālā budžeta sociālās apdrošināšanas iemaksas, transferti); atbilst likuma pielikumu pozīcijai „Resursi izdevumu segšanai”. Valsts pamatbudžeta
+      nodokļu ieņēmumi šajā avotā nav. expenditure — izdevumi; financing — finansēšana.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - resource
+      - expenditure
+      - financing
+  - name: Execution@fund
+    logicalType: string
+    required: false
+    description: basic — valsts pamatbudžets; special — valsts speciālais budžets; loans — aizdevumu un atmaksu budžets; donations — ziedojumi
+      un dāvinājumi.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - basic
+      - special
+      - loans
+      - donations
+  - name: Execution@block
+    logicalType: string
+    required: false
+    description: core — valsts pamatfunkciju īstenošana; eu — Eiropas Savienības politiku instrumentu un pārējās ārvalstu finanšu palīdzības līdzfinansētie
+      projekti un pasākumi. Tās pašas vērtības kā budžeta likumā.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - core
+      - eu
+  - name: Execution@consolidation
+    logicalType: string
+    required: false
+    description: net — „Visu resoru NETO – bez transfertiem” (summējams, lai iegūtu izpildi bez savstarpējiem transfertiem); basicTransfers —
+      pamatbudžeta savstarpējie transferti un atmaksas; basicSpecialTransfers — pamatbudžeta un speciālā budžeta savstarpējie transferti; specialTransfers
+      — speciālā budžeta savstarpējie transferti. Nekonsolidētu izpildi iegūst, saskaitot visas četras.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - net
+      - basicTransfers
+      - basicSpecialTransfers
+      - specialTransfers
+  - name: Execution@resort
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{2}'
+    description: Budžeta resora (ministrijas vai citas centrālās valsts iestādes) kods, divi cipari. Tas pats kods budžeta likumā un VPK ID pirmajos
+      divos ciparos.
+  - name: Execution@institution
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{11}'
+    description: Iestādes reģistrācijas numurs (11 cipari); sasaista ar UR un Valsts kancelejas organizāciju reģistru (VPK ID).
+  - name: Execution@institutionCode
+    logicalType: string
+    required: false
+    description: Iestādes kods Valsts kases sistēmā (mainās starp gadiem; pastāvīgais ir institution).
+  - name: Execution@programme
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{2}\.[0-9]{2}'
+    description: Programmas vai apakšprogrammas kods PP.AA.SS, kā budžeta likumā (piemēram 19.03.00). Programmai bez apakšprogrammām apakšprogrammas
+      kods ir programmas kods.
+  - name: Execution@subprogramme
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{2}\.[0-9]{2}'
+    description: Programmas vai apakšprogrammas kods PP.AA.SS, kā budžeta likumā (piemēram 19.03.00). Programmai bez apakšprogrammām apakšprogrammas
+      kods ir programmas kods.
+  - name: Execution@function
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{3}'
+    description: Valdības funkciju klasifikācijas kods (COFOG), piemēram 09.200.
+  - name: Execution@commitmentKind
+    logicalType: string
+    required: false
+    description: Saistību veida kods (10 cipari), kā budžeta likuma 11. pielikumā; 0000000000 — bez saistību veida.
+  - name: Execution@project
+    logicalType: string
+    required: false
+    description: Projekta ārējais kods, ja izpilde attiecas uz projektu.
+  - name: Execution@scheme
+    logicalType: string
+    required: false
+    description: 'Kura klasifikācija ir atribūtā code: ekk — izdevumu ekonomiskā klasifikācija; revenue — ieņēmumu klasifikācija; financing —
+      finansēšanas klasifikācija. Tās pašas vērtības kā budžeta likumā.'
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - ekk
+      - revenue
+      - financing
+  - name: Execution@code
+    logicalType: string
+    required: false
+    description: Zemākā līmeņa klasifikācijas kods (EKK, ieņēmumu vai finansēšanas klasifikācija).
+  - name: Execution@group
+    logicalType: string
+    required: false
+    description: EKK grupa četru ciparu līmenī (1000, 2000 … 9000) — tas līmenis, kurā izdevumi noteikti budžeta likumā.
+  - name: Execution@lawCode
+    logicalType: string
+    required: false
+    description: Pozīcija likuma pielikumu griezumā (piemēram 1000, A300, 21710), ja avots to norāda.
+  - name: Execution@purpose
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: lv-vb-[0-9]{4}(-r[0-9]+)?(\.[A-Za-z0-9_-]+)*
+    description: 'Budžeta likuma mērķis (Purpose), kuram atbilst izpilde: tā paša gada likums, šī resora apakšprogramma vai programma.'
+  - name: Execution@lawMatch
+    logicalType: string
+    required: false
+    description: 'Kā izpildes fakts sasaistīts ar tā paša gada budžeta likumu: subprogramme — likumā ir šī resora apakšprogramma; programme —
+      likumā ir tikai programma; none — likumā šādas programmas nav (piemēram, izveidota gada laikā) vai likums nav ielādēts.'
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - subprogramme
+      - programme
+      - none
+  - name: Execution@amount
+    logicalType: number
+    required: false
+    description: Summa euro par mēnesi, kā publicēta. Negatīva vērtība nozīmē samazinājumu (atmaksu, korekciju) vai finansēšanā līdzekļu izlietojumu.
+  - name: Execution@srcRow
+    logicalType: integer
+    required: false
+    description: Rindas numurs avota datnē (bez virsrakstu rindas).
+  customProperties: []
+- name: Name
+  logicalType: object
+  physicalType: xml-element
+  physicalName: Name
+  description: Koda nosaukums, kā avotā (iestāde, resors, programma, funkcija, saistību veids, projekts, klasifikācijas kods, likuma griezuma
+    kods).
+  properties:
+  - name: kind
+    logicalType: string
+    required: true
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - resort
+      - institution
+      - programme
+      - function
+      - commitment
+      - project
+      - code
+      - lawCode
+    primaryKey: true
+    unique: true
+  - name: key
+    logicalType: string
+    required: true
+    primaryKey: true
+    unique: true
+  - name: text()
+    logicalType: string
+    required: true
+  customProperties:
+  - property: lakehouseTable
+    value: cac_silver.budget_execution_name
+- name: Execution
+  logicalType: object
+  physicalType: xml-element
+  physicalName: Execution
+  description: 'Viens izpildes fakts: summa par mēnesi vienā avota griezumā.'
+  properties:
+  - name: id
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: lv-vbi-[0-9]{4}\.m(0[1-9]|1[0-2])\.[0-9a-f]{12}
+    description: 'Izpildes fakta identifikators: lv-vbi-GGGG.mMM.<12 heksadecimālas zīmes>. Zīmes ir SHA-1 no avota rindas atslēgas (mappings/B03-izpilde.yaml,
+      id.key), tāpēc atkārtotā ielādē tas pats fakts saņem to pašu identifikatoru.'
+    primaryKey: true
+    unique: true
+  - name: month
+    logicalType: integer
+    required: true
+  - name: flow
+    logicalType: string
+    required: true
+    description: resource — iestādes resursi izdevumu segšanai (dotācija no vispārējiem ieņēmumiem, pašu ieņēmumi, ārvalstu finanšu palīdzība,
+      speciālā budžeta sociālās apdrošināšanas iemaksas, transferti); atbilst likuma pielikumu pozīcijai „Resursi izdevumu segšanai”. Valsts pamatbudžeta
+      nodokļu ieņēmumi šajā avotā nav. expenditure — izdevumi; financing — finansēšana.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - resource
+      - expenditure
+      - financing
+  - name: fund
+    logicalType: string
+    required: true
+    description: basic — valsts pamatbudžets; special — valsts speciālais budžets; loans — aizdevumu un atmaksu budžets; donations — ziedojumi
+      un dāvinājumi.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - basic
+      - special
+      - loans
+      - donations
+  - name: block
+    logicalType: string
+    required: false
+    description: core — valsts pamatfunkciju īstenošana; eu — Eiropas Savienības politiku instrumentu un pārējās ārvalstu finanšu palīdzības līdzfinansētie
+      projekti un pasākumi. Tās pašas vērtības kā budžeta likumā.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - core
+      - eu
+  - name: consolidation
+    logicalType: string
+    required: true
+    description: net — „Visu resoru NETO – bez transfertiem” (summējams, lai iegūtu izpildi bez savstarpējiem transfertiem); basicTransfers —
+      pamatbudžeta savstarpējie transferti un atmaksas; basicSpecialTransfers — pamatbudžeta un speciālā budžeta savstarpējie transferti; specialTransfers
+      — speciālā budžeta savstarpējie transferti. Nekonsolidētu izpildi iegūst, saskaitot visas četras.
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - net
+      - basicTransfers
+      - basicSpecialTransfers
+      - specialTransfers
+  - name: resort
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: '[0-9]{2}'
+    description: Budžeta resora (ministrijas vai citas centrālās valsts iestādes) kods, divi cipari. Tas pats kods budžeta likumā un VPK ID pirmajos
+      divos ciparos.
+  - name: institution
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: '[0-9]{11}'
+    description: Iestādes reģistrācijas numurs (11 cipari); sasaista ar UR un Valsts kancelejas organizāciju reģistru (VPK ID).
+  - name: institutionCode
+    logicalType: string
+    required: true
+    description: Iestādes kods Valsts kases sistēmā (mainās starp gadiem; pastāvīgais ir institution).
+  - name: programme
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{2}\.[0-9]{2}'
+    description: Programmas vai apakšprogrammas kods PP.AA.SS, kā budžeta likumā (piemēram 19.03.00). Programmai bez apakšprogrammām apakšprogrammas
+      kods ir programmas kods.
+  - name: subprogramme
+    logicalType: string
+    required: true
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{2}\.[0-9]{2}'
+    description: Programmas vai apakšprogrammas kods PP.AA.SS, kā budžeta likumā (piemēram 19.03.00). Programmai bez apakšprogrammām apakšprogrammas
+      kods ir programmas kods.
+  - name: function
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: '[0-9]{2}\.[0-9]{3}'
+    description: Valdības funkciju klasifikācijas kods (COFOG), piemēram 09.200.
+  - name: commitmentKind
+    logicalType: string
+    required: false
+    description: Saistību veida kods (10 cipari), kā budžeta likuma 11. pielikumā; 0000000000 — bez saistību veida.
+  - name: project
+    logicalType: string
+    required: false
+    description: Projekta ārējais kods, ja izpilde attiecas uz projektu.
+  - name: scheme
+    logicalType: string
+    required: true
+    description: 'Kura klasifikācija ir atribūtā code: ekk — izdevumu ekonomiskā klasifikācija; revenue — ieņēmumu klasifikācija; financing —
+      finansēšanas klasifikācija. Tās pašas vērtības kā budžeta likumā.'
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - ekk
+      - revenue
+      - financing
+  - name: code
+    logicalType: string
+    required: true
+    description: Zemākā līmeņa klasifikācijas kods (EKK, ieņēmumu vai finansēšanas klasifikācija).
+  - name: group
+    logicalType: string
+    required: false
+    description: EKK grupa četru ciparu līmenī (1000, 2000 … 9000) — tas līmenis, kurā izdevumi noteikti budžeta likumā.
+  - name: lawCode
+    logicalType: string
+    required: false
+    description: Pozīcija likuma pielikumu griezumā (piemēram 1000, A300, 21710), ja avots to norāda.
+  - name: purpose
+    logicalType: string
+    required: false
+    logicalTypeOptions:
+      pattern: lv-vb-[0-9]{4}(-r[0-9]+)?(\.[A-Za-z0-9_-]+)*
+    description: 'Budžeta likuma mērķis (Purpose), kuram atbilst izpilde: tā paša gada likums, šī resora apakšprogramma vai programma.'
+  - name: lawMatch
+    logicalType: string
+    required: true
+    description: 'Kā izpildes fakts sasaistīts ar tā paša gada budžeta likumu: subprogramme — likumā ir šī resora apakšprogramma; programme —
+      likumā ir tikai programma; none — likumā šādas programmas nav (piemēram, izveidota gada laikā) vai likums nav ielādēts.'
+    quality:
+    - type: library
+      rule: validValues
+      validValues:
+      - subprogramme
+      - programme
+      - none
+  - name: amount
+    logicalType: number
+    required: true
+    description: Summa euro par mēnesi, kā publicēta. Negatīva vērtība nozīmē samazinājumu (atmaksu, korekciju) vai finansēšanā līdzekļu izlietojumu.
+  - name: srcRow
+    logicalType: integer
+    required: true
+    description: Rindas numurs avota datnē (bez virsrakstu rindas).
+  customProperties:
+  - property: lakehouseTable
+    value: cac_silver.budget_execution
+quality:
+- name: xsd_valid
+  type: custom
+  engine: xsd
+  implementation: schemas/valsts-budzeta-izpilde-0.1.xsd
+  description: Katra pārveidotā BudgetExecution dokumenta daļa atbilst XSD shēmai
+  dimension: conformity
+- name: id_unique
+  type: custom
+  engine: cac-lakehouse
+  implementation: app.cac_execution:id_unique
+  description: Izpildes faktu identifikatori ir unikāli visā gadā
+  dimension: uniqueness
+- name: totals_reconcile
+  type: custom
+  engine: cac-lakehouse
+  implementation: app.cac_execution:totals_reconcile
+  description: Pārveidoto faktu summa katrā gadā sakrīt ar avota datnes summu (nekas nav zaudēts vai pievienots)
+  dimension: accuracy
+- name: resort_known
+  type: custom
+  engine: cac-lakehouse
+  implementation: app.cac_execution:resort_known
+  description: Resora kods ir Valsts kancelejas organizāciju reģistrā (B01) vai budžeta likumā (B15)
+  dimension: consistency
+slaProperties:
+- property: frequency
+  value: 1
+  unit: d
+  element: pārbaude katru dienu (cron 03:30 UTC); pārveidošana, ja mainījusies avota datne vai šī repozitorija commit
+- property: retention
+  value: kārtējais stāvoklis; avota datnes kontrolsumma un commit katrā ielādē (cac_meta.loads)
+team:
+- role: owner
+  name: Valsts kase (izpildes dati); PPPA (shēma un pārveidošana)
+- role: data steward
+  name: PPP Asociācija (PPPA)
+support:
+- channel: issues
+  url: https://processgit.org/Valsts-Pirmkods/Budget-as-Code/issues
+customProperties:
+- property: sourceId
+  value: B03
+- property: namespace
+  value: urn:pppa:vpk:budzeta-izpilde:0.1
+- property: rootElement
+  value: BudgetExecution
+- property: identifiers
+  value: dokuments lv-vbi-GGGG[.pNNN]; fakts lv-vbi-GGGG.mMM.<sha1[:12]>; purpose → lv-vb-GGGG.pr.RR.PP.AA.SS (B15)