# TransferPolicy class
# Policy governing custody or ownership transfers
#
# Generation date: 2026-01-15
# Rule compliance: 0 (LinkML single source of truth), 38 (slot centralization), 53 (slot_fixes.yaml)
#
# Supports migration: transfer_policy → is_or_was_transferred + TransferEvent + has_or_had_policy + TransferPolicy

id: https://nde.nl/ontology/hc/class/TransferPolicy
name: transfer_policy_class
title: TransferPolicy Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  rico: https://www.ica.org/standards/RiC/ontology#
  dcterms: http://purl.org/dc/terms/
  odrl: http://www.w3.org/ns/odrl/2/

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/policy_name
  - ../slots/policy_text
  - ../slots/has_or_had_structured_description
  - ../slots/specificity_annotation
  - ../slots/template_specificity
  - ./Description
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores

classes:
  TransferPolicy:
    class_uri: odrl:Policy
    description: |
      Policy governing custody or ownership transfers.
      
      **Purpose**:
      TransferPolicy captures the rules and conditions under which
      heritage materials may be transferred between institutions,
      including donor restrictions and legal requirements.
      
      **Ontological Alignment**:
      - **Primary**: `odrl:Policy` - ODRL policy (rights/rules)
      - **Close**: `rico:RecordResourceTransferRule` - RiC-O transfer rule
      - **Related**: `dcterms:RightsStatement` - rights/access statement
      
      **Use Cases**:
      - Donor restrictions on collection transfers
      - Deaccessioning policies
      - Inter-institutional loan agreements
      - Government archive transfer regulations
      
    exact_mappings:
      - odrl:Policy
    
    close_mappings:
      - rico:RecordResourceTransferRule
    
    related_mappings:
      - dcterms:RightsStatement
    
    slots:
      - policy_name
      - policy_text
      - has_or_had_structured_description
      - specificity_annotation
      - template_specificity
    
    slot_usage:
      policy_name:
        description: |
          Name or title of the transfer policy.
        range: string
        required: false
      policy_text:
        description: |
          Full text of the policy.
        range: string
        required: false
      has_or_had_structured_description:
        description: |
          Summary description of the policy.
        range: Description
        required: false
        inlined: true
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Transfer policies apply to all heritage types.
      custodian_types_primary: null
      specificity_score: 0.55
      specificity_rationale: Specialized policy type for transfer governance.
    
    examples:
      - value: |
          policy_name: "Donor Transfer Restriction"
          policy_text: "Materials may not be transferred to institutions outside the Netherlands without donor consent."
        description: "Donor-imposed transfer restriction"