Rihards Gailums
3574c8133f
- kultūras un valodu tehnoloģiju joma → domains/kultura-valoda, avota PDF → sources/kultura-valoda - izņemts KISC MCP servera kods, Docker un servera identitātes datnes (paliek KISC projekta repozitorijā) - domenas.yaml, schemas/arhitektura-0.1.schema.json, contracts/B09-digitalas-parvaldes-arhitekturas.odcs.yaml, tools/validate.py Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016679RwmHsuTFfxt26wP6rk
43 lines
3.1 KiB
Markdown
43 lines
3.1 KiB
Markdown
# Digitālās pārvaldes arhitektūras kā kods (Architecture-as-Code)
|
|
|
|
VARAM digitālās pārvaldes arhitektūras horizontālās un nozaru jomas kā dati: viens jomu katalogs un katrai jomai — funkcijas, pakalpojumi, informācijas resursi, informācijas sistēmas, organizācijas, mērķi un saites starp tiem, visas pēc vienas shēmas.
|
|
|
|
Autors: PPP Asociācija (PPPA), Valsts Pirmkods (VPK). Shēmas versija 0.1, melnraksts.
|
|
|
|
> **Koncepcijas demonstrācija.** Šīs datnes nav oficiāls izdevums. Metodiski saistošs ir VARAM publicētais arhitektūras apraksts ([horizontālās jomas](https://www.varam.gov.lv/lv/horizontalo-jomu-arhitekturas), [nozaru jomas](https://www.varam.gov.lv/lv/nozaru-jomu-arhitekturas)).
|
|
|
|
## Stāvoklis
|
|
|
|
21 joma katalogā (6 horizontālās, 1 apakšjoma, 14 nozaru un starpnozaru). Kodā pārveidota 1: **Kultūra un valodu tehnoloģijas** (`domains/kultura-valoda`). Pārējās tiks pārveidotas pa vienai; katras jomas stāvoklis ir `domenas.yaml` laukā `as_code.status`.
|
|
|
|
## Saturs
|
|
|
|
| Datne / mape | Saturs |
|
|
|---|---|
|
|
| `domenas.yaml` | Visu jomu katalogs: nosaukums, veids, izstrādes vadītāja iestāde (ar VPK ID), VARAM apstiprinājums, dokumentu saites, stāvoklis kodā |
|
|
| `domains/<slug>/manifest.yaml` | Jomas apraksts un tās reģistru atrašanās vieta |
|
|
| `domains/<slug>/registers/` | Reģistri (YAML): organizācijas, funkcijas, pakalpojumi, informācijas resursi, sistēmas, mērķi, ceļa karte, riski, saites |
|
|
| `domains/<slug>/views/` | Apraksta nodaļas (Markdown), ģenerētas no reģistriem |
|
|
| `sources/<slug>/` | Avota dokumenti, no kuriem joma pārveidota |
|
|
| `schemas/arhitektura-0.1.schema.json` | Kopīga JSON shēma visām jomām; `x-roles` nosaka, pret kuru tipu pārbauda katru reģistru |
|
|
| `contracts/B09-digitalas-parvaldes-arhitekturas.odcs.yaml` | ODCS v3 datu līgums (VDZP datu kopa B09) |
|
|
| `tools/validate.py` | Tās pašas pārbaudes, ko veic VDZP savienotājs |
|
|
|
|
## Identifikatori
|
|
|
|
Elementa identifikators jomā ir lokāls (`func.01`, `svc.k.03`, `org.kisc`). Pilnais identifikators ir `<jomas slug>:<lokālais ID>`, piemēram `kultura-valoda:func.01`, tāpēc jomas var izmantot vienādus lokālos identifikatorus. Organizācijām var norādīt `vpk_id` (Valsts kancelejas organizāciju reģistrs, VDZP B01).
|
|
|
|
## Jaunas jomas pievienošana
|
|
|
|
1. `domenas.yaml`: jomai `as_code.status: in_progress`, vēlāk `transformed` un `path: domains/<slug>`.
|
|
2. `domains/<slug>/manifest.yaml` ar `id: domain.<slug>` un reģistru sarakstu (lomas kā `domains/kultura-valoda/manifest.yaml`).
|
|
3. Reģistri `domains/<slug>/registers/`; avota dokuments `sources/<slug>/`.
|
|
4. `python3 tools/validate.py` — visām pārbaudēm jābūt OK.
|
|
5. Commit. VDZP nākamajā rītā (06:30 Rīgas laikā) ielādē jauno jomu automātiski.
|
|
|
|
## Saistītās datu kopas
|
|
|
|
- VDZP — Valsts datu un zināšanu platforma (demonstrācija): <https://lakehouse.pppa.lv/>, datu kopa B09.
|
|
- Valdības deklarācija, organizāciju reģistrs (VPK ID): [Valdibas-Deklaracija-as-Code](https://processgit.org/Valsts-Pirmkods/Valdibas-Deklaracija-as-Code).
|
|
- Valsts budžets: [Budget-as-Code](https://processgit.org/Valsts-Pirmkods/Budget-as-Code).
|