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
This commit is contained in:
524
contracts/B03-valsts-budzeta-izpilde.odcs.yaml
Normal file
524
contracts/B03-valsts-budzeta-izpilde.odcs.yaml
Normal file
@@ -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)
|
||||
106
contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml
Normal file
106
contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml
Normal file
@@ -0,0 +1,106 @@
|
||||
# ODCS v3 datu līgums: B03 Valsts budžeta izpilde — AVOTS (Valsts kases CSV, kā publicēts data.gov.lv).
|
||||
# Apraksta, ko VDE sagaida no Valsts kases datnes. Ja Valsts kase maina kolonnas vai kodus, ielāde to konstatē un reģistrē kā kļūdu.
|
||||
# Mērķa (pārveidotās) datu kopas līgums: contracts/B03-valsts-budzeta-izpilde.odcs.yaml. Pārveidošana: mappings/B03-izpilde.yaml.
|
||||
apiVersion: v3.0.2
|
||||
kind: DataContract
|
||||
id: urn:pppa:cac:contract:B03-source
|
||||
name: Valsts budžeta izpilde — Valsts kases avota datne
|
||||
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: >-
|
||||
Nekonsolidēta valsts pamatbudžeta un valsts speciālā budžeta izpilde pa mēnešiem sadalījumā pa iestādēm, gadskārtējā valsts
|
||||
budžeta likumā apstiprinātām programmām un apakšprogrammām un ieņēmumu, izdevumu ekonomiskās un finansēšanas klasifikāciju
|
||||
kodiem, atbilstoši Valsts kases valsts budžeta informācijas sistēmā reģistrētajiem datiem.
|
||||
usage: Avots datu kopai B03 VDE. Datne tiek lejupielādēta, pārbaudīta pret šo līgumu un pārveidota pēc mappings/B03-izpilde.yaml.
|
||||
limitations: >-
|
||||
Summas ir mēneša apjoms (nevis uzkrājums). Datnē nav apstiprinātā plāna un gada laikā precizētā plāna — tikai izpilde.
|
||||
Valsts pamatbudžeta nodokļu ieņēmumi datnē nav (ir iestāžu līmeņa resursi). Kārtējā gada datne tiek aizstāta katru mēnesi;
|
||||
iepriekšējā gada datne pēc gada slēgšanas var tikt precizēta.
|
||||
servers:
|
||||
- server: data.gov.lv
|
||||
type: custom
|
||||
format: csv
|
||||
description: Latvijas Atvērto datu portāls (CKAN), datu kopa ar vienu CSV datni katram gadam
|
||||
customProperties:
|
||||
- {property: dataset, value: "https://data.gov.lv/dati/lv/dataset/valsts-budzeta-izpilde-pa-iestadem-budzeta-programmam-apaksprogrammam-un-klasifikacijas-kodiem"}
|
||||
- {property: api, value: "https://data.gov.lv/dati/api/3/action/package_show?id=valsts-budzeta-izpilde-pa-iestadem-budzeta-programmam-apaksprogrammam-un-klasifikacijas-kodiem"}
|
||||
- {property: filePattern, value: "adkopai_(\\d{4})\\.csv$"}
|
||||
- {property: encoding, value: utf-8-sig}
|
||||
- {property: delimiter, value: ","}
|
||||
- {property: quote, value: "\""}
|
||||
- {property: decimalSeparator, value: "."}
|
||||
schema:
|
||||
- name: izpilde
|
||||
logicalType: object
|
||||
physicalType: csv-file
|
||||
physicalName: "vb_izpilde_pa_iestadem_budzeta_progr_apakspr_adkopai_<GGGG>.csv"
|
||||
description: Viena rinda = viena summa par mēnesi vienā griezumā. Kolonnu secība ir fiksēta; virsrakstu rinda ir obligāta.
|
||||
customProperties:
|
||||
- {property: lakehouseTable, value: cac_bronze.vk_budget_execution}
|
||||
properties:
|
||||
- {name: gads, physicalName: Gads, logicalType: integer, required: true, description: Budžeta gads; sakrīt ar gadu datnes nosaukumā}
|
||||
- {name: menesis, physicalName: Menesis_Atslega, logicalType: integer, required: true, description: "Mēnesis 1–12", logicalTypeOptions: {minimum: 1, maximum: 12}}
|
||||
- {name: menesis_nosaukums, physicalName: Menesis_nosaukums, logicalType: string, required: true}
|
||||
- {name: ministrija_kods, physicalName: Ministrija_Atslega, logicalType: string, required: true, description: Budžeta resora kods (2 cipari), logicalTypeOptions: {pattern: "[0-9]{2}"}}
|
||||
- {name: ministrija, physicalName: Ministrija_nosaukums, logicalType: string, required: true}
|
||||
- {name: resora_veids, physicalName: Resora_veids, logicalType: string, required: true}
|
||||
- {name: iestade_kods, physicalName: Iestade_Atslega, logicalType: string, required: true, description: Iestādes kods Valsts kases sistēmā}
|
||||
- {name: iestade, physicalName: Iestade_nosaukums, logicalType: string, required: true}
|
||||
- {name: nmr, physicalName: Iestades_NMR, logicalType: string, required: true, description: Iestādes reģistrācijas numurs, logicalTypeOptions: {pattern: "[0-9]{11}"}}
|
||||
- {name: budzeta_tips_kods, physicalName: Budzeta_tips_Atslega, logicalType: string, required: true,
|
||||
quality: [{type: library, rule: validValues, validValues: ["P", "S", "6", "7"]}]}
|
||||
- {name: budzeta_tips, physicalName: Budzeta_tips_nosaukums, logicalType: string, required: true}
|
||||
- {name: programma_kods, physicalName: Programma_Atslega, logicalType: string, required: true, logicalTypeOptions: {pattern: "[0-9]{2}\\.[0-9]{2}\\.[0-9]{2}"}}
|
||||
- {name: programma, physicalName: Programma_nosaukums, logicalType: string, required: true}
|
||||
- {name: apaksprogramma_kods, physicalName: Apaksprogramma_Atslega, logicalType: string, required: true, logicalTypeOptions: {pattern: "[0-9]{2}\\.[0-9]{2}\\.[0-9]{2}"}}
|
||||
- {name: apaksprogramma, physicalName: Apaksprogramma_nosaukums, logicalType: string, required: true}
|
||||
- {name: budzeta_bloks, physicalName: Buzeta_bloks, logicalType: string, required: false, description: "Kolonnas nosaukumā avotā ir drukas kļūda (Buzeta)",
|
||||
quality: [{type: library, rule: validValues, validValues: ["Pamatfunkcijas", "Ārvalstu finanšu palīdzība"]}]}
|
||||
- {name: funkcija_l1_kods, physicalName: Funkcija_augstakais_limenis_Atslega, logicalType: string, required: false}
|
||||
- {name: funkcija_l1, physicalName: Funkcija_augstakais_limenis_Nosaukums, logicalType: string, required: false}
|
||||
- {name: funkcija_kods, physicalName: Funkcija_zemakaja_limeni_Atslega, logicalType: string, required: false, logicalTypeOptions: {pattern: "[0-9]{2}\\.[0-9]{3}"}}
|
||||
- {name: funkcija, physicalName: Funkcija_zemakaja_limeni_nosaukums, logicalType: string, required: false}
|
||||
- {name: saistibu_veids_kods, physicalName: Saistibu_veids_Atslega, logicalType: string, required: false}
|
||||
- {name: saistibu_veids, physicalName: Saistibu_veids_nosaukums, logicalType: string, required: false}
|
||||
- {name: projekta_kods, physicalName: Projekta_arejais_kods_Atslega, logicalType: string, required: false}
|
||||
- {name: projekts, physicalName: Projekts_nosaukums, logicalType: string, required: false}
|
||||
- {name: klasifikacija, physicalName: Klasifikacija, logicalType: string, required: true,
|
||||
quality: [{type: library, rule: validValues, validValues: ["Ieņēmumi", "Izdevumi", "Finansēšana"]}]}
|
||||
- {name: ekk1, physicalName: Vienotais_EKK_Atslega_1_limenis, logicalType: string, required: false}
|
||||
- {name: ekk2, physicalName: Vienotais_EKK_Atslega_2_limenis, logicalType: string, required: false}
|
||||
- {name: ekk3, physicalName: Vienotais_EKK_Atslega_3_limenis, logicalType: string, required: false}
|
||||
- {name: ekk4, physicalName: Vienotais_EKK_Atslega_4_limenis, logicalType: string, required: false}
|
||||
- {name: ekk5, physicalName: Vienotais_EKK_Atslega_5_limenis, logicalType: string, required: false}
|
||||
- {name: ekk6, physicalName: Vienotais_EKK_Atslega_6_limenis, logicalType: string, required: false}
|
||||
- {name: ekk7, physicalName: Vienotais_EKK_Atslega_7_limenis, logicalType: string, required: true, description: Zemākā līmeņa klasifikācijas kods}
|
||||
- {name: ekk7_nosaukums, physicalName: Vienotais_EKK_Nosaukums_7_limenis, logicalType: string, required: false}
|
||||
- {name: likuma_griezuma_ekk, physicalName: Likuma_griezuma_EKK, logicalType: string, required: false, description: "Pozīcija likuma pielikumu griezumā: kods un nosaukums, piemēram „1000 Atlīdzība”"}
|
||||
- {name: konsolidacija, physicalName: Konsolidacija, logicalType: string, required: true,
|
||||
quality: [{type: library, rule: validValues, validValues: ["Visu resoru NETO - bez transfertiem", "+ pamatbudžeta savstarpējie transferti un atmaksas",
|
||||
"+ pamatbudžeta/speciālā budžeta savstarpējie transferti", "+ speciālā budžeta savstarpējie transferti"]}]}
|
||||
- {name: valuta, physicalName: Datu_valuta, logicalType: string, required: true, quality: [{type: library, rule: validValues, validValues: ["Euro"]}]}
|
||||
- {name: summa, physicalName: Summa, logicalType: number, required: true, description: Summa euro par mēnesi (punkts kā decimālatdalītājs)}
|
||||
quality:
|
||||
- {name: source_columns_match, type: custom, engine: cac-lakehouse, implementation: "app.cac_execution:source_columns_match",
|
||||
description: "Datnes virsrakstu rinda sakrīt ar līgumā noteiktajām kolonnām un to secību", dimension: conformity}
|
||||
- {name: source_values_valid, type: custom, engine: cac-lakehouse, implementation: "app.cac_execution:source_values_valid",
|
||||
description: "Obligātās kolonnas aizpildītas; vērtības atbilst šablonam vai pieļaujamo vērtību sarakstam; summa ir skaitlis; gads sakrīt ar datni", dimension: validity}
|
||||
- {name: source_key_unique, type: custom, engine: cac-lakehouse, implementation: "app.cac_execution:source_key_unique",
|
||||
description: "Rindas atslēga (mappings/B03-izpilde.yaml, id.key) ir unikāla", dimension: uniqueness}
|
||||
slaProperties:
|
||||
- {property: frequency, value: 1, unit: d, element: "pārbaude katru dienu (cron 03:30 UTC); ielāde, ja datne portālā mainījusies"}
|
||||
- {property: latency, value: 1, unit: month, element: "Valsts kase publicē iepriekšējā mēneša izpildi mēneša sākumā"}
|
||||
team:
|
||||
- {role: owner, name: "Valsts kase, Pārskatu departaments"}
|
||||
- {role: data steward, name: PPP Asociācija (PPPA)}
|
||||
support:
|
||||
- {channel: email, url: "mailto:pd@kase.gov.lv", description: Datu turētājs (Valsts kase)}
|
||||
- {channel: issues, url: "https://processgit.org/Valsts-Pirmkods/Budget-as-Code/issues", description: Līgums un pārveidošana (PPPA)}
|
||||
customProperties:
|
||||
- {property: sourceId, value: B03}
|
||||
- {property: licence, value: CC0-1.0}
|
||||
- {property: years, value: "2024, 2025, 2026"}
|
||||
Reference in New Issue
Block a user