MK-Lemumi-as-Code/contracts/B17-tap-politikas-jomas.source.odcs.yaml

# ODCS v3 datu līgums: B17 TAP politikas jomas — AVOTS (Valsts kancelejas JSON:API datne, kā publicēta data.gov.lv).
# Shēma: schemas/tap-politikas-jomas-0.1.schema.json. Datus VDE neglabā ProcessGit: tie tiek lasīti no portāla katru dienu.
apiVersion: v3.0.2
kind: DataContract
id: urn:pppa:cac:contract:B17-source
name: TAP politikas jomas — avota datne
version: 0.1.0
status: active
domain: Valsts kā kods (Country as Code)
dataProduct: TAP klasifikatori
tenant: PPP Asociācija (PPPA)
description:
  purpose: Tiesību aktu portāla (TAP) politikas jomu klasifikācija divos līmeņos (virsjoma un joma), ar kuru TAP klasificē katru tiesību akta
    projektu.
  usage: Avots datu kopai B17 VDE. Datnes tiek lejupielādētas no portāla, validētas pret JSON shēmu schemas/tap-politikas-jomas-0.1.schema.json
    un ielādētas Bronze slānī, kā saņemtas.
  limitations: Klasifikācija nav sasaistīta ar budžeta funkcijām vai ministriju resoriem; tā ir TAP tematiskā klasifikācija.
servers:
- server: data.gov.lv
  type: custom
  format: json
  description: Latvijas Atvērto datu portāls (CKAN); JSON:API datnes
  customProperties:
  - property: dataset
    value: https://data.gov.lv/dati/lv/dataset/tap-politikas-jomas
  - property: api
    value: https://data.gov.lv/dati/api/3/action/package_show?id=tap-politikas-jomas
  - property: filePattern
    value: policy_areas\.json$
  - property: encoding
    value: utf-8
  - property: jsonSchema
    value: https://processgit.org/Valsts-Pirmkods/MK-Lemumi-as-Code/src/branch/main/schemas/tap-politikas-jomas-0.1.schema.json
schema:
- name: politikas_joma
  logicalType: object
  physicalType: json-api-resource
  physicalName: policy_areas.json#/data[]
  description: Viens ieraksts = viena politikas joma; virsjomai parent_id nav.
  customProperties:
  - property: lakehouseTable
    value: cac_bronze.tap_policy_area
  - property: key
    value: id
  properties:
  - name: area_id
    physicalName: id
    logicalType: string
    required: true
    primaryKey: true
    description: TAP identifikators (UUID)
  - name: name
    physicalName: attributes.name
    logicalType: string
    required: true
    description: Nosaukums
  - name: parent_id
    physicalName: relationships.parent_value.data.id
    logicalType: string
    required: false
    description: Virsjoma (TAP identifikators)
  - name: active_from
    physicalName: attributes.active_from
    logicalType: date
    required: true
    description: Spēkā no
  - name: active_to
    physicalName: attributes.active_to
    logicalType: date
    required: false
    description: Spēkā līdz
quality:
- name: json_schema_valid
  type: custom
  engine: json-schema
  implementation: schemas/tap-politikas-jomas-0.1.schema.json
  description: Katra datne atbilst JSON shēmai (JSON:API struktūra, identifikatori, datumi)
  dimension: conformity
- name: key_unique
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:key_unique
  description: Identifikators (id) ir unikāls
  dimension: uniqueness
- name: parent_exists
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:parent_exists
  description: Virsjoma (parent_id), ja norādīta, ir klasifikācijā
  dimension: consistency
slaProperties:
- property: frequency
  value: 1
  unit: d
  element: pārbaude katru dienu (cron 03:30 UTC); ielāde, ja datne portālā vai līgums mainījies
- property: latency
  value: 1
  unit: d
  element: Valsts kanceleja atjauno datni katru dienu
team:
- role: owner
  name: Valsts kanceleja (Tiesību aktu portāls)
- role: data steward
  name: PPP Asociācija (PPPA)
support:
- channel: web
  url: https://tapportals.mk.gov.lv
  description: Datu turētājs (Valsts kanceleja)
- channel: issues
  url: https://processgit.org/Valsts-Pirmkods/MK-Lemumi-as-Code/issues
  description: Līgums un shēma (PPPA)
customProperties:
- property: sourceId
  value: B17
- property: licence
  value: CC0-1.0