# Likums-as-Code

Latvijas Republikas likumi kā strukturēti dati: katrs likums ir viens XML fails, kas atbilst shēmai `schemas/likumi-0.1.xsd`. Tāds pats stils kā `MK-noteikumi-as-Code` (Act, TextVersion, Source, DataVersion, ID shēma, pārbaudes).

PPP Asociācijas (PPPA) pilotprojekta **Valsts PirmKods** daļa. Dati katru dienu tiek ielādēti PPPA Valsts Datu Ezerkrātuvē kā datu kopa **B20**; datu līgums — [contracts/B20-likumi.odcs.yaml](contracts/B20-likumi.odcs.yaml).

> Šie nav oficiāli dati. Juridiski saistošs ir oficiālajā izdevumā „Latvijas Vēstnesis” publicētais teksts.

## Struktūra

```
Likums-as-Code/
├── schemas/likumi-0.1.xsd     # shēma, nosaukumtelpa urn:pppa:vpk:likumi:0.1
├── data/<id>.xml              # viens fails katram likumam
├── verification/<id>.verify.json
├── tools/convert.py           # likumi.lv konsolidētā teksta Word → XML
├── tools/validate.py          # XSD + faila nosaukums = @id
├── likumi.yaml                # katalogs
├── contracts/B20-likumi.odcs.yaml  # datu līgums (ODCS v3)
└── README.md
```

## Dokumenta uzbūve

`Law @id` → `Act` (rekvizīti), `TextVersion` (redakcija un grozījumi), `Source` (iesniegtais fails, SHA-256), `EnactingFormula`, `Body` (`Chapter` → `Article` → `Part` → `Point` → `Point`), `TransitionalProvisions`, `EuReference`, `InForceStatement`, `Adoption`, `Promulgation`, `Signatory`, `Annex`, `DataVersion`.

- `TextVersion @basis`: `consolidated` (konsolidētā redakcija, `@asOf` = attēlotās redakcijas datums) vai `original`.
- `Article`, `Part`, `Point @status`: `in_force` vai `deleted` (izslēgta vienība paliek failā ar izslēgšanas tekstu).
- `Note`: redakcijas atzīmes "(Ar grozījumiem, kas izdarīti ar …)" un "(… likuma redakcijā …)" pie attiecīgās vienības.
- `kind`: apraksta birka (purpose, scope, definition, lead, item, provision, delegation, in_force, transitional, deleted), nevis juridiska klasifikācija.

## Avots: likumi.lv lapa (HTML)

`tools/convert.py` pieņem arī likumi.lv likuma lapu (`<likumi_id>.html`) — Word eksportu nevar lejupielādēt automātiski.
`tools/html_source.py` no lapas izveido to pašu rindkopu secību, ko dod Word fails, un convert.py to strukturē ar tiem pašiem noteikumiem.

```
python3 tools/html_source.py fetch <likumi_id> <kešs>    # lapa + grozījumu likumu lapas
python3 tools/convert.py <kešs>/<likumi_id>.html data/<id>.xml
```

- Numuri (pants, daļa, punkts) lapā ir drukāti tekstā, tāpēc tie tiek ņemti tieši, nevis skaitīti kā Word numerācijā.
- Grozījumu saraksts (`TextVersion/Amendment`) tiek veidots no grozījumu likumiem, uz kuriem atsaucas redakcijas piezīmes,
  un katra grozījuma lapas pases (pieņemts, publicēts, stājas spēkā). Grozījums, kas tekstā neatstāja piezīmi
  (piem., valūtas maiņa uz eiro), sarakstā var nebūt.
- Iestarpināta nodaļa: „II¹ nodaļa” → `c2.1` (`n="2¹"`), „Piektā A nodaļa” → `c5.1` (`n="5A"`).
- Panti bez nosaukuma („2.pants. (1) …”) un izslēgti panti („28.pants. (Izslēgts …)”) tiek atpazīti.
- Bloki pēc paraksta, kas nav likuma teksts (piem., „PIEZĪMES”), un izslēgtas atsauces uz regulām netiek iekļauti; tie ir verification failā.
- Kataloga ierakstiem no HTML ir `likumi_id` un `source: html`.
- Ja noslēgumā nav „Likums Saeimā pieņemts …” (piem., Augstākās Padomes likumi), pieņemšanas datums tiek ņemts no likumi.lv pases; tas ir verification failā.
- ES atsauce ar vienu aktu bez saraksta: ievadteikums kļūst par vienīgo `Item`. CELEX tiek noteikts arī formai „(ES) 2022/2557” (direktīva L, regula R, lēmums D).
- Sadaļa virs nodaļām („A sadaļa …”, piem., PPP likums, kapitāla daļu likums) → `Chapter kind="division"`, ID `…sA`; nodaļas ir tajā ieliktas, to ID paliek pēc drukātā numura (`c1` … `c30`).
- Pielikumi (likumi.lv bloki pēc paraksta) → `Annex` ar `Heading`, `Title` un `Line` katrai rindkopai vai tabulas rindai (šūnas atdalītas ar „ | ”); „1.¹ pielikums” → `ann1s1`. Pielikumu teksts ir pilnības skaitā.
- Divi likumi, pieņemti vienā dienā: otrais saņem ID ar `-2` (… `-9`), izšķir `likumi.yaml` pēc `likumi_id` (piem., `lv-lik-2002-10-31-2`).
- Pants, kas pieņemts, bet vēl nav spēkā (likumi.lv rāda tikai nosaukumu un piezīmi „Pants stājas spēkā … un iekļauts likuma redakcijā uz …”) → `status="pending"`, bez teksta.
- Numuru varianti: „8.pants (1) …” (bez punkta), „644.¹⁸A pants” → `art644s18a`, pārejas noteikumu „48.¹ …” → `tp.p48s1`.
- Augstākās Padomes likumu paraksti („Latvijas Republikas Augstākās Padomes priekšsēdētājs …”, „… sekretārs …”) → `Signatory`.
- Lielapjoma ielāde: tiek ieņemts tikai fails, kas atbilst XSD un kura teksta pilnība ir 99–101 %; pārējie paliek ārpus `data/` ar iemeslu atskaitē.

