# ODCS v3 datu līgums: B04 Pašvaldību reģistrs (ATVK)
# Ģenerēts no schemas/pasvaldibu-registrs-0.1.xsd (tools/xsd_to_odcs.py, lakehouse). Shēmas daļu nelabot ar roku — labot XSD un ģenerēt no jauna.
apiVersion: v3.0.2
kind: DataContract
id: urn:pppa:cac:contract:B04
name: Pašvaldību reģistrs (ATVK)
version: 0.1.0
status: active
domain: Valsts kā kods (Country as Code)
dataProduct: Pašvaldību reģistrs
tenant: PPP Asociācija (PPPA)
description:
  purpose: Vienots pašvaldības identifikators — ATVK kods (7 cipari) — ko lieto visas datu kopas (rīcības plāni, plānošanas dokumenti, budžets).
    Pašvaldībām VPK ID nepiešķir.
  usage: Mašīnlasāma datu apmaiņa; ielāde datu ezerā katru dienu.
  limitations: Saraksts no MK noteikumu Nr. 379 pielikuma (redakcija no 22.08.2026); vēl nav salīdzināts ar CSP KLASIS un Valsts adrešu reģistru;
    tikai ATVK pirmais līmenis (valstspilsētas un novadi).
servers:
- server: processgit
  type: custom
  format: xml
  description: ProcessGit repozitorijs (Gitea API v1)
  customProperties:
  - property: url
    value: https://processgit.org/Valsts-Pirmkods/Pasvaldibu-registrs
  - property: ref
    value: main
  - property: path
    value: data/pasvaldibas-atvk.xml
  - property: schema
    value: https://processgit.org/Valsts-Pirmkods/Pasvaldibu-registrs/src/branch/main/schemas/pasvaldibu-registrs-0.1.xsd
schema:
- name: Municipality
  logicalType: object
  physicalType: xml-element
  physicalName: Municipality
  description: ''
  properties:
  - name: atvk
    logicalType: string
    required: true
    logicalTypeOptions:
      pattern: '[0-9]{7}'
    description: ATVK kods — 7 cipari.
    primaryKey: true
    unique: true
  - name: kind
    logicalType: string
    required: true
    description: valstspilseta = valstspilsēta; novads = novads.
    quality:
    - type: library
      rule: validValues
      validValues:
      - valstspilseta
      - novads
  - name: validFrom
    logicalType: date
    required: false
  - name: validTo
    logicalType: date
    required: false
  - name: successor
    logicalType: string
    required: false
    logicalTypeOptions:
      pattern: '[0-9]{7}'
    description: Pašvaldība, kas turpina darbību (apvienošanas gadījumā).
  - name: Name
    logicalType: string
    required: true
    logicalTypeOptions:
      pattern: '[\s\S]*\S[\s\S]*'
    description: Teritorijas nosaukums, kā klasifikatorā (piemēram „Rīga”, „Madonas novads”).
  - name: FormerCode
    logicalType: array
    required: false
    description: Iepriekšējais ATVK kods; atkārtoti netiek izmantots.
    items:
      logicalType: string
  - name: FormerCode@until
    logicalType: date
    required: false
  customProperties:
  - property: lakehouseTable
    value: cac_bronze.pas_municipality
  - property: lakehouseTable
    value: cac_silver.municipality
quality:
- name: xsd_valid
  type: custom
  engine: xsd
  implementation: schemas/pasvaldibu-registrs-0.1.xsd
  description: Datne atbilst XSD shēmai; neatbilstoša datne tiek reģistrēta kā kļūda
  dimension: conformity
- name: former_code_not_current
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_processgit:former_code_not_current
  description: Iepriekšējais ATVK kods nav citas pašvaldības pašreizējais kods
  dimension: consistency
- name: budget_municipality_in_register
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_processgit:budget_municipality_in_register
  description: Budžeta likuma (B15) pašvaldība atrodama reģistrā pēc nosaukuma
  dimension: consistency
slaProperties:
- property: frequency
  value: 1
  unit: d
  element: pull ingest (cron 03:30 UTC)
- property: retention
  value: visas versijas (git vēsture)
team:
- role: owner
  name: Saeima (pašvaldību saraksts likumā), Ministru kabinets un Centrālā statistikas pārvalde (ATVK kodi); datu kopu sagatavo PPPA
- role: data steward
  name: PPP Asociācija (PPPA)
support:
- channel: issues
  url: https://processgit.org/Valsts-Pirmkods/Pasvaldibu-registrs/issues
customProperties:
- property: sourceId
  value: B04
- property: namespace
  value: urn:pppa:vpk:pasvaldibas:0.1
- property: rootElement
  value: MunicipalityRegistry
- property: identifiers
  value: ATVK kods (7 cipari); iepriekšējais kods — FormerCode