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/has_description  # migrated from has_description per Rule 55
  - ../slots/has_policy
  - ../slots/has_score  # was: template_specificity
  - ../slots/originate_from
  - ../slots/temporal_extent
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_policy`: Transfer policy governing the transfer
      - `has_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
      - originate_from
      - has_description  # was: has_description
      - has_policy
      - has_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      temporal_extent:
        range: TimeSpan
        required: false
        inlined: true
      originate_from:
        range: Location
        required: false
        inlined: true
      has_description:  # was: has_description
#         range: string
        required: false
        inlined: false # Fixed invalid inline for primitive type
      has_policy:
        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_timestamp: "2020-01-15T00:00:00Z"  # was: timestamp_value - migrated per Rule 53
          starts_or_started_at_location:
            location_name: "Old Storage Facility"
          has_description:  # was: has_description
            description_text: "Transfer of historical photographs to new climate-controlled facility"