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_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/has_description
  - ../slots/has_label  # was: title
  - ../slots/has_score  # was: template_specificity
  - ../slots/include
  - ../slots/retrieved_at  # was: date_retrieved
  - ../slots/has_quantity
  - ../slots/has_name
  - ../slots/has_url
  - ../slots/temporal_extent  # was: valid_from + valid_to
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 `include` 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
        retrieved_at:
          has_timestamp: "2025-01-14"
          has_level: day
        include:
          - 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:
      - has_name
      - has_label  # was: title
      - has_description
      - include
      - has_url
      - retrieved_at  # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
      - link_count
      - temporal_extent  # was: valid_from + valid_to
      - has_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      has_name:
#         range: string
      has_label:  # was: title
#         range: string
      include:
#         range: string
        multivalued: true
        inlined_as_list: false # Fixed invalid inline for primitive type
      has_url:
        range: uri
      retrieved_at:  # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
        range: Timestamp
        inlined: true
        examples:
          - value:
              has_timestamp: "2025-01-14"
              has_level: day
      link_count:
        range: integer
    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_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
          source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
          retrieved_at:  # was: date_retrieved
            has_timestamp: "2025-01-14"
            has_level: day
          link_count: 15
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline