# Classroom - Classroom facility class
#
# Created per slot_fixes.yaml migration for: classroom_count
# Creation date: 2026-01-19
#
# Rule 53 (No Bespoke Slots): classroom_count → has_or_had_facility + Classroom
# Rule 39 (RiC-O Naming): Uses has_or_had_* pattern

id: https://nde.nl/ontology/hc/class/Classroom
name: Classroom
title: Classroom Facility

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  qudt: http://qudt.org/schema/qudt/

default_prefix: hc

imports:
  - linkml:types
  - ./Facility
  - ./Quantity
  - ./RoomUnit
  - ../slots/has_or_had_quantity
  - ../slots/has_or_had_unit

classes:
  Classroom:
    is_a: Facility
    class_uri: schema:Classroom
    description: |
      A classroom facility at an education center or heritage institution.
      
      **RULE 53 MIGRATION**:
      Replaces the simple `classroom_count` integer slot with a richer facility model:
      - `has_or_had_quantity` → number of classroom spaces
      - `has_or_had_unit` → RoomUnit (specifies what is being counted)
      
      **USAGE**:
      ```yaml
      has_or_had_facility:
        - facility_name: "Classroom Wing"
          has_or_had_quantity:
            numeric_value: 4
          has_or_had_unit:
            unit_type: CLASSROOM
      ```
      
      **CHARACTERISTICS**:
      - Dedicated teaching/learning space
      - Capacity for group instruction
      - May include AV equipment
      - Configurable seating arrangements
      
    slots:
      - has_or_had_quantity
      - has_or_had_unit
    
    slot_usage:
      has_or_had_quantity:
        range: Quantity
        inlined: true
        description: |
          Number of classroom spaces in this facility.
        examples:
          - value: |
              numeric_value: 4
            description: 4 classroom spaces
      
      has_or_had_unit:
        range: RoomUnit
        inlined: true
        description: |
          Unit specification for the count (classroom, seat, etc.).
        examples:
          - value: |
              unit_type: CLASSROOM
            description: Counting classrooms
    
    attributes:
      seating_capacity:
        range: integer
        description: Total seating capacity across all classrooms
      
      av_equipped:
        range: boolean
        description: Whether classrooms have AV equipment
      
      flexible_seating:
        range: boolean
        description: Whether seating can be reconfigured
    
    exact_mappings:
      - schema:Classroom
    
    close_mappings:
      - schema:Room
      - schema:Place
    
    annotations:
      specificity_score: "0.55"
      specificity_rationale: "Moderately specific - classrooms common in education centers."
      template_specificity: '{"archive_search": 0.30, "museum_search": 0.50, "library_search": 0.45, "collection_discovery": 0.20, "person_research": 0.15, "location_browse": 0.60, "identifier_lookup": 0.10, "organizational_change": 0.25, "digital_platform": 0.15, "general_heritage": 0.55}'
    
    examples:
      - value:
          facility_name: "Education Wing Classrooms"
          facility_description: "Four fully-equipped classroom spaces for educational programs"
          has_or_had_quantity:
            numeric_value: 4
          has_or_had_unit:
            unit_type: CLASSROOM
          seating_capacity: 120
          av_equipped: true
          flexible_seating: true
        description: Museum education center classroom facility
      
      - value:
          facility_name: "Archive Learning Rooms"
          facility_description: "Two seminar rooms for genealogy and research workshops"
          has_or_had_quantity:
            numeric_value: 2
          has_or_had_unit:
            unit_type: CLASSROOM
          seating_capacity: 40
          av_equipped: true
        description: Archive education classroom facility