id: https://nde.nl/ontology/hc/class/WikiDataEntry
name: wikidata_entry_class
title: WikiDataEntry Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  wikibase: http://wikiba.se/ontology#
  wd: http://www.wikidata.org/entity/
  schema: http://schema.org/
  skos: http://www.w3.org/2004/02/skos/core#
  prov: http://www.w3.org/ns/prov#

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_description    # was: wikidata_description
  - ../slots/identified_by     # was: wikidata_qid
  - ../slots/has_label          # was: wikidata_label
  - ../slots/has_score  # was: template_specificity
  - ../slots/in_language
classes:
  WikiDataEntry:
    class_uri: wikibase:Item
    description: |
      Reference to a Wikidata entity (Q-item) for alignments and equivalences.
      
      **Purpose**:
      WikiDataEntry provides a reusable class for representing Wikidata entity
      references with Q-number identifier, label, and description.
      Used for ontology alignments, equivalence mappings, and classification.
      
      **Ontological Alignment**:
      - **Primary**: `wikibase:Item` - Wikibase item class
      - **Close**: `schema:Thing` - general web entity
      - **Related**: `skos:Concept` - controlled vocabulary concept
      
      **Use Cases**:
      - Ontology alignment: `wikidata_alignment` → relates schema class to Wikidata Q
      - Equivalence: `wikidata_equivalent` → marks semantic equivalence
      - Classification: `wikidata_class` → instance_of relationship
      - General mapping: `wikidata_mapping` → related concept
      
      **Replaces** (per slot_fixes.yaml):
      - `wikidata_mapping` (string Q-number)
      - `wikidata_equivalent` (string Q-number)
      - `wikidata_class` (string Q-number)
      - `wikidata_alignment` (string Q-number)
      - `wikidata` (string Q-number)
      
    exact_mappings:
      - wikibase:Item
    
    close_mappings:
      - schema:Thing
    
    related_mappings:
      - skos:Concept
      - prov:Entity
    
    slots:
      - identified_by      # was: wikidata_qid - migrated 2026-01-16 per Rule 53
      - has_label           # was: wikidata_label - migrated 2026-01-16 per Rule 53
      - has_description     # was: wikidata_description - migrated 2026-01-16 per Rule 53
      - in_language
      - has_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    
    slot_usage:
      identified_by:  # was: wikidata_qid - migrated 2026-01-16 per Rule 53
#         range: string
        required: true
        pattern: "^Q[0-9]+$"
      has_label:  # was: wikidata_label - migrated 2026-01-16 per Rule 53
#         range: string
        required: false
      has_description:  # was: wikidata_description - migrated 2026-01-16 per Rule 53
#         range: string
        required: false
      in_language:
#         range: string
        required: false
        pattern: "^[a-z]{2}(-[A-Z]{2})?$"
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Generic Wikidata reference class applicable to all types.
      custodian_types_primary: null
      specificity_score: 0.2
      specificity_rationale: Broadly applicable generic class for Wikidata links.
    
    examples:
      - value: |
          identified_by: "Q33506"
          has_label: "museum"
          has_description: "institution that holds and displays collections"
          language: en
      - value: |
          identified_by: "Q190804"
          has_label: "Rijksmuseum"
          has_description: "Dutch national museum in Amsterdam"
          language: en