id: https://nde.nl/ontology/hc/class/Overview
name: overview_class
title: Overview Class
description: >-
  A comprehensive collection of links and resources.
  
  Represents a structured overview or collection of web links and related
  resources. Used to aggregate multiple WebLink instances into a coherent
  collection with shared context or purpose.
  
  **ONTOLOGY ALIGNMENT**:
  - Dublin Core: dcterms:Collection (collection of resources)
  - Schema.org: schema:ItemList (list of items)
  - RiC-O: rico:RecordSet (archival collection concept)
  
  **USE CASES**:
  1. All links from a finding aid page
  2. Comprehensive resource listings
  3. Navigation link collections
  4. Related resource aggregations
  
  **MIGRATION NOTE** (2026-01-14):
  Created as part of slot migration from `all_links` to 
  `has_or_had_comprehensive_overview` with `Overview` and `WebLink` typed classes.
  See slot_fixes.yaml for migration specification.

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
  rico: https://www.ica.org/standards/RiC/ontology#
  skos: http://www.w3.org/2004/02/skos/core#

imports:
  - linkml:types
  - ../slots/id
  - ../slots/name
  - ../slots/description
  - ../slots/has_or_had_label  # was: title - migrated per Rule 53
  - ../slots/includes_or_included
  - ../slots/link_count
  # ARCHIVED: ../slots/valid_from - use temporal_extent instead
  # ARCHIVED: ../slots/valid_to - use temporal_extent instead
  - ../slots/temporal_extent  # was: valid_from + valid_to
  - ../slots/source_url
  - ../slots/date_retrieved
  - ../slots/specificity_annotation
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ./WebLink
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes
  - ./TimeSpan

default_prefix: hc
default_range: string

classes:
  Overview:
    class_uri: dcterms:Collection
    description: >-
      A comprehensive collection of links and resources.
      
      **DEFINITION**:
      An aggregation of WebLink instances representing all links or resources
      from a particular source or context. Enables structured representation
      of comprehensive link collections from web pages or other sources.
      
      **DUBLIN CORE ALIGNMENT**:
      Maps to `dcterms:Collection` as it represents a collection of related
      resources gathered together for a purpose.
      
      **TEMPORAL SEMANTICS**:
      Overview collections can change over time:
      - New links may be added
      - Existing links may be removed or updated
      - The collection scope may change
      
      **RELATIONSHIP TO INCLUDES_OR_INCLUDED**:
      Uses the generic `includes_or_included` slot to link to WebLink
      instances, following RiC-O hierarchical patterns.
      
      **EXAMPLE**:
      ```yaml
      overview:
        id: hc:overview/findingaid-familyhistory-links
        title: "Family History Research Links"
        description: "All links from the family history finding aid page"
        source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
        date_retrieved: "2025-01-14"
        includes_or_included:
          - id: hc:link/civil-registry
            url: https://example.org/civil-registry
            link_text: "Civil Registry"
          - id: hc:link/notarial-records
            url: https://example.org/notarial
            link_text: "Notarial Records"
      ```
    
    exact_mappings:
      - dcterms:Collection
    
    close_mappings:
      - schema:ItemList
      - rico:RecordSet
    
    slots:
      - id
      - name
      - has_or_had_label  # was: title
      - description
      - includes_or_included
      - source_url
      - date_retrieved
      - link_count
      - temporal_extent  # was: valid_from + valid_to
      - specificity_annotation
      - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    
    slot_usage:
      id:
        identifier: true
        required: true
        range: uriorcurie
      name:
        range: string
        description: >-
          Short name for the overview collection.
      has_or_had_label:  # was: title
        range: string
        description: >-
          Descriptive title for the overview.
      description:
        range: string
        description: >-
          Human-readable description of the overview's purpose and scope.
      includes_or_included:
        range: WebLink
        multivalued: true
        inlined_as_list: true
        description: >-
          The web links included in this overview collection.
      source_url:
        range: uri
        description: >-
          The URL of the page from which links were extracted.
      date_retrieved:
        range: date
        description: >-
          Date when the overview was extracted or compiled.
      link_count:
        range: integer
        description: >-
          Total number of links in the overview.
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Applicable to all heritage custodian types as comprehensive
        link collections are universal navigation patterns.
      custodian_types_primary: "*"
      specificity_score: 0.30
      specificity_rationale: >-
        Low specificity - broadly applicable for link collection
        and navigation modeling.
    
    comments:
      - Collection of WebLink instances
      - Used with has_or_had_comprehensive_overview slot
      - Created from slot_fixes.yaml migration (2026-01-14)
    
    see_also:
      - http://purl.org/dc/terms/Collection
      - http://schema.org/ItemList
    
    examples:
      - value:
          id: hc:overview/findingaid-001-links
          title: "Family History Research Links"
          description: "Comprehensive collection of links from the family history finding aid"
          source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
          date_retrieved: "2025-01-14"
          link_count: 15
        description: Overview of links from a finding aid page


# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline