# WikidataAlignment
#
# Structured metadata for Wikidata entity alignment.
# Replaces fragmented annotations with a proper structured object.
#
# Generation date: 2026-01-07

id: https://nde.nl/ontology/hc/class/WikidataAlignment
name: WikidataAlignment
title: Wikidata Alignment

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  skos: http://www.w3.org/2004/02/skos/core#
  wdt: http://www.wikidata.org/prop/direct/
  rdfs: http://www.w3.org/2000/01/rdf-schema#

default_prefix: hc

imports:
  - linkml:types
  - ../enums/WikidataMappingTypeEnum
  - ../slots/wikidata_entity_id
  - ../slots/wikidata_entity_label
  - ../slots/wikidata_mapping_rationale
  - ../slots/wikidata_mapping_type

# Slot definitions are inlined here to avoid circular imports
# These slots are also available separately in ../slots/ for reuse

slots:
  wikidata_entity_id:
    slot_uri: wdt:P31
    description: |
      Wikidata entity ID (Q-number) for this class.
      Links to the corresponding Wikidata concept.
    range: string
    pattern: "^Q[0-9]+$"
  
  wikidata_entity_label:
    slot_uri: rdfs:label
    description: |
      Human-readable label for the linked Wikidata entity.
      Stored for display purposes to avoid repeated API calls.
    range: string
  
  wikidata_mapping_type:
    slot_uri: skos:mappingRelation
    description: |
      Type of semantic mapping relationship to the Wikidata entity.
    range: WikidataMappingTypeEnum
  
  wikidata_mapping_rationale:
    slot_uri: skos:note
    description: |
      Explanation of the Wikidata mapping relationship.
    range: string

classes:
  WikidataAlignment:
    class_uri: hc:WikidataAlignment
    description: |
      Structured metadata for Wikidata entity alignment.
      Replaces fragmented annotations with a proper structured object.
      
      **Example**:
      ```yaml
      wikidata_alignment:
        entity_id: Q27032435
        entity_label: "academic archive"
        mapping_type: exact
        mapping_rationale: "AcademicArchive is semantically equivalent to Q27032435"
      ```
    slots:
      - wikidata_entity_id
      - wikidata_entity_label
      - wikidata_mapping_type
      - wikidata_mapping_rationale
    annotations:
      specificity_score: 0.3
      specificity_rationale: "Universal utility for Wikidata alignment metadata"