# TransferEvent class
# Custody or ownership transfer event
#
# Generation date: 2026-01-15
# Rule compliance: 0 (LinkML single source of truth), 38 (slot centralization), 53 (slot_fixes.yaml)
#
# This class supports 4 slot migrations per slot_fixes.yaml:
# - transfer_to_collection_date → is_or_was_transferred + TransferEvent
# - transfer_policy → is_or_was_transferred + TransferEvent
# - transfer_location_text → is_or_was_transferred + TransferEvent
# - transfer_location → is_or_was_transferred + TransferEvent

id: https://nde.nl/ontology/hc/class/TransferEvent
name: transfer_event_class
title: TransferEvent Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  rico: https://www.ica.org/standards/RiC/ontology#
  prov: http://www.w3.org/ns/prov#
  schema: http://schema.org/

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/temporal_extent
  - ../slots/starts_or_started_at_location
  - ../slots/ends_or_ended_at_location
  - ../slots/has_or_had_description  # migrated from has_or_had_description per Rule 55
  - ../slots/has_or_had_policy
  - ../slots/specificity_annotation
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ./TimeSpan
  - ./Location
  - ./TransferPolicy
  - ./Description
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes

classes:
  TransferEvent:
    class_uri: crm:E10_Transfer_of_Custody
    description: |
      Event representing transfer of custody, ownership, or physical location.
      
      **Purpose**:
      TransferEvent models significant transfers in heritage contexts:
      - Collection transfers between institutions
      - Relocation of holdings
      - Custody changes (legal guardianship)
      - Ownership changes
      
      **Ontological Alignment**:
      - **Primary**: `crm:E10_Transfer_of_Custody` - CIDOC-CRM custody transfer
      - **Close**: `rico:TransferEvent` - RiC-O transfer event
      - **Related**: `prov:Activity` - PROV-O activity (general activity)
      
      **Key Components**:
      - `temporal_extent`: When the transfer occurred (TimeSpan)
      - `starts_or_started_at_location`: Origin location
      - `ends_or_ended_at_location`: Destination location
      - `has_or_had_policy`: Transfer policy governing the transfer
      - `has_or_had_description`: Narrative description
      
      **Replaces** (per slot_fixes.yaml):
      - `transfer_to_collection_date` (simple date)
      - `transfer_policy` (simple string)
      - `transfer_location` (simple string)
      - `transfer_location_text` (simple string)
      
    exact_mappings:
      - crm:E10_Transfer_of_Custody
    
    close_mappings:
      - rico:TransferEvent
    
    related_mappings:
      - prov:Activity
      - schema:TransferAction
    
    slots:
      - temporal_extent
      - starts_or_started_at_location
      - ends_or_ended_at_location
      - has_or_had_description  # was: has_or_had_description
      - has_or_had_policy
      - specificity_annotation
      - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    
    slot_usage:
      temporal_extent:
        description: |
          When the transfer occurred. Can be a single date or date range.
        range: TimeSpan
        required: false
        inlined: true
      starts_or_started_at_location:
        description: |
          Origin location - where the transferred items came from.
        range: Location
        required: false
        inlined: true
      ends_or_ended_at_location:
        description: |
          Destination location - where the transferred items went to.
        range: Location
        required: false
        inlined: true
      has_or_had_description:  # was: has_or_had_description
        description: |
          Narrative description of the transfer event.
        range: Description
        required: false
        inlined: true
      has_or_had_policy:
        description: |
          Policy that governed this transfer.
        range: TransferPolicy
        required: false
        inlined: true
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Transfer events apply to all heritage custodian types.
      custodian_types_primary: null
      specificity_score: 0.5
      specificity_rationale: Specialized event type for custody/ownership changes.
    
    examples:
      - value: |
          temporal_extent:
            begin_of_the_begin:
              has_or_had_timestamp: "2020-01-15T00:00:00Z"  # was: timestamp_value - migrated per Rule 53
          starts_or_started_at_location:
            location_name: "Old Storage Facility"
          ends_or_ended_at_location:
            location_name: "New Archive Building"
          has_or_had_description:  # was: has_or_had_description
            description_text: "Transfer of historical photographs to new climate-controlled facility"
        description: "Collection relocation transfer"