id: https://nde.nl/ontology/hc/class/OAIPMHSet
name: oai_pmh_set
title: OAIPMHSet Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
imports:
  - linkml:types
  - ../slots/specificity_annotation
  - ./SpecificityAnnotation
  - ../slots/template_specificity
  - ./TemplateSpecificityScores
default_prefix: hc

classes:
  OAIPMHSet:
    class_uri: hc:OAIPMHSet
    description: |
      Represents an OAI-PMH Set (collection) available for selective harvesting.

      Sets provide hierarchical organization of records, allowing harvesters
      to request records from specific collections.

      Set hierarchies use colon separator: "category:subcategory:item"
    attributes:
      spec:
        slot_uri: dcterms:identifier
        description: |
          Set specification (setSpec).

          Machine-readable identifier used in OAI-PMH requests.

          Hierarchy indicated by colons (e.g., "photo:portraits:19th-century").

          Example: "foto"
        range: string
        required: true
      name:
        slot_uri: schema:name
        description: |
          Human-readable set name (setName).

          Example: "Fotografische documenten"
        range: string
        required: true
      description:
        slot_uri: dcterms:description
        description: |
          Optional description of the set contents.
        range: string
      parent_spec:
        slot_uri: schema:isPartOf
        description: |
          Parent set specification for hierarchical sets.

          If spec is "photo:portraits", parent_spec would be "photo".
        range: string
      record_count:
        slot_uri: schema:numberOfItems
        description: |
          Approximate number of records in this set.

          Not part of OAI-PMH spec but useful if available.
        range: integer
    slots:
      - specificity_annotation
      - template_specificity
    slot_usage:
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true