id: https://nde.nl/ontology/hc/class/CollectionDiscoveryScore
name: collection_discovery_score_class
title: Collection Discovery Score Class
# Created per slot_fixes.yaml revision for collection_discovery_score migration
# RULE 53: Structured score class replacing primitive float

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  sosa: http://www.w3.org/ns/sosa/
  prov: http://www.w3.org/ns/prov#
  schema: http://schema.org/

imports:
  - linkml:types
  - ../slots/has_or_had_score
  - ../slots/specificity_annotation
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore
  - ./TemplateSpecificityType
  - ./TemplateSpecificityTypes

default_range: string

classes:
  CollectionDiscoveryScore:
    class_uri: sosa:Observation
    description: >-
      Structured score for collection discovery/exploration relevance.
      
      Captures the computed relevance score from search/retrieval algorithms
      acting as observation systems, along with metadata about when and how
      the score was computed.
      
      **Use cases**:
      - RAG retrieval relevance scores for collection metadata
      - Search result ranking scores
      - Collection exploration priority scores
      - Template-specific relevance for different query contexts
      
      **Score semantics**:
      - 0.0 = Not relevant to query/context
      - 0.5 = Moderately relevant
      - 1.0 = Highly relevant
    exact_mappings:
      - sosa:Observation
    close_mappings:
      - prov:Entity
      - schema:Rating
    slots:
      - has_or_had_score
      - specificity_annotation
    attributes:
      score_context:
        range: string
        description: >-
          Context or query type for which this score was computed.
          E.g., "collection_discovery", "archive_search", "museum_search"
      computed_at:
        range: datetime
        description: When the score was computed.
      algorithm_version:
        range: string
        description: >-
          Version of the scoring algorithm used.
          Enables reproducibility and score comparison across versions.
      score_notes:
        range: string
        description: Additional notes about the score computation.
    comments:
      - "Created per slot_fixes.yaml revision for collection_discovery_score migration"
      - "Replaces primitive float with structured observation"
      - "RULE 53: Part of collection_discovery_score → has_or_had_score + CollectionDiscoveryScore migration"
    annotations:
      specificity_score: 0.75
      specificity_rationale: "Fairly specific - applies to collection search/discovery contexts"
    examples:
      - value: |
          has_or_had_score: 0.85
          score_context: "collection_discovery"
          computed_at: "2026-01-19T12:00:00Z"
          algorithm_version: "v1.2.0"
      - value: |
          has_or_had_score: 0.92
          score_context: "archive_search"
          computed_at: "2026-01-19T14:30:00Z"