# ODCS v3 datu līgums: B23 Valsts pārvaldes pakalpojumi — AVOTS (VIRSIS CSV, kā publicēts data.gov.lv).
# Apraksta, ko VDE sagaida no VARAM publicētās datnes. Ja kolonnas vai klasifikācijas vērtības mainās, ielāde to konstatē un reģistrē.
# Datus VDE neglabā ProcessGit: tie tiek lasīti no portāla katru dienu, pārbaudīti pret šo līgumu un ielādēti Bronze slānī, kā saņemti.
apiVersion: v3.0.2
kind: DataContract
id: urn:pppa:cac:contract:B23-source
name: Valsts pārvaldes pakalpojumi — VIRSIS avota datne
version: 0.1.0
status: active
domain: Valsts kā kods (Country as Code)
dataProduct: Valsts pārvaldes pakalpojumi
tenant: PPP Asociācija (PPPA)
description:
  purpose: >-
    Valsts pārvaldes publisko pakalpojumu un starpiestāžu IKT pakalpojumu saraksts, kā reģistrēts sistēmā VIRSIS (valsts un pašvaldību iestādes, arī kapitālsabiedrības un biedrības, kas sniedz pakalpojumus). Pakalpojums tiek sasaistīts ar iestādi (B01 VPK ID, B02 reģistrācijas numurs vai B04 ATVK), ar iestādes funkcijām un darbiem (B22), informācijas sistēmām (B25) un informācijas resursiem (B24).
  usage: Avots datu kopai B23 VDE. Datne tiek lejupielādēta, pārbaudīta pret šo līgumu un ielādēta Bronze slānī, kā saņemta.
  limitations: >-
    Avotā iestāde norādīta ar nosaukumu, ne identifikatoru. Avotā nav saites starp pakalpojumu, sistēmu un informācijas resursu, nav tiesiskā pamata, kanālu, maksas un sniegšanas apjoma. Vairāk nekā puse ierakstu ir pašvaldību pakalpojumi. Ieraksta izzušana no datnes nenozīmē, ka pakalpojums likvidēts.
servers:
- server: data.gov.lv
  type: custom
  format: csv
  description: Latvijas Atvērto datu portāls (CKAN), datu kopa „Valsts informācijas sistēmu un pakalpojumu dati” (VARAM)
  customProperties:
  - {property: dataset, value: "https://data.gov.lv/dati/lv/dataset/valsts-informacijas-sistemu-un-pakalpojumu-dati"}
  - {property: api, value: "https://data.gov.lv/dati/api/3/action/package_show?id=valsts-informacijas-sistemu-un-pakalpojumu-dati"}
  - {property: resource, value: "dc7ef432-5b35-44bc-babe-546f4b0fc4e6"}
  - {property: encoding, value: utf-8-sig}
  - {property: delimiter, value: ","}
  - {property: quote, value: "\""}
