glam/schemas/20251121/linkml/modules/classes/ConflictStatus.yaml

# Conflict Status Class
# Represents the status of a heritage custodian affected by armed conflict, natural disaster, or deliberate destruction

id: https://nde.nl/ontology/hc/class/ConflictStatus
name: conflict_status_class
title: Conflict Status Class

imports:
  - linkml:types
  - ../metadata
  - ../enums/ConflictStatusEnum
  - ./TimeSpan

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#

classes:
  ConflictStatus:
    class_uri: hc:ConflictStatus
    description: |
      Represents the status of a heritage custodian affected by armed conflict,
      natural disaster, or deliberate destruction.
      
      **PURPOSE**:
      Documents the current condition of heritage institutions impacted by external
      forces beyond normal organizational dissolution. This is critical for:
      - Tracking heritage destruction in conflict zones (Gaza, Syria, Ukraine, Iraq)
      - Monitoring post-disaster recovery efforts
      - Supporting cultural heritage protection advocacy
      - Connecting with international monitoring organizations
      
      **DISTINCTION FROM DISSOLUTION**:
      - Normal dissolution (merger, closure) → Use `temporal_extent.end_of_the_end`
      - Involuntary destruction (conflict, disaster) → Use `conflict_status` + `time_of_destruction`
      
      **RELATIONSHIP TO time_of_destruction**:
      - `conflict_status`: Summary status object with description and sources
      - `time_of_destruction`: Detailed TimeSpan with fuzzy temporal bounds
      
      **DATA FLOW**:
      1. Source documents (reports, news) → `conflict_status` extraction
      2. `conflict_status.date` → `time_of_destruction.begin_of_the_end`
      3. Frontend displays both in CustodianTimeline component
      
      **EXAMPLE - Gaza Institution**:
      ```yaml
      conflict_status:
        status: destroyed
        date: "2023-12-08"
        reported_date: "2024-01-15"
        description: "Library destroyed by Israeli airstrike during Gaza conflict."
        is_rebuilding: false
        sources:
          - "Librarians and Archivists with Palestine - Gaza Report 2024"
      ```
      
      **FRONTEND DISPLAY**:
      - CustodianTimeline.tsx shows "💥 Vernietigd" or "💥 Vernietigd (herbouwend)"
      - InstitutionInfoPanel.tsx passes destruction data to timeline
      - Color: Dark red for destroyed+defunct, orange for rebuilding
      
      **CIDOC-CRM ALIGNMENT**:
      Models the result of crm:E6_Destruction or crm:E11_Modification events.
      The causing event is documented in OrganizationalChangeEvent.
            
    mixins: []
    slots:
      - status
      - date
      - reported_date
      - description
      - is_rebuilding
      - sources
    
    slot_usage:
      status:
        slot_uri: hc:conflictStatusValue
        range: ConflictStatusEnum
        required: true
        description: |
          The current status of the institution regarding conflict/disaster impact.
          Uses ConflictStatusEnum values: DESTROYED, DAMAGED, THREATENED, etc.          
        examples:
          - value: "destroyed"
            description: "Institution completely destroyed"
          - value: "damaged"
            description: "Institution significantly damaged but recoverable"
      
      date:
        slot_uri: crm:P4_has_time-span
        range: date
        description: |
          Date when destruction/damage occurred.
          For single events, use exact date.
          For gradual destruction, use start of period.
          
          **Note**: For fuzzy temporal bounds, use `time_of_destruction` (TimeSpan).          
        examples:
          - value: "2023-12-08"
            description: "Exact date of airstrike"
          - value: "2023-10-07"
            description: "Start of siege period"
      
      reported_date:
        slot_uri: prov:generatedAtTime
        range: date
        description: |
          Date when the destruction/damage was reported or documented.
          May differ from `date` when reports are delayed.
          Important for provenance tracking.          
        examples:
          - value: "2024-01-15"
            description: "Date when LAP Gaza Report was published"
      
      description:
        slot_uri: schema:description
        range: string
        description: |
          Human-readable description of the destruction/damage event.
          Should include:
          - Type of damage (destroyed, damaged, looted)
          - Cause (airstrike, fire, looting, natural disaster)
          - Impact on collections (if known)          
        examples:
          - value: "Library destroyed by Israeli airstrike during Gaza conflict. All collections lost."
      
      is_rebuilding:
        slot_uri: hc:isRebuilding
        range: boolean
        description: |
          Whether the institution is currently being rebuilt or restored.
          When true, shows "💥 Vernietigd (herbouwend)" in timeline.
          When false or absent, shows "💥 Vernietigd" in timeline.          
        examples:
          - value: true
            description: "Institution being rebuilt after destruction"
          - value: false
            description: "No rebuilding efforts underway"
      
      sources:
        slot_uri: prov:hadPrimarySource
        range: string
        multivalued: true
        description: |
          List of sources documenting the destruction/damage.
          Include report names, news articles, official statements.
          These are displayed in the frontend for transparency.          
        examples:
          - value: "Librarians and Archivists with Palestine - Gaza Report 2024"
          - value: "UNESCO Damaged Cultural Heritage in Gaza assessment"
          - value: "Palestinian Ministry of Culture damage report"
    
    exact_mappings:
      - crm:E6_Destruction
    related_mappings:
      - crm:E11_Modification
      - prov:Activity
    
    comments:
      - "Used for Gaza 2023-2024 conflict documentation (30+ institutions)"
      - "Frontend: CustodianTimeline.tsx displays destruction events"
      - "Populated from LAP Gaza Report 2024 and other verified sources"
    
    see_also:
      - hc:time_of_destruction
      - https://github.com/nde-lab/glam/blob/main/frontend/src/components/map/CustodianTimeline.tsx
      - https://github.com/nde-lab/glam/blob/main/scripts/convert_palestinian_to_custodian.py

slots:
  status:
    description: Conflict/disaster impact status value
    range: ConflictStatusEnum
  
  date:
    description: Date of destruction/damage event
    range: date
  
  reported_date:
    description: Date when destruction/damage was reported
    range: date
  
  description:
    description: Human-readable description of the destruction/damage event
    range: string
  
  is_rebuilding:
    description: Whether institution is being rebuilt
    range: boolean
  
  sources:
    slot_uri: prov:hadPrimarySource
    description: Sources documenting the destruction/damage
    range: string
    multivalued: true