# Budžeta modelis (v0.1)

## 1. Jēdzieni

Budžets ir lēmums par periodu: kurš drīkst saņemt vai izlietot finanšu līdzekļus, kādā apmērā, 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 finanšu piešķīrums | `name`, `code`, `year`, `value`, `unit` |
| `Actor` | Kurš tur vai saņem finansējumu | `kind` (resort / institution / municipality / unallocated), `code` (resora kods), `vpk` (VPK ID) |
| `Purpose` | Kam finansējums paredzēts (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 finanšu fakts | skatīt 2. nodaļu |

## 2. Finanšu 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/>):

```sql
-- 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';
```