Budget-as-Code/docs/MODELIS.md

Budžeta modelis (v0.1)

1. Jēdzieni

Budžets ir lēmums par periodu: kurš drīkst saņemt vai izlietot cik naudas, kādam mērķim un pēc kādiem noteikumiem.

Ieraksts	Kas tas ir	Galvenie lauki
Budget	Viena budžeta likuma versija	id, year, horizonTo, status (draft / adopted / amended), act, published, version
Source	Avota dokuments	kind (lawText / annex / form), annex, url, sha256
Provision	Likuma pants (teksts)	article, chapter
Parameter	Lielums, kas nav naudas piešķīrums	name, code, year, value, unit
Actor	Kurš tur vai saņem naudu	kind (resort / institution / municipality / unallocated), code (resora kods), vpk (VPK ID)
Purpose	Kam nauda paredzēta (koks)	kind (resort / programme / subprogramme / project / grant), code, parent, holder, function
Indicator	Rezultatīvais rādītājs	purpose, unit, year, base, target (rezervēts paskaidrojumiem)
Rule	Mašīnlasāms likuma noteikums	kind (limit / condition / permission), parameter, value, provision (rezervēts)
ClassItem	Izmantotais klasifikācijas kods	scheme, code, name, parent, parentScheme, intraFund
Allocation	Viens naudas fakts	skatīt 2. nodaļu

2. Naudas fakts (Allocation)

Lauks	Vērtības	Nozīme
flow	revenue · resource · expenditure · financing	valsts ieņēmumi · resursi izdevumu segšanai · izdevumi · finansēšana
fund	basic · special	valsts pamatbudžets · valsts speciālais budžets
nature	appropriation · forecast · ceiling · commitment · earmarkedGrant	apropriācija · ieņēmumu prognoze · maksimālais apjoms nākamajiem gadiem · ilgtermiņa saistības · mērķdotācija pašvaldībai
year, untilEnd	gads; true — no šī gada līdz projekta beigām
periodFrom, periodTo	datumi	mērķdotācijām: 1.01.–31.08. un 1.09.–31.12.
holder	Actor	kura budžetā ir summa
recipient	Actor	kas saņem (pašvaldība)
purpose	Purpose	programma, apakšprogramma, projekts vai mērķdotācija
block	core · eu	valsts pamatfunkciju īstenošana · ES politiku instrumentu un pārējās ārvalstu finanšu palīdzības līdzfinansētie projekti
commitmentKind	10 ciparu kods	ilgtermiņa saistību veids (kodi grupējas pa diviem cipariem: 01 01 10 00 00)
function	COFOG kods	funkcionālā klasifikācija
scheme, code	ekk · revenue · financing · law · commitment	klasifikācija un kods
amount	euro	kā publicēts
partOf	Allocation	„tai skaitā”: daļa no cita fakta, kopsummās otrreiz netiek skaitīta
src, srcRow	Source, rinda	kur summa ir avota datnē

3. Kas tiek glabāts un kas aprēķināts

Katrs fakts tiek glabāts vienu reizi, no detalizētākā avota:

Fakts	Avots
Izdevumi, resursi, finansēšana budžeta gadā	4. pielikums (pamatbudžets) un 5. pielikums (speciālais budžets) — apakšprogrammu līmenī
Nākamo divu gadu maksimālie apjomi	3. pielikums — resora un bloka līmenī (nature="ceiling")
Ieņēmumi	2. pielikums (nature="forecast"); speciālā budžeta budžeta gada ieņēmumi — 5. pielikums pa apakšprogrammām
Nodevas pa administrējošām ministrijām	2. pielikums, partOf uz attiecīgo ieņēmumu kodu
Ilgtermiņa saistības	11. pielikums — projekta vai programmas un saistību veida līmenī
Mērķdotācijas pašvaldībām	6.–10. pielikums — pa pašvaldībām un periodiem; „tai skaitā” kā partOf
IKP prognoze	1. pielikums (Parameter)

Viss pārējais — kopsummas, starpsummas, resoru un programmu summas, finansiālā bilance, viss 1. pielikums un 3. pielikuma budžeta gada dati — tiek aprēķināts.

Daļa summu likumā parādīta tikai apkopojuma līmenī, piemēram, valsts aizņēmumi. Tie tiek glabāti tajā līmenī, kurā likums tos rāda (bez programmas). Tādu ir maz: skatīt docs/SADERIBA.md.

4. Konsolidācija

Transferti viena fonda iekšienē (piemēram, „Valsts pamatbudžeta savstarpējie transferti”, „Ārvalstu finanšu palīdzība atmaksām valsts pamatbudžetam”) kopsummā izslēdzas tajā līmenī, kurā ir gan devējs, gan saņēmējs. Noteikums:

• kods ar intraFund="true" tiek skaitīts mezgla kopsummā tikai tad, ja likums šo kodu šajā mezglā rāda;
• ja nerāda, tas mezglā ir izslēdzies.

Piemērs: 2026. gada pamatbudžeta resursi pa programmām un apakšprogrammām ir 13 501 864 160 euro, bet likumā kopā 13 363 050 794 euro. Starpība 138 813 366 euro ir pamatbudžeta iekšējie transferti (25,4 milj.: kodi 18131, 18132, 18139), ārvalstu finanšu palīdzība atmaksām valsts pamatbudžetam (111,4 milj.: kods 21200) un dotācija atmaksām (2,0 milj.: kods 21720).

Starp fondiem (pamatbudžets ↔ speciālais budžets) konsolidē 1. pielikums: „mīnus transferts” rindas aprēķina no EKK kodiem 7110, 7120, 9110, 9120.

5. Klasifikāciju koks

Pielikumos kodi nav drukāti — tikai nosaukumi ar atkāpēm. Kodus piesaista pēc nosaukuma no trim avotiem: klasifikāciju MK noteikumiem, pielikumu slēptajām SAP lapām un Valsts kases izpildes datiem. Vecākkods tiek noteikts:

1. ar balsojumu pēc atkāpēm visos 2.–5. pielikuma blokos;
2. pārbaudot pret koda struktūru: skaitliskam kodam vecākkods var būt tikai tā prefikss (21200 nevar būt zem 21100).

Tas novērš avotu formatējuma kļūdas (sk. docs/SADERIBA.md).

6. Pielikumi kā skati

Pielikums	Skats
1. Konsolidētais budžets	Aprēķins no ieņēmumiem, izdevumiem un finansēšanas abos fondos; procenti no IKP — no Parameter
2. Ieņēmumi	flow="revenue"; nodevas — partOf
3. Resoru kopsavilkums	Budžeta gads — summa no 4./5. pielikuma faktiem pa resoriem un blokiem; nākamie gadi — nature="ceiling"
4., 5. Programmas	flow resource / expenditure / financing pa apakšprogrammām
6.–10. Mērķdotācijas	nature="earmarkedGrant", recipient = pašvaldība
11. Ilgtermiņa saistības	nature="commitment", commitmentKind, projekti kā Purpose kind="project"
12. Veidlapa	Tikai Source (datu nav)
Likuma teksts	Provision

7. Ārējo kodu avoti

source/kodi/ datnes izgūtas no VDZP (https://lakehouse.pppa.lv/):

-- vk_codes.tsv: ekonomiskās, ieņēmumu un finansēšanas klasifikācijas kodi ar nosaukumiem no Valsts kases izpildes datiem
SELECT DISTINCT klasifikacija, v FROM (SELECT klasifikacija, unnest(ARRAY[likuma_griezuma_ekk, ekk4, ekk5, ekk6, ekk7]) v
  FROM cac_bronze.vk_budget_execution) x WHERE v ~ '^[A-Z]{0,2}[0-9]';
-- vk_blocks.tsv: budžeta bloks (pamatfunkcijas / ārvalstu finanšu palīdzība) katrai apakšprogrammai
SELECT gads, ministrija_kods, programma_kods, apaksprogramma_kods, budzeta_bloks, budzeta_tips, count(*)
  FROM cac_bronze.vk_budget_execution WHERE gads IN ('2025','2026') GROUP BY 1,2,3,4,5,6;
-- vpk_resorts.tsv: resoru VPK ID (resora kods = VPK ID nozares daļa)
SELECT cac_id, name FROM cac_silver.organization WHERE cac_id LIKE '%-0000';