# 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)