glam/schemas/20251121/linkml/modules/classes/AllocationAgency.yaml

id: https://nde.nl/ontology/hc/class/AllocationAgency
name: allocation_agency
title: Allocation Agency Class
prefixes:
  linkml: https://w3id.org/linkml/
  schema: http://schema.org/
  org: http://www.w3.org/ns/org#
  gleif_base: https://www.gleif.org/ontology/Base/
imports:
- linkml:types
- ../metadata
- ./Standard
- ./RegistrationAuthority
- ./Country
- ./Subregion
- ../slots/description
- ../slots/website
- ../slots/contact_email
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
classes:
  AllocationAgency:
    class_uri: org:FormalOrganization
    description: "An organization that allocates identifiers within a specific geographic\
      \ area \nand/or domain of heritage institutions.\n\n**Key Distinction from RegistrationAuthority:**\n\
      \n- **RegistrationAuthority**: Maintains the GLOBAL registry for a standard\n\
      \  - Example: Danish Agency for Culture and Palaces maintains global ISIL registry\n\
      \  - Example: ISNI International Agency (WIPO) maintains global ISNI database\n\
      \n- **AllocationAgency**: Allocates identifiers LOCALLY within constraints\n\
      \  - Example: Koninklijke Bibliotheek allocates ISIL for Dutch public libraries\n\
      \  - Example: OCLC allocates ISIL for Dutch academic libraries\n  - Example:\
      \ Nationaal Archief allocates ISIL for Dutch archives\n\n**Multi-Dimensional\
      \ Scope:**\n\nAllocationAgencies have both:\n1. **Geographic scope**: Which\
      \ country/region they serve\n2. **Domain scope**: Which types of institutions\
      \ they serve\n\nThis allows multiple agencies per country, each serving different\
      \ domains:\n- NL public libraries → KB\n- NL academic libraries → OCLC\n- NL\
      \ archives → Nationaal Archief\n\n**Relationship to Standard:**\n\nAn AllocationAgency\
      \ allocates for one or more Standards:\n- AllocationAgency.allocates_for → Standard[]\n\
      - Standard can have multiple AllocationAgencies (one per country/domain)\n\n\
      **Examples:**\n\n| Agency | Country | Domain | Standard |\n|--------|---------|--------|----------|\n\
      | Koninklijke Bibliotheek | NL | Public libraries | ISIL |\n| OCLC | NL | Academic\
      \ libraries | ISIL |\n| Nationaal Archief | NL | Archives | ISIL |\n| British\
      \ Library | GB | All | ISIL |\n| Library of Congress | US | All | ISIL |\n|\
      \ OCLC | Global | Academic | VIAF |\n| Deutsche Nationalbibliothek | DE | All\
      \ | ISNI |\n\n**Ontology Alignment:**\n\n- org:FormalOrganization - W3C Organization\
      \ Ontology\n- Extends gleif_base:RegistrationAuthority concept (but for allocation,\
      \ not registration)\n"
    exact_mappings:
    - org:FormalOrganization
    close_mappings:
    - gleif_base:RegistrationAuthority
    - schema:Organization
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: |
          Unique identifier for this allocation agency.

          Recommended format: {country}-{abbreviation} or {abbreviation}

          Examples: "nl-kb", "nl-oclc", "nl-na", "gb-bl", "us-loc"          
        range: uriorcurie
        required: true
      name:
        slot_uri: schema:name
        description: |
          Official full name of the allocation agency.

          Examples:
          - "Koninklijke Bibliotheek"
          - "Nationaal Archief"
          - "British Library"
          - "Library of Congress"          
        range: string
        required: true
      name_local:
        slot_uri: schema:alternateName
        description: |
          Name in local language (if different from English name).

          Examples:
          - "Koninklijke Bibliotheek" (Dutch)
          - "Deutsche Nationalbibliothek" (German)
          - "Bibliothèque nationale de France" (French)          
        range: string
      abbreviation:
        slot_uri: schema:alternateName
        description: |
          Common abbreviation.

          Examples: "KB", "NA", "BL", "LOC", "BnF", "DNB"          
        range: string
      country_scope:
        slot_uri: gleif_base:hasCoverageArea
        description: |
          Geographic area(s) where this agency allocates identifiers.

          Usually a single country, but can be multiple countries or subregions.

          Examples:
          - [NL] for Koninklijke Bibliotheek
          - [GB] for British Library
          - [US] for Library of Congress
          - [DE-BY, DE-BW] for regional German agency          
        range: Country
        multivalued: true
        required: true
        inlined: false
      subregion_scope:
        slot_uri: schema:areaServed
        description: |
          Subregion-level geographic scope (if more specific than country).

          For agencies that only serve specific regions within a country.

          Examples:
          - Staatsarchiv München: [DE-BY] (Bavaria only)          
        range: Subregion
        multivalued: true
        inlined: false
      allocation_domain:
        slot_uri: schema:audienceType
        description: |
          Types of institutions this agency allocates identifiers for.

          Multiple values allowed for agencies serving multiple domains.

          Examples:
          - KB: [LIBRARY_PUBLIC]
          - OCLC: [LIBRARY_ACADEMIC, LIBRARY_RESEARCH]
          - Nationaal Archief: [ARCHIVE]
          - British Library: [LIBRARY_PUBLIC, LIBRARY_ACADEMIC, ARCHIVE] (all types)          
        range: AllocationDomainEnum
        multivalued: true
        required: true
      allocates_for:
        slot_uri: schema:serviceOutput
        description: |
          Standards for which this agency allocates identifiers.

          Most agencies allocate for a single standard, but some handle multiple.

          Examples:
          - KB: [ISIL]
          - DNB: [ISIL, ISNI]
          - OCLC: [ISIL, VIAF]          
        range: Standard
        multivalued: true
        required: true
        inlined: false
      allocation_prefix:
        slot_uri: schema:identifier
        description: |
          Prefix used by this agency when allocating identifiers.

          For ISIL, this is typically the country code.

          Examples:
          - Netherlands ISIL: "NL-"
          - Germany ISIL: "DE-"
          - UK ISIL: "UK-" or "GB-" (both used historically)          
        range: string
      parent_registration_authority:
        slot_uri: schema:parentOrganization
        description: |
          The registration authority to which this agency reports allocations.

          AllocationAgencies report their allocations to the global RegistrationAuthority.

          Examples:
          - KB (NL ISIL) → Danish Agency for Culture and Palaces
          - DNB (DE ISNI) → ISNI International Agency          
        range: RegistrationAuthority
        inlined: false
      allocation_start_date:
        slot_uri: schema:startDate
        description: |
          Date when this agency started allocating identifiers.

          Format: ISO 8601 date          
        range: date
      allocation_end_date:
        slot_uri: schema:endDate
        description: |
          Date when this agency stopped allocating (if no longer active).

          Null if still active.          
        range: date
      is_active:
        slot_uri: schema:status
        description: Whether this agency is currently allocating identifiers
        range: boolean
        required: true
      website:
        slot_uri: schema:url
        description: |
          Official website of the allocation agency.

          Preferably the page about identifier allocation services.          
        range: uri
      contact_email:
        slot_uri: schema:email
        description: |
          Contact email for identifier allocation requests.

          Examples: "isil@kb.nl", "isni@dnb.de"          
        range: string
      allocation_policy_url:
        slot_uri: schema:usageInfo
        description: |
          URL to the allocation policy documentation.

          Describes eligibility, process, requirements for obtaining identifiers.          
        range: uri
      description:
        slot_uri: schema:description
        description: Description of the agency's allocation services and scope
        range: string
    slots:
    - specificity_annotation
    - template_specificity
    slot_usage:
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
enums:
  AllocationDomainEnum:
    description: |
      Types of heritage institutions that an AllocationAgency can serve.

      Based on GLAMORCUBESFIXPHDNT taxonomy but focused on allocation domains.      
    permissible_values:
      LIBRARY_PUBLIC:
        description: |
          Public libraries (openbare bibliotheken).
          Examples: Municipal libraries, regional libraries          
      LIBRARY_ACADEMIC:
        description: |
          Academic and university libraries.
          Examples: University libraries, polytechnic libraries          
      LIBRARY_RESEARCH:
        description: |
          Research and special libraries.
          Examples: Corporate libraries, government agency libraries          
      LIBRARY_NATIONAL:
        description: |
          National libraries.
          Examples: Koninklijke Bibliotheek, Library of Congress          
      ARCHIVE:
        description: |
          Archives of all types.
          Examples: National archives, regional archives, municipal archives          
      MUSEUM:
        description: |
          Museums of all types.
          Examples: Art museums, history museums, science museums          
      GALLERY:
        description: |
          Art galleries and exhibition spaces.
          Examples: Commercial galleries, kunsthallen          
      HERITAGE_SOCIETY:
        description: |
          Heritage and historical societies.
          Examples: Heemkundige kringen, genealogical societies          
      RESEARCH_ORGANIZATION:
        description: |
          Research organizations and documentation centers.
          Examples: Research institutes, knowledge centers          
      EDUCATION_PROVIDER:
        description: |
          Educational institutions with heritage collections.
          Examples: Universities, academies          
      RELIGIOUS_INSTITUTION:
        description: |
          Religious institutions with collections.
          Examples: Church archives, monastery libraries          
      GOVERNMENT_AGENCY:
        description: |
          Government agencies and official institutions.
          Examples: Ministries, provincial heritage services          
      ALL:
        description: |
          Agency allocates for all institution types.
          Used when there's a single national agency for all domains.