id: https://nde.nl/ontology/hc/class/CollectionDiscoveryScore
name: collection_discovery_score_class
title: Collection Discovery Score Class
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 \u2192 has_or_had_score + CollectionDiscoveryScore migration"
    annotations:
      specificity_score: 0.75
      specificity_rationale: Fairly specific - applies to collection search/discovery contexts
      custodian_types: "['*']"
    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"

        '