Valsts kā organizācija – vienotā datu un zināšanu platformā
Valsts PirmKods projekta (Valsts kā kods koncepcija) mērķis ir efektīvāka un drošāka valsts pārvalde. Lai valsti varētu pārvaldīt kā sistēmu, vispirms vajag vienotus datus un zināšanas: kas valstī ir (iestādes), ko tās drīkst un kam jādara (tiesības), uz ko tiecas (stratēģija), ar ko to dara (arhitektūra) un ar kādiem finanšu līdzekļiem (budžets) – sasaistītu vienā modelī, kur katrai saitei ir zināma izcelsme.
„Kā kods” slāņi šajā demonstrācijā
Cik droši ir sasaistīts?
Katrai saitei VZB ir statuss. AI aģents drīkst balstīties tikai uz to, ko var pierādīt – un pasaka, ja kaut kas nav zināms.
Cik pilnīgas ir VZB saites?
Ceļš no avota līdz lēmumam
Bronze – avoti, kā saņemti, ar datu līguma pārbaudēm. Silver – kanoniskais valsts modelis (iestāde, akts, punkts, mērķis, uzdevums, rādītājs, funkcija, izdevumi) un saišu tabula. Gold – atbildes vadībai un atradumi.
Valsts stāvoklis: ko valdība apņēmusies un kā tas tiek īstenots
Valdības deklarācija, tās rīcības plāns, Valsts kancelejas organizāciju reģistrs (VPK ID) un MI stratēģija – ielādēti katru dienu no ProcessGit repozitorijiem kopā ar datu līgumiem. Katrs uzdevums, pasākums un institūcija ir sasaistīti pēc identifikatora.
Deklarācijas nodaļas: pasākumu skaits
Pasākumu termiņi
Rīcības plānā ir termiņi, bet nav izpildes datu – tāpēc „termiņš pagājis” nenozīmē „nav izpildīts”, bet „nav zināms”.
Deklarācijas uzdevumi un to pasākumi
Klikšķiniet uz uzdevuma, lai redzētu pasākumus, atbildīgās institūcijas (VPK ID) un termiņus.
Institūcijas: atbildība rīcības plānā un 2025. gada izdevumi
Ministrijām (SS-0000) izdevumi ir visa resora izdevumi.
MI stratēģija (PPPA piedāvājums)
Jaunās deklarācijas projekts
Datu svaigums un līgumi
Kā dati nonāk VDE
Katrs punkts ir ierakstu pakete. Līnijas biezums atbilst reālajam ierakstu skaitam katrā avotā. Zaļie ieraksti nāk no strukturētiem datiem, dzeltenie – automātiski izgūti no tiesību aktu un plānu teksta, violetie – PPPA ekspertvērtējumi, sarkanie – datu līguma pārbaudēs atrastās kļūdas. Zilie ir vaicājumi no patērētājiem. Raustītās līnijas – plānotie patērētāji. Klikšķiniet uz jebkura elementa.
Klikšķiniet uz avota, slāņa vai patērētāja.
Datu apmaiņa: ikdienas ielāde no ProcessGit un MCP vaicājumi
Katru dienu noteiktā laikā savienotājs pārbauda katra ProcessGit repozitorija pēdējo commit. Ja tas nav mainījies, repozitorijs tiek izlaists. Ja ir jauns commit, datnes tiek lejupielādētas tieši šajā commit, pārbaudītas pret XSD un datu līgumu un ielādētas Bronze slānī; pēc tam pārbūvē Silver un Gold. Katra apmaiņa – arī izlaistā un neizdevusies – tiek ierakstīta žurnālā, tāpat kā katrs AI asistenta (MCP) vaicājums.
Laika līnija
Kā notiek viena ielāde
Apmaiņas žurnāls
Ielādētās datnes (pēdējais commit)
MCP rīku izmantojums
Datu kopu reģistrs
Datu kopa ir nosaukts publisks avots ar turētāju, licenci, atjaunošanas biežumu un datu līgumu. Tā atšķiras no kanoniskā modeļa entītijas, kas nosaka, ko dati nozīmē, un no tabulas, kurā tie fiziski glabājas katrā slānī.
Datu kopa
Avota skats: kurš to uztur, cik bieži mainās, ar kādu licenci. Piemērs: Valsts budžeta izpilde (Valsts kase).
Entītija
Nozīme: viena kopīga definīcija visiem avotiem. Piemērs: Iestāde – viena rinda katram NMR, apvienota no UR, budžeta un Valsts kancelejas reģistra (VPK ID).
Tabula
Glabāšana: kur ieraksti atrodas katrā slānī. Piemērs: cac_bronze.vk_budget_execution → cac_silver.expenditure → cac_gold.spend_by_function.
Institūciju karte: ministrijas, iestādes, funkcijas
Iestādes sasaistītas pēc reģistrācijas numura (NMR) trijos avotos: budžeta izpildē, UR publisko iestāžu sarakstā un Valsts kancelejas organizāciju reģistrā (VPK ID). Izvēlieties ministriju un iestādi. Kultūras nozarei pievienota arī jomas mērķarhitektūra (arhitektūra kā kods).
Ministrijas un resori
Iestādes
Kultūras un valodu tehnoloģiju jomas mērķarhitektūra
Mērķu ķēde: no NAP2027 rādītāja līdz finansējumam
Nacionālais attīstības plāns sadalīts vienumos (mērķis, rādītājs, uzdevums, atbildīgie). Ķēde rāda, cik tālu var izsekot no rādītāja līdz mērīšanai, uzdevumiem, atbildīgajiem un budžetam – un kur ķēde pārtrūkst.
Ministriju slodze NAP2027 uzdevumos
Prioritātes
Budžets: likums (plāns) un izpilde kā dati
B15 – pieņemtais valsts budžeta likums kā dati (ProcessGit Valsts-Pirmkods/Budget-as-Code; katrs likuma pielikumos drukātais skaitlis atjaunojams no datnes). B03 – Valsts kases izpildes atvērtie dati pa iestādēm, programmām, funkcionālās un ekonomiskās klasifikācijas kodiem, katru mēnesi (izdevumi bez savstarpējiem transfertiem starp budžetiem). Abas datu kopas lieto vienus un tos pašus resoru kodus; resori sasaistīti ar VPK ID.
Budžeta likums (B15): konsolidētais budžets
Ieņēmumi un izdevumi abos fondos (pamatbudžets un speciālais budžets), atņemot transfertus starp fondiem (EKK 7110, 7120, 9110, 9120) un transfertus viena fonda iekšienē. Budžeta gadā – apropriācijas, nākamajos divos gados – maksimālie apjomi.
Likums (B15): izdevumi pa resoriem
Izpilde (B03): izdevumi pa ministrijām
Plāns (B15) pret izpildi (B03) pa resoriem
Plāns – pieņemtā likuma apropriācijas (izdevumi, pamatbudžets un speciālais budžets). Izpilde – Valsts kases dati no gada sākuma, bez savstarpējiem transfertiem. Gada laikā veiktās apropriāciju izmaiņas (piemēram, 74. resora pārdale) datos vēl nav, tāpēc izpilde virs 100 % vai izpilde bez plāna pati par sevi nenozīmē pārkāpumu.
Izpilde programmās, kuru pieņemtajā likumā nav
Izpilde (B03): pa valsts funkcijām
Izpilde (B03): pa mēnešiem
Funkcijas, kuras finansē visvairāk ministriju (2025)
Klikšķiniet uz rindas, lai redzētu iestādes. Izkliede ir kandidāts pārskatīšanai, nevis pierādījums dublēšanai.
Tiesības: ko iestādēm jādara pēc nolikuma
Kultūras nozares iestāžu nolikumi no likumi.lv sadalīti punktos un apakšpunktos (tiesības kā kods, 1. līmenis – strukturēti noteikumi). Punkta veids – funkcija, uzdevums vai tiesības – nolasīts automātiski. Neoficiāla interpretācija.
Nolikumi
Iestādes bez sadalīta nolikuma
Kultūras resora iestādes ar 2025. g. izdevumiem, kuru izveides akts šeit nav sadalīts (piem., izveidotas ar likumu).
Līdzīgi punkti dažādu iestāžu nolikumos
Pāri atrasti pēc teksta līdzības. Tie ir kandidāti kopīgiem vai koplietošanas pakalpojumiem – katrs jāpārskata cilvēkam.
Atradumi
Ko atklāj VZB. Katrs atradums ir aprēķināts no Gold slāņa un norāda uz pierādījumiem.
Reģistru neatbilstības
Jautā VZB
Kā AI aģents izmanto VZB. Šeit atbildes saliktas no vaicājumiem pa slāņiem bez valodas modeļa – katrs vaicājums un katras izmantotās saites statuss ir redzams, tāpēc atbildi var pārbaudīt.
MI aģenti
Valsts PirmKods datu kopas veido un uztur MI aģenti. Katrs aģents strādā ar vienu valsts dokumentu: pārveido to par datiem ar shēmu un versiju, pārbauda, vai no datiem var atjaunot dokumentu, un publicē rezultātu ProcessGit kopā ar datu līgumu. No turienes VDZP datus ielādē katru dienu, un tie kļūst pieejami šajā portālā un citiem AI aģentiem caur MCP.
Valdības Deklarācijas Datukopas MI Aģents
Valdības deklarācija un rīcības plāns kā datu kopa: katram uzdevumam un pasākumam pastāvīgs identifikators, atbildīgā institūcija ar VPK ID un termiņš. Aģents salīdzina deklarācijas versijas un projektus un parāda, kuri uzdevumi pārņemti, kuri jauni un kuri izpalikuši.
PPPA Valsts Budžeta Datukopas MI Aģents
Pieņemtais valsts budžeta likums kā dati: ieņēmumi, apropriācijas pa programmām un apakšprogrammām, nākamo gadu maksimālie apjomi, ilgtermiņa saistības un mērķdotācijas pašvaldībām. Katrs likuma pielikumos drukātais skaitlis atjaunojams no datnes; VDZP to salīdzina ar Valsts kases izpildi.
Kā aģenti saistīti ar VDZP
Valsts PirmKods
PPPA koncepcija: valsts pārvaldes darbības loģika — noteikumi, organizācija, procesi, dati, finanses un mērķi — aprakstīta kā atvērts, versiju kontrolē uzturēts un izpildāms kods. VDZP un abi aģenti ir šīs koncepcijas daļa.
Projekta lapa · pppa.lv/valsts-pirmkods →MCP savienojumi
VDZP ir pieejama AI aģentiem kā MCP serveris (Model Context Protocol — atvērts standarts, ar kuru AI asistenti pieslēdzas datu avotiem). Aģents saņem jautājumu, pats izvēlas vajadzīgo rīku, nolasa datus no VDE slāņiem un atbild ar ID, pēc kuriem atbildi var pārbaudīt. Savienojums ir tikai lasīšanai, un dati paliek uz šī servera.
Savienojuma dati
Piekļuves atslēgu izsniedz PPPA. Kas zina adresi ar atslēgu, var vaicāt datus, tāpēc to nepublicē un nerāda ekrānā.
Robežas
- Visi rīki tikai lasa datus; rakstīšanas rīku nav.
- query_sql izpilda vienu SELECT vaicājumu shēmās cac_bronze, cac_silver, cac_gold, cac_meta: līdz 500 rindām, ar 15 sekunžu laika limitu.
- Katrs izsaukums tiek reģistrēts (rīks, ilgums, rindu skaits, kļūdas) un redzams cilnē „Datu apmaiņa”.
- Servera instrukcija liek aģentam norādīt, ka dati nāk no PPPA koncepcijas demonstrācijas, un svarīgiem secinājumiem atsaukties uz oficiālo avotu.
Kā pievienot
1. Claude (claude.ai, Claude Desktop)
- Customize → Connectors → + Add → Add custom connector.
- Nosaukums „VDZP”, adrese ar piekļuves atslēgu.
- Authentication: „No sign in”, tad Add.
- Sarunā ieslēdz VDZP savienotāju izvēlnē.
Team un Enterprise plānos savienotāju pievieno organizācijas īpašnieks (Organization settings → Connectors), dalībnieki to pieslēdz.
2. Claude Code
claude mcp add --transport http vdzp \ https://lakehouse.pppa.lv/mcp/<atslēga>
Pēc tam /mcp parāda savienojumu un tā rīkus.
3. Claude Dashboards
Ar pievienotu VDZP savienotāju palūdz Claude izveidot paneli, piemēram: „Izveido paneli par valdības rīcības plāna termiņiem”.
Panelis glabā SQL vaicājumus (rīks query_sql) un izpilda tos no jauna katrā atvēršanā ar skatītāja savienotāju, tāpēc skaitļi atjaunojas pēc katras nakts ielādes. Katram skaitlim redzams vaicājums, no kura tas nāk.
4. Cits aģents (Python, MCP SDK 2.x)
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client
URL = "https://lakehouse.pppa.lv/mcp/<atslēga>"
async def main():
async with streamable_http_client(URL) as (read, write):
async with ClientSession(read, write) as s:
await s.initialize()
r = await s.call_tool("find_measures",
{"cac_id": "21-0000", "limit": 5})
print(r.content[0].text)
asyncio.run(main())
Der jebkurš klients vai aģentu ietvars, kas atbalsta attālus MCP serverus (Streamable HTTP).
5. Pārbaude bez aģenta (curl)
curl -s https://lakehouse.pppa.lv/mcp/<atslēga> \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"state_overview","arguments":{}}}'
Rīki (…)
Apraksti angļu valodā — tieši tā, kā tos redz aģents. Parametrs ar * ir obligāts.
Jautājumu piemēri
Datu līgumi un pārbaudes
Katra datu kopa nāk no publiska avota, un katram avotam ir datu līgums (pēc ODCS parauga): īpašnieks, atrašanās vieta, atslēgas, kvalitātes noteikumi un atjaunošana. Pārbaudes izpildās ielādes brīdī.
Ekspertvērtējumi (mappings.yaml)
Saites, kuras neviens avots nesniedz un kuras šai demonstrācijai pieņēmis PPPA. Tās ir atzīmētas kā expert-assessed.