id: https://nde.nl/ontology/hc/class/Conflict
name: conflict_class
title: Conflict Class

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

default_prefix: hc

imports:
  - linkml:types
  - ./TimeSpan
  - ./ConflictType
  - ./ConflictTypes
  - ./ConflictStatus
  - ../slots/has_or_had_type
  - ../slots/has_or_had_label
  - ../slots/has_or_had_description
  - ../slots/temporal_extent
  # has_or_had_documentation_source REMOVED - migrated to has_or_had_provenance + Provenance (Rule 53)
  - ../slots/has_or_had_provenance
  - ./Provenance
  - ../slots/is_or_was_based_on  # for documentation source
  - ./DocumentationSource

classes:
  Conflict:
    class_uri: crm:E5_Event
    description: |
      A conflict event affecting heritage custodians.
      
      **DEFINITION**:
      
      A Conflict represents an armed conflict, natural disaster, or other
      destructive event that impacts heritage institutions. This class
      captures the CONFLICT ITSELF, while ConflictStatus captures the
      STATUS of a specific custodian affected by the conflict.
      
      **SEMANTIC PATTERN**:
      
      ```
      Custodian
        │
        └── is_or_was_involved_in → Conflict (THIS CLASS)
              ├── has_or_had_type → ConflictType (ARMED_CONFLICT, NATURAL_DISASTER, etc.)
              ├── has_or_had_label: "Gaza War 2023-2024"
              ├── temporal_extent → TimeSpan (duration of conflict)
              └── involvement_status → ConflictStatus (status of THIS custodian)
      ```
      
      **DISTINCTION FROM ConflictStatus**:
      - **Conflict** (THIS CLASS): The conflict event itself (e.g., "Gaza War 2023")
      - **ConflictStatus**: The status of a specific custodian (DESTROYED, DAMAGED, etc.)
      
      A single Conflict can affect multiple custodians, each with different statuses.
      
      **CIDOC-CRM ALIGNMENT**:
      - Primary: `crm:E5_Event` - "comprises occurrences in spacetime that can be
        delimited within a defined extent of the spacetime"
      - Specialization: `crm:E6_Destruction` when resulting in destruction
      
      **USE CASES**:
      
      1. **Gaza 2023-2024**: Armed conflict affecting 30+ heritage institutions
      2. **Syrian Civil War**: Ongoing conflict affecting museums and archives
      3. **Nepal Earthquake 2015**: Natural disaster affecting heritage sites
      4. **Iraq War**: Looting and destruction of cultural heritage
      
      Created as part of conflict_status migration per slot_fixes.yaml (Rule 53).
      
    exact_mappings:
      - crm:E5_Event
    close_mappings:
      - crm:E6_Destruction
      - schema:Event
    related_mappings:
      - prov:Activity
    
    slots:
      - has_or_had_type
      - has_or_had_label
      - has_or_had_description
      - temporal_extent
      # has_or_had_documentation_source REMOVED - migrated to has_or_had_provenance (Rule 53)
      - has_or_had_provenance
    
    attributes:
      involvement_status:
        range: ConflictStatus
        description: |
          The status of a specific custodian's involvement in this conflict.
          Uses ConflictStatus class with DESTROYED, DAMAGED, THREATENED, etc.
        inlined: true
    
    slot_usage:
      has_or_had_type:
        range: ConflictType
        required: true
        description: |
          The type of conflict (ARMED_CONFLICT, NATURAL_DISASTER, etc.).
          Uses ConflictType class hierarchy per Rule 0b.
      has_or_had_label:
        description: Human-readable name for the conflict.
        examples:
          - value:
              label_text: "Gaza War 2023-2024"
              language: en
          - value:
              label_text: "Syrian Civil War"
              language: en
      has_or_had_description:
        description: Detailed description of the conflict and its impact on heritage.
      temporal_extent:
        description: |
          Time period of the conflict.
          Uses TimeSpan class with fuzzy temporal bounds.
        examples:
          - value:
              begin_of_the_begin: "2023-10-07"
              end_of_the_end: null
            description: "Gaza War - ongoing as of 2024"
      has_or_had_provenance:  # was: has_or_had_documentation_source - migrated per Rule 53 (2026-01-27)
        description: |
          Sources documenting the conflict's impact on heritage.
          MIGRATED from has_or_had_documentation_source per Rule 53.
          Uses Provenance class to wrap is_or_was_based_on → DocumentationSource.
        range: Provenance
        inlined: true
        examples:
        - value:
            is_or_was_based_on:
              has_or_had_label: "UNESCO Cultural Heritage in Gaza Assessment"
          description: "Assessment report"
        - value:
            is_or_was_based_on:
              has_or_had_label: "Librarians and Archivists with Palestine - Gaza Report 2024"
          description: "Damage report"
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Conflicts can affect all heritage custodian types.
      specificity_score: 0.55
      specificity_rationale: Specialized event type for conflict documentation.
    
    comments:
      - "Created 2026-01-22 per slot_fixes.yaml conflict_status migration"
      - "Separates the CONFLICT from the CUSTODIAN'S STATUS in that conflict"
      - "Enables linking multiple custodians to the same conflict event"
    
    examples:
      - value:
          has_or_had_type: ARMED_CONFLICT
          has_or_had_label:
            label_text: "Gaza War 2023-2024"
            language: en
          has_or_had_description:
            description_text: "Armed conflict beginning October 2023 affecting Gaza heritage institutions"
          temporal_extent:
            begin_of_the_begin: "2023-10-07"
          has_or_had_provenance:
            is_or_was_based_on:
              has_or_had_label: "Librarians and Archivists with Palestine"
          involvement_status:
            status: destroyed
            destruction_date: "2023-12-08"
            conflict_description: "Library destroyed by airstrike"
        description: "Gaza heritage institution destroyed in conflict"