Salīdzinājums ar Word avotu (lv-lik-2000-10-19): tie paši nodaļu, pantu un daļu identifikatori, tie paši rekvizīti un noslēgums;
HTML versijā 12 vietās nav Word eksporta salipušo punktu, un tai nav neviena konvertora lēmuma pārbaudei (Word: 15).

## Identifikatori

| Vienība | Paraugs | Piemērs |
|---|---|---|
| Likums | `lv-lik-<pieņemšanas datums>[-N]` | `lv-lik-2000-10-19` |
| Nodaļa | `<id>.cN` | `lv-lik-2000-10-19.c2` |
| Pants | `<id>.artN`, 28¹ → `art28s1` | `lv-lik-2000-10-19.art28s1` |
| Daļa | `<pants>.dN`, 4¹ → `d4s1` | `lv-lik-2000-10-19.art10.d4s1` |
| Punkts | `<…>.pN` (rekursīvi) | `lv-lik-2000-10-19.art2.d2.p7` |
| Pārejas noteikumi | `<id>.tp`, `<id>.tp.pN` | `lv-lik-2000-10-19.tp.p31.p1` |
| ES atsauce | `<id>.eu`, `<id>.eu.N` | `lv-lik-2000-10-19.eu.2` |
| Pielikums | `<id>.annN` | `lv-lik-2000-10-19.ann1` |

Likumiem nav numura, tāpēc ID pamatā ir Saeimas pieņemšanas datums. Vienā datumā pieņemtus likumus atšķir ar `-2`, `-3`.

## Akoma Ntoso

Shēma nav Akoma Ntoso, bet ir pārveidojama uz to bez informācijas zuduma:

| likumi-0.1 | Akoma Ntoso (OASIS LegalDocML) |
|---|---|
| `Law` | `akomaNtoso/act` |
| `Act` | `meta/identification` FRBRWork (datums, izdevējs, veids) |
| `TextVersion @asOf` | FRBRExpression (`FRBRdate`), `meta/lifecycle` |
| `TextVersion/Amendment` | `lifecycle/eventRef` + `passiveModifications` |
| `Source` | FRBRManifestation |
| `EnactingFormula` | `preamble/formula` |
| `Chapter` | `chapter` (eId `chap_N`); `kind="division"` → `part` (eId `part_A`) |
| `Article` | `article` (eId `art_N`) |
| `Part` | `paragraph` (eId `art_N__para_M`) |
| `Point` | `point` (eId `…__point_K`) |
| `TransitionalProvisions` | `hcontainer name="transitional"` |
| `Note` | `authorialNote` |
| `Annex` | `attachments/attachment` (eId `att_N`) |
| `InForceStatement`, `Adoption`, `Promulgation`, `Signatory` | `conclusions` |

ID pārveide: `.c` → `chap_`, `.art` → `art_`, `.d` → `__para_`, `.p` → `__point_`, `s1` → `_1` (piem., `art10.d4s1` → `art_10__para_4_1`). Pārveidotājs `tools/to_akn.py` vēl nav izveidots.

## Pārbaudes

`tools/validate.py`: XSD (struktūra, ID formāts, ID unikalitāte) un faila nosaukums = `@id`.
`tools/convert.py` katram failam raksta `verification/<id>.verify.json`: vienību skaits, avota un XML teksta zīmju skaits (bez atstarpēm) un saraksts ar vietām, kur konvertors pieņēma lēmumu (piem., Word numurs "41" interpretēts kā daļa 4¹, nenumurēta rindkopa pievienota iepriekšējai vienībai). Šīs vietas pārbauda cilvēks.

## Statuss

Paraugs: 1 likums ("Par sabiedrisko pakalpojumu regulatoriem", redakcija uz 2026-04-03) — 9 nodaļas, 57 panti, 248 daļas, 131 punkts, 73 redakcijas atzīmes, 21 grozījums; XSD derīgs; teksta pilnīgums 99,4 % (76 028 no 76 482 zīmēm); 15 vietas pārbaudei.

Avota Word failā daži vārdi ir salipuši (piem., "izveidesun"); konvertors tekstu nelabo.