# RoomUnit - Unit class for counting room/space facilities
#
# 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 + RoomUnit
# Rule 39 (RiC-O Naming): Uses has_or_had_* pattern

id: https://nde.nl/ontology/hc/class/RoomUnit
name: RoomUnit
title: Room Unit

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

default_prefix: hc

imports:
  - linkml:types
  - ./Unit
  - ../enums/RoomUnitTypeEnum

classes:
  RoomUnit:
    is_a: Unit
    class_uri: hc:RoomUnit
    description: |
      A unit of measurement for counting rooms or spaces in a facility.
      
      **RULE 53 MIGRATION**:
      Replaces simple integer count slots with typed unit specification:
      - `classroom_count: 4` → `has_or_had_quantity: 4` + `has_or_had_unit: {unit_type: CLASSROOM}`
      
      **ROOM TYPES**:
      - CLASSROOM - Teaching/learning spaces
      - WORKSHOP_SPACE - Hands-on activity areas
      - SEMINAR_ROOM - Discussion/presentation spaces
      - LABORATORY - Scientific/conservation labs
      - STUDIO - Creative/production spaces
      - READING_ROOM - Research/study areas
      - STORAGE_ROOM - Collection storage spaces
      - OFFICE - Administrative spaces
      
      **USAGE PATTERN**:
      ```yaml
      has_or_had_facility:
        - facility_name: "Education Wing"
          has_or_had_quantity:
            numeric_value: 4
          has_or_had_unit:
            unit_type: CLASSROOM
      ```
      
    exact_mappings:
      - qudt:Unit
    
    close_mappings:
      - schema:Room
    
    attributes:
      unit_type:
        range: RoomUnitTypeEnum
        required: true
        description: |
          The type of room/space being counted.
        examples:
          - value: CLASSROOM
            description: Classroom space
          - value: READING_ROOM
            description: Reading room
    
    annotations:
      custodian_types: '["E", "L", "A", "M", "R"]'
      custodian_types_rationale: >-
        Room counting most relevant for education providers (E), libraries (L),
        archives (A), museums (M), and research centers (R).
      custodian_types_primary: "E"
      specificity_score: "0.45"
      specificity_rationale: >-
        Moderately specific - room counting common in education/facility contexts.
      template_specificity: '{"archive_search": 0.35, "museum_search": 0.45, "library_search": 0.50, "collection_discovery": 0.20, "person_research": 0.10, "location_browse": 0.55, "identifier_lookup": 0.10, "organizational_change": 0.20, "digital_platform": 0.10, "general_heritage": 0.45}'
    
    examples:
      - value:
          unit_type: CLASSROOM
        description: Unit for counting classroom spaces
      
      - value:
          unit_type: READING_ROOM
        description: Unit for counting reading rooms
      
      - value:
          unit_type: WORKSHOP_SPACE
        description: Unit for counting workshop areas
    
    comments:
      - Created from slot_fixes.yaml migration (2026-01-19)
      - Specialized unit for room/space counting
      - Subclass of Unit with room-specific type enum
      - Used with Classroom and similar facility classes