# WikiDataIdentifier - A Wikidata Q-number identifier
# Created per slot_fixes.yaml migration for: wikidata_id, wikidata_entity_id, wikidata_entity
# Creation date: 2026-01-14

id: https://nde.nl/ontology/hc/classes/WikiDataIdentifier
name: WikiDataIdentifier
title: WikiDataIdentifier

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  wikidata: http://www.wikidata.org/entity/
  schema: http://schema.org/
  dct: http://purl.org/dc/terms/

imports:
  - linkml:types

default_range: string

classes:
  WikiDataIdentifier:
    description: >-
      A Wikidata entity identifier (Q-number) that uniquely identifies an entity
      in the Wikidata knowledge base.
      
      **DISTINCTION FROM WikiDataEntry**:
      - `WikiDataIdentifier` is for simple Q-number storage (identifier only)
      - `WikiDataEntry` includes full entity data (label, description, claims)
      
      Use `WikiDataIdentifier` when:
      - Only storing the Q-number reference
      - Linking to Wikidata without caching entity data
      
      **FORMAT**: Q followed by digits (e.g., Q190804 for Rijksmuseum)
      **URL PATTERN**: https://www.wikidata.org/wiki/Q{number}
      
    class_uri: dct:Identifier
    
    close_mappings:
      - schema:PropertyValue
      - wikidata:Q43649390  # Wikidata identifier
    
    attributes:
      qid:
        range: string
        required: true
        pattern: "^Q[0-9]+$"
        description: >-
          The Wikidata Q-number (e.g., Q190804).
          Must start with 'Q' followed by one or more digits.
      
      url:
        range: uri
        description: >-
          Full URL to the Wikidata entity page.
          Auto-derivable from qid: https://www.wikidata.org/wiki/{qid}
      
      label:
        range: string
        description: >-
          Human-readable label for the entity (optional cache).
          May be language-specific.
      
      retrieved_at:
        range: datetime
        description: >-
          Timestamp when this identifier was retrieved/verified.
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Wikidata identifiers applicable to all custodian types.
      custodian_types_primary: "*"
      specificity_score: 0.3
      specificity_rationale: >-
        Low specificity - universal identifier type.
    
    examples:
      - value: |
          WikiDataIdentifier:
            qid: "Q190804"
            url: "https://www.wikidata.org/wiki/Q190804"
            label: "Rijksmuseum"
        description: Wikidata identifier for the Rijksmuseum.
      
      - value: |
          WikiDataIdentifier:
            qid: "Q1526131"
            label: "Biblioteca Nacional do Brasil"
        description: Wikidata identifier for the National Library of Brazil.