MK-Lemumi-as-Code/contracts/B07-tap-publicetie-tiesibu-akti.source.odcs.yaml

# ODCS v3 datu līgums: B07 TAP publicētie tiesību akti — AVOTS (Valsts kancelejas JSON:API mēneša datnes, kā publicētas data.gov.lv).
# Shēma: schemas/tap-publicetie-tiesibu-akti-0.1.schema.json. Klasifikatori: B18 (veidi), B17 (politikas jomas). Datus VDE neglabā ProcessGit.
apiVersion: v3.0.2
kind: DataContract
id: urn:pppa:cac:contract:B07-source
name: TAP publicētie tiesību akti — avota datnes
version: 0.1.0
status: active
domain: Valsts kā kods (Country as Code)
dataProduct: TAP tiesību akti
tenant: PPP Asociācija (PPPA)
description:
  purpose: 'Tiesību aktu portālā (TAP) pieņemtie un izskatītie tiesību aktu projekti ar sākotnējās ietekmes novērtējuma ziņojumu (anotāciju):
    TAP identifikators (piem. 26-TA-2145), nosaukums, veids, atbildīgā institūcija, virzības stadija, politikas jomas, atzinumu sniedzējas institūcijas
    un dokumentu saites.'
  usage: Avots datu kopai B07 VDE. Datnes tiek lejupielādētas no portāla, validētas pret JSON shēmu schemas/tap-publicetie-tiesibu-akti-0.1.schema.json
    un ielādētas Bronze slānī, kā saņemtas.
  limitations: Viena datne par katru mēnesi kopš 2021. gada septembra; kārtējā mēneša datne parādās pēc mēneša beigām. Dokumentu teksts datnēs
    nav — tikai saites uz TAP. Atbildīgā institūcija norādīta ar nosaukumu, nevis kodu; VPK ID tiek piesaistīts pēc nosaukuma. Portālā vienam
    mēnesim reizēm ir divas datnes ar vienādu nosaukumu; ielādē jaunāko.
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-publicetie-tiesibu-akti
  - property: api
    value: https://data.gov.lv/dati/api/3/action/package_show?id=tap-publicetie-tiesibu-akti
  - property: filePattern
    value: legal_acts_(\d{4}-\d{2})-01-\d{4}-\d{2}-\d{2}\.json$
  - property: encoding
    value: utf-8
  - property: jsonSchema
    value: https://processgit.org/Valsts-Pirmkods/MK-Lemumi-as-Code/src/branch/main/schemas/tap-publicetie-tiesibu-akti-0.1.schema.json
schema:
- name: tiesibu_akts
  logicalType: object
  physicalType: json-api-resource
  physicalName: legal_acts_<GGGG-MM>-….json#/data[]
  description: Viens ieraksts = viens tiesību akta projekts TAP.
  customProperties:
  - property: lakehouseTable
    value: cac_bronze.tap_legal_act
  - property: key
    value: id
  properties:
  - name: act_id
    physicalName: id
    logicalType: string
    required: true
    primaryKey: true
    description: TAP identifikators (UUID)
  - name: identificator
    physicalName: attributes.identificator
    logicalType: string
    required: true
    description: TAP projekta numurs (GG-TA-…; 2021. gadā GGGG-TA-…)
    logicalTypeOptions:
      pattern: '([0-9]{2}|[0-9]{4})-TA-[0-9A-Za-z]+'
  - name: name
    physicalName: attributes.name
    logicalType: string
    required: true
    description: Nosaukums
  - name: type_id
    physicalName: relationships.legal_act_type.data.id
    logicalType: string
    required: true
    description: Tiesību akta veids (B18)
  - name: responsible_institution
    physicalName: attributes.responsible_institution_name
    logicalType: string
    required: true
    description: Atbildīgā institūcija (nosaukums)
  - name: progress
    physicalName: attributes.progress_name
    logicalType: string
    required: true
    description: Virzības stadija
  - name: submitted_at
    physicalName: attributes.submitted_at
    logicalType: timestamp
    required: false
    description: Iesniegšanas laiks
  - name: due_at
    physicalName: attributes.due_at
    logicalType: timestamp
    required: false
    description: Termiņš
  - name: policy_area_ids
    physicalName: relationships.policy_areas.data[].id
    logicalType: string
    required: false
    description: Politikas jomas (B17), atdalītas ar atstarpi
  - name: reviewers
    physicalName: attributes.reviewer_institutions
    logicalType: array
    required: false
    description: Atzinumu sniedzējas institūcijas (kods, nosaukums), JSON
  - name: web
    physicalName: links.web
    logicalType: string
    required: true
    description: Saite uz projektu TAP
  - name: period
    physicalName: (datnes nosaukums)
    logicalType: string
    required: true
    description: Datnes mēnesis GGGG-MM
  - name: source_file
    physicalName: (datnes nosaukums)
    logicalType: string
    required: true
    description: Datnes nosaukums portālā
- name: tiesibu_akta_dokuments
  logicalType: object
  physicalType: json-api-resource
  physicalName: legal_acts_<GGGG-MM>-….json#/included[]
  description: Viens ieraksts = viena dokumenta versija vai papildu dokuments (izziņa, anotācija u.c.) pie projekta.
  customProperties:
  - property: lakehouseTable
    value: cac_bronze.tap_legal_act_document
  - property: key
    value: act_id, document_id
  properties:
  - name: act_id
    physicalName: (relationships no data[])
    logicalType: string
    required: true
    primaryKey: true
    description: Projekts
  - name: document_id
    physicalName: id
    logicalType: string
    required: true
    primaryKey: true
    description: Dokumenta identifikators
  - name: kind
    physicalName: type
    logicalType: string
    required: true
    description: version (legal_act_document_versions) vai additional (legal_act_additional_documents)
  - name: name
    physicalName: attributes.name
    logicalType: string
    required: true
    description: Dokumenta nosaukums
  - name: file_name
    physicalName: attributes.upload_file_name
    logicalType: string
    required: false
    description: Datnes nosaukums (papildu dokumentam)
  - name: url
    physicalName: attributes.items[].url | links.file
    logicalType: string
    required: false
    description: Saite
quality:
- name: json_schema_valid
  type: custom
  engine: json-schema
  implementation: schemas/tap-publicetie-tiesibu-akti-0.1.schema.json
  description: Katra datne atbilst JSON shēmai (JSON:API struktūra, identifikatori, datumi)
  dimension: conformity
- name: one_file_per_period
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:one_file_per_period
  description: Katram mēnesim portālā ir viena datne (ja divas — ielādē jaunāko un reģistrē)
  dimension: completeness
- name: key_unique
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:key_unique
  description: Projekta identifikators (id) un TAP numurs ir unikāli visās datnēs
  dimension: uniqueness
- name: type_in_classifier
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:type_in_classifier
  description: Projekta veids ir TAP tiesību aktu veidu klasifikācijā (B18)
  dimension: consistency
- name: policy_area_in_classifier
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:policy_area_in_classifier
  description: Katra projekta politikas joma ir TAP politikas jomu klasifikācijā (B17)
  dimension: consistency
- name: responsible_institution_in_register
  type: custom
  engine: cac-lakehouse
  implementation: app.cac_tap:responsible_institution_in_register
  description: Atbildīgās institūcijas nosaukums atrodams Organizāciju reģistrā (B01, VPK ID)
  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: month
  element: Mēneša datne parādās portālā pēc mēneša beigām
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: B07
- property: licence
  value: CC0-1.0