schema:
- name: pakalpojumi
  logicalType: object
  physicalType: csv-file
  physicalName: pakalpojumi-tai-skaita-ikt-pakalpojumi.csv
  description: Viena rinda = viens pakalpojums. Kolonnu secība ir fiksēta; virsrakstu rinda ir obligāta; teksts var saturēt rindu pārnesumus.
  customProperties:
  - {property: filePattern, value: "pakalpojumi-tai-skaita-ikt-pakalpojumi\\.csv$"}
  - {property: lakehouseTable, value: cac_bronze.virsis_service}
  - {property: key, value: "VIRSIS ID"}
  properties:
  - {name: nosaukums, physicalName: "Nosaukums", logicalType: string, required: true,
     description: "Nosaukums"}
  - {name: iestade, physicalName: "Iestāde", logicalType: string, required: true,
     description: "Iestāde, kā avotā (nosaukums, ne identifikators); VPK ID, reģistrācijas numuru vai ATVK kodu piešķir nosaukumu sasaiste Organizations_register"}
  - {name: apraksts, physicalName: "Īss apraksts", logicalType: string, required: false,
     description: "Īss apraksts (var būt vairākas rindkopas)"}
  - {name: virsis_id, physicalName: "VIRSIS ID", logicalType: string, required: true, primaryKey: true,
     description: "Ieraksta identifikators sistēmā VIRSIS (skaitlis)", logicalTypeOptions: {pattern: "[0-9]{1,9}"}}
  - {name: veids_publiskais, physicalName: "Pakalpojuma veids (publiskais)", logicalType: string, required: true,
     description: "Publiskā pakalpojuma veids",
     quality: [{type: library, rule: validValues, validValues: ["Publisks individuāla labuma", "Publisks vispārēja labuma", "Pakalpojums nav publisks"]}]}
  - {name: veids_starpiestazu, physicalName: "Pakalpojuma veids (starpiestāžu)", logicalType: string, required: true,
     description: "Starpiestāžu pakalpojuma veids",
     quality: [{type: library, rule: validValues, validValues: ["Pakalpojums nav starpiestāžu", "Starpiestāžu individuālas lietošanas", "Starpiestāžu koplietošanas"]}]}
  - {name: tips, physicalName: "Pakalpojuma tips", logicalType: string, required: true,
     description: "Pakalpojuma sniedzēja tips",
     quality: [{type: library, rule: validValues, validValues: ["Pašvaldības un to iestādes", "Valsts pārvalde (izņemot pašvaldības)", "Valsts pārvalde (tiešās valsts pārvaldes iestādes un citas, izņemot pašvaldības)", "Citas", "Komersanti", "Biedrības un nodibinājumi"]}]}
  - {name: klase, physicalName: "Pakalpojuma klase", logicalType: string, required: true,
     description: "Pakalpojuma klase",
     quality: [{type: library, rule: validValues, validValues: ["Cits", "Informācijas izplatīšana", "IT citi pakalpojumi", "Valsts pārvaldes pakalpojums", "Citi informācijas pakalpojumi", "Programmatūra", "Aparatūra", "Informācijas apstrāde un analīze", "Informācijas ievadīšana"]}]}
quality:
- {name: source_columns_match, type: custom, engine: cac-lakehouse, implementation: "app.cac_virsis:source_columns_match",
   description: "Datnes virsrakstu rinda sakrīt ar līgumā noteiktajām kolonnām un to secību", dimension: conformity}
- {name: source_values_valid, type: custom, engine: cac-lakehouse, implementation: "app.cac_virsis:source_values_valid",
   description: "Obligātās kolonnas aizpildītas; vērtības atbilst šablonam vai pieļaujamo vērtību sarakstam", dimension: validity}
- {name: source_key_unique, type: custom, engine: cac-lakehouse, implementation: "app.cac_virsis:source_key_unique",
   description: "VIRSIS ID datnē ir unikāls", dimension: uniqueness}
- {name: institution_name_resolved, type: custom, engine: cac-lakehouse, implementation: "app.cac_virsis:institution_name_resolved",
   description: "Iestādes nosaukums ir nosaukumu sasaistē (Organizations_register) un tam piešķirts VPK ID, reģistrācijas numurs vai ATVK kods", dimension: completeness}
slaProperties:
- {property: frequency, value: 1, unit: d, element: "pārbaude katru dienu; ielāde, ja datne portālā vai līgums mainījies"}
- {property: latency, value: 1, unit: d, element: "Datu kopas metadatos norādīta ikdienas atjaunošana; faktisko svaigumu VDE pārbauda"}
team:
- {role: owner, name: Viedās administrācijas un reģionālās attīstības ministrija (VARAM)}
- {role: data steward, name: PPP Asociācija (PPPA)}
support:
- {channel: web, url: "https://data.gov.lv/dati/lv/dataset/valsts-informacijas-sistemu-un-pakalpojumu-dati", description: Datu kopa portālā}
- {channel: issues, url: "https://processgit.org/Valsts-Pirmkods/Pakalpojumi-as-Code/issues", description: Līgums (PPPA)}
customProperties:
- {property: sourceId, value: B23}
- {property: licence, value: CC0-1.0}