# FoundingEvent - Organization founding event class
#
# Created per slot_fixes.yaml migration for: founded_year, founding_date
# Creation date: 2026-01-22
# Rule compliance: 39 (RiC-O naming), 50 (ontology mapping), 53 (slot_fixes revision)

id: https://nde.nl/ontology/hc/class/FoundingEvent
name: FoundingEvent
title: Founding Event

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

default_prefix: hc

imports:
  - linkml:types
  - ../slots/temporal_extent
  - ../slots/description
  - ../slots/has_or_had_identifier
  - ./TimeSpan

classes:
  FoundingEvent:
    class_uri: crm:E63_Beginning_of_Existence
    description: |
      Represents the founding or establishment event of an organization.
      
      **USAGE**:
      Captures structured founding information for:
      - Heritage custodians (museums, archives, libraries)
      - Standards organizations
      - Historic restaurants and venues
      - Any organization with establishment history
      
      **ONTOLOGY ALIGNMENT**:
      - **Primary** (`class_uri`): `crm:E63_Beginning_of_Existence` - CIDOC-CRM
      - **Close**: `schema:Event` - Schema.org event
      - **Close**: `prov:Activity` - PROV-O activity
      
      **TEMPORAL PATTERN**:
      Uses CIDOC-CRM E52_Time-Span pattern for fuzzy temporal bounds:
      - Known year: `begin_of_the_begin` = "YYYY-01-01", `end_of_the_begin` = "YYYY-12-31"
      - Known exact date: all four bounds equal
      - Unknown year range: set `begin_of_the_begin` to earliest, `end_of_the_begin` to latest
      
      **MIGRATION NOTE**:
      Created per slot_fixes.yaml revision (Rule 53, 2026-01-22).
      Replaces simple `founded_year` (integer) and `founding_date` (string).
      
    slots:
      - temporal_extent
      - description
      - has_or_had_identifier
    
    attributes:
      founding_event_id:
        identifier: true
        description: |
          Unique identifier for this founding event.
          Recommended format: URI combining organization ID and "founding".
        range: uriorcurie
        slot_uri: dcterms:identifier
        examples:
          - value: "https://nde.nl/ontology/hc/event/founding/rijksmuseum-1800"
          - value: "hc:event/founding/de-kas-1902"
      
      founding_description:
        description: |
          Textual description of the founding event and circumstances.
        range: string
        slot_uri: schema:description
        examples:
          - value: "Founded by King Louis Napoleon as the Royal Museum"
          - value: "Established as family restaurant in historic greenhouse"
      
      founding_location:
        description: |
          Location where the founding took place (if different from current location).
        range: string
        slot_uri: schema:location
        examples:
          - value: "The Hague, Netherlands"
          - value: "Original premises at 123 Main Street"
      
      founded_by:
        description: |
          Person(s) or organization(s) who founded this entity.
        range: string
        multivalued: true
        slot_uri: schema:founder
        examples:
          - value: "King Louis Napoleon"
          - value: "Johannes van der Berg"
    
    slot_usage:
      temporal_extent:
        description: |
          The temporal extent of the founding event.
          For a known year (e.g., 1902), use:
          - begin_of_the_begin: "1902-01-01"
          - end_of_the_begin: "1902-12-31"
          
          For a precise date (e.g., 1902-03-15), set all bounds equal.
          For uncertain date ranges, use appropriate fuzzy bounds.
        range: TimeSpan
        inlined: true
        required: true
    
    exact_mappings:
      - crm:E63_Beginning_of_Existence
    
    close_mappings:
      - schema:Event
      - prov:Activity
    
    examples:
      - value:
          founding_event_id: "https://nde.nl/ontology/hc/event/founding/rijksmuseum-1800"
          temporal_extent:
            begin_of_the_begin: "1800-01-01"
            end_of_the_begin: "1800-12-31"
            notes: "Founded in 1800 by King Louis Napoleon"
          founding_description: "Founded as the Royal Museum by King Louis Napoleon"
          founded_by:
            - "King Louis Napoleon"
          founding_location: "The Hague, Netherlands"
        description: Rijksmuseum founding event
      
      - value:
          founding_event_id: "https://nde.nl/ontology/hc/event/founding/de-kas-1902"
          temporal_extent:
            begin_of_the_begin: "1902-01-01"
            end_of_the_begin: "1902-12-31"
          founding_description: "Established as historic greenhouse restaurant"
          founded_by:
            - "Original family owners"
        description: Historic restaurant founding
      
      - value:
          founding_event_id: "https://nde.nl/ontology/hc/event/founding/unknown-archive-1850s"
          temporal_extent:
            begin_of_the_begin: "1850-01-01"
            end_of_the_begin: "1859-12-31"
            notes: "Founded sometime in the 1850s"
          founding_description: "Founded during the 1850s, exact date unknown"
        description: Founding with decade-level uncertainty
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: "Founding events applicable to all custodian types."
      specificity_score: "0.30"
      specificity_rationale: "Broadly applicable - founding events for all heritage organizations."