# Organizer class
# Entity that organizes events, exhibitions, programs with role specification
#
# Created per slot_fixes.yaml revision for co_organized_by migration
# Generation date: 2026-01-19
# Rule compliance: 53 (slot_fixes.yaml), 39 (RiC-O naming)

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

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

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_or_had_role
  - ./OrganizerRole

classes:
  Organizer:
    class_uri: schema:Organization
    description: |
      An entity that organizes or organized an event, exhibition, program, or activity.
      
      **Purpose**:
      Captures the organizing entity along with their role, replacing simple
      uriorcurie references like `co_organized_by` or `organized_by`.
      
      **Key Properties**:
      - `organizer_entity`: Reference to the organizing institution (Custodian, Organization)
      - `has_or_had_role`: Role of the organizer (PRIMARY, CO_ORGANIZER, etc.)
      - `organizer_contribution`: Description of organizational contribution
      
      **Pattern**:
      Instead of separate `organized_by` and `co_organized_by` slots with plain URIs,
      use a single `has_or_had_organizer` slot with Organizer instances that specify roles.
      
      **Example Migration**:
      ```yaml
      # OLD (deprecated):
      organized_by:
        - https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
      co_organized_by:
        - https://nde.nl/ontology/hc/custodian/nl/mauritshuis
      
      # NEW (Rule 53):
      has_or_had_organizer:
        - organizer_entity: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
          has_or_had_role:
            role_type: PRIMARY
        - organizer_entity: https://nde.nl/ontology/hc/custodian/nl/mauritshuis
          has_or_had_role:
            role_type: CO_ORGANIZER
      ```
      
      **Ontological Alignment**:
      - **Primary**: `schema:Organization` (organizer is an organization)
      - **Close**: `org:Organization` (W3C Org vocabulary)
      - **Related**: `prov:Agent` (PROV-O agent in activity)
      
    exact_mappings:
      - schema:Organization
    
    close_mappings:
      - org:Organization
    
    related_mappings:
      - prov:Agent
    
    slots:
      - organizer_entity
      - has_or_had_role
      - organizer_contribution
    
    slot_usage:
      organizer_entity:
        required: true
        range: uriorcurie
        description: |
          Reference to the organizing institution (Custodian, Organization).
          This is the entity that actually does the organizing.
        examples:
          - value: "https://nde.nl/ontology/hc/custodian/nl/rijksmuseum"
            description: "Rijksmuseum as organizer"
      
      has_or_had_role:
        required: false
        range: OrganizerRole
        inlined: true
        description: |
          Role of this organizer (PRIMARY, CO_ORGANIZER, SPONSOR_ORGANIZER, etc.).
          If omitted, implies general organizational involvement.
        examples:
          - value:
              role_type: PRIMARY
            description: "Primary organizer role"
      
      organizer_contribution:
        required: false
        range: string
        description: |
          Description of organizational contribution.
          Examples: "Provided 15 works from permanent collection",
          "Funded conservation of borrowed works", "Curatorial expertise"
        examples:
          - value: "Provided 15 works from permanent collection and curatorial expertise"
            description: "Description of Mauritshuis contribution to Vermeer exhibition"
    
    annotations:
      specificity_score: 0.55
      specificity_rationale: "Moderately specific - applies to any event organization context"
      custodian_types: '["*"]'
      custodian_types_rationale: "Any institution type can organize events/exhibitions"
    
    comments:
      - "Created per slot_fixes.yaml revision for co_organized_by migration"
      - "Replaces separate organized_by/co_organized_by with role-based discrimination"
      - "RULE 53: Part of co_organized_by → has_or_had_organizer + Organizer migration"
    
    examples:
      - value:
          organizer_entity: "https://nde.nl/ontology/hc/custodian/nl/rijksmuseum"
          has_or_had_role:
            role_type: PRIMARY
            role_description: "Main organizing institution"
        description: "Rijksmuseum as primary organizer of Vermeer exhibition"
      
      - value:
          organizer_entity: "https://nde.nl/ontology/hc/custodian/nl/mauritshuis"
          has_or_had_role:
            role_type: CO_ORGANIZER
            role_description: "Partner institution providing key loans"
          organizer_contribution: "Provided Girl with a Pearl Earring and 5 other Vermeers"
        description: "Mauritshuis as co-organizer with specific contribution"
      
      - value:
          organizer_entity: "https://nde.nl/ontology/hc/custodian/us/national-gallery-washington"
          has_or_had_role:
            role_type: LENDING_INSTITUTION
          organizer_contribution: "Lent Woman Holding a Balance"
        description: "National Gallery Washington as lending institution"

slots:
  organizer_entity:
    slot_uri: schema:organizer
    description: Reference to the organizing institution
    range: uriorcurie
    required: true
  
  organizer_contribution:
    slot_uri: schema:description
    description: Description of organizational contribution
    range: string
    required: false