# ChAnnotatorAnnotationMetadata - Metadata about the annotation
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08
# MIGRATED 2026-01-19: confidence_score → is_or_was_generated_by + GenerationEvent + ConfidenceScore

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

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
  oa: http://www.w3.org/ns/oa#
  dqv: http://www.w3.org/ns/dqv#

imports:
  - linkml:types
  # MIGRATED 2026-01-19: confidence_score → is_or_was_generated_by + GenerationEvent + ConfidenceScore
  - ../slots/is_or_was_generated_by
  - ./GenerationEvent
  - ./ConfidenceScore


default_range: string

classes:
  ChAnnotatorAnnotationMetadata:
      description: >-
        Metadata about the CH-Annotator annotation including confidence scores,
        verification status, and quality metrics.
        
        Ontology mapping rationale:
        - class_uri is oa:Annotation because this represents metadata about an
          annotation following the W3C Web Annotation Data Model.
        - close_mappings includes dqv:QualityAnnotation because it captures
          quality-related metadata (confidence, verification).
        - related_mappings includes prov:Entity as the annotation metadata itself
          is a provenance-tracked entity.
      class_uri: oa:Annotation
      close_mappings:
        - dqv:QualityAnnotation
      related_mappings:
        - prov:Entity
        - schema:Rating
      slots:
        # MIGRATED 2026-01-19: confidence_score → is_or_was_generated_by
        - is_or_was_generated_by
      slot_usage:
        is_or_was_generated_by:
          range: GenerationEvent
          required: false
          inlined: true
          description: >-
            Generation event containing confidence score for annotation.
            MIGRATED 2026-01-19: Replaces confidence_score slot with structured pattern.
          examples:
            - value:
                has_or_had_score:
                  has_or_had_score: 0.92
                  has_or_had_method: "annotation_validation"
              description: High confidence annotation
      attributes:
        verified:
          range: boolean
          description: Whether annotation has been verified
        verification_date:
          range: datetime
          description: When verification occurred
        verified_by:
          range: string
          description: Who verified the annotation
      
      comments:
        - "MIGRATED 2026-01-19: confidence_score → is_or_was_generated_by + ConfidenceScore"