# ODCS v3 datu līgums: B21 Valsts pārvaldes funkciju katalogs (funkcijas kā kods)
# Shēma: schemas/funkcijas-0.1.xsd. Šī līguma schema daļa apraksta to, ko VDZP ielādē; pilnā struktūra ir XSD.
apiVersion: v3.0.2
kind: DataContract
id: urn:pppa:cac:contract:B21
name: Valsts pārvaldes funkciju katalogs (funkcijas kā kods)
version: 0.1.0
status: active
domain: Valsts PirmKods
dataProduct: Valsts funkciju reģistrs
tenant: PPP Asociācija (PPPA)
description:
  purpose: >-
    Valsts pārvaldes funkciju koks, pie kura sasaista likumu pilnvarojumus (B20), iestāžu nolikumu punktus (B05),
    budžeta izdevumus (B03) un sistēmas (B09). Nozaru funkcijas pēc valdības funkciju klasifikācijas (S),
    horizontālās funkcijas, kas jāveic katrai iestādei (H), ar tiesisko pamatu, turētāju un atslēgvārdiem.
  usage: Funkciju pārklājuma un dublēšanās analīze; funkciju iepirkuma sagatavošana; AI aģentu vaicājumi caur MCP.
  limitations: >-
    Koncepcijas demonstrācija, nav oficiāls klasifikators. Horizontālo funkciju saraksts un atslēgvārdi ir PPPA
    pirmā versija un tiek precizēti. Sasaiste pēc atslēgvārdiem ir kandidāti pārskatīšanai.
servers:
- server: processgit
  type: custom
  format: xml
  description: ProcessGit repozitorijs (Gitea API v1)
  customProperties:
  - {property: url, value: "https://processgit.org/Valsts-Pirmkods/Funkcijas-as-Code"}
  - {property: ref, value: main}
  - {property: path, value: "data/funkcijas.xml"}
  - {property: schema, value: "https://processgit.org/Valsts-Pirmkods/Funkcijas-as-Code/src/branch/main/schemas/funkcijas-0.1.xsd"}
schema:
- name: Function
  logicalType: object
  physicalType: xml-element
  physicalName: "//Function"
  customProperties: [{property: lakehouseTable, value: cac_bronze.fn_function}]
  properties:
  - {name: function_id, logicalType: string, required: true, primaryKey: true, physicalName: "@id", logicalTypeOptions: {pattern: "^[HS](\\.[0-9]{2,3})*$"}}
  - {name: parent_id, logicalType: string, required: false}
  - {name: kind, logicalType: string, required: true, physicalName: "@kind", quality: [{type: library, rule: validValues, validValues: [horizontal, sector]}]}
  - {name: level, logicalType: integer, required: true, physicalName: "@level"}
  - {name: name, logicalType: string, required: true, physicalName: Name}
  - {name: description, logicalType: string, required: false, physicalName: Description}
  - {name: cofog, logicalType: string, required: false, physicalName: Cofog}
- name: Basis
  logicalType: object
  physicalType: xml-element
  physicalName: "//Function/Basis"
  customProperties: [{property: lakehouseTable, value: cac_bronze.fn_basis}]
  properties:
  - {name: function_id, logicalType: string, required: true}
  - {name: unit, logicalType: string, required: true, physicalName: "@unit", description: "Likums-as-Code vienības ID (ietver apakšvienības)"}
  - {name: ref, logicalType: string, required: true}
- name: Holder
  logicalType: object
  physicalType: xml-element
  physicalName: "//Function/Holder"
  customProperties: [{property: lakehouseTable, value: cac_bronze.fn_holder}]
  properties:
  - {name: function_id, logicalType: string, required: true}
  - {name: holder_type, logicalType: string, required: true, physicalName: "@type", quality: [{type: library, rule: validValues, validValues: [every_institution, institution, cabinet, municipality, role]}]}
  - {name: vpk_id, logicalType: string, required: false, physicalName: "@vpkId"}
  - {name: label, logicalType: string, required: false}
- name: Keyword
  logicalType: object
  physicalType: xml-element
  physicalName: "//Function/Keyword"
  customProperties: [{property: lakehouseTable, value: cac_bronze.fn_keyword}]
  properties:
  - {name: function_id, logicalType: string, required: true}
  - {name: keyword, logicalType: string, required: true}
quality:
- {name: xsd_valid, type: custom, engine: xsd, implementation: schemas/funkcijas-0.1.xsd,
   description: "Datne atbilst XSD shēmai (funkciju ID unikāli)", dimension: conformity}
- {name: basis_unit_exists, type: custom, engine: cac-lakehouse, implementation: "app.cac_functions:basis_unit_exists",
   description: "Katrs tiesiskais pamats ir likums vai likuma vienība Likums-as-Code (B20)", dimension: consistency}
- {name: cofog_code_known, type: custom, engine: cac-lakehouse, implementation: "app.cac_functions:cofog_code_known",
   description: "Katrs funkciju klasifikācijas kods ir budžeta datos", dimension: consistency}
- {name: holder_vpk_in_register, type: custom, engine: cac-lakehouse, implementation: "app.cac_functions:holder_vpk",
   description: "Turētāja VPK ID ir Valsts institūciju reģistrā (B01)", dimension: consistency}
slaProperties:
- {property: frequency, value: 1, unit: d, element: "pull ingest katru dienu 06:30 Rīgas laikā"}
- {property: retention, value: "visas versijas (git vēsture)"}
team:
- {role: data steward, name: PPP Asociācija (PPPA)}
support:
- {channel: issues, url: "https://processgit.org/Valsts-Pirmkods/Funkcijas-as-Code/issues"}