id: https://nde.nl/ontology/hc/class/Appointment
name: appointment_class
title: Appointment Class
version: 1.0.0
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  rico: https://www.ica.org/standards/RiC/ontology#
imports:
  - linkml:types
  - ../slots/has_or_had_description
  - ../slots/has_or_had_label
  - ../slots/temporal_extent
default_prefix: hc
classes:
  Appointment:
    class_uri: schema:Reservation
    description: "Models an appointment or reservation requirement as a structured\
      \ entity.\n\n**PURPOSE**:\nHeritage institutions often require appointments\
      \ for:\n- Special collections access\n- Reading room reservations  \n- Guided\
      \ tours of sensitive materials\n- Conservation viewing requests\n\nBy modeling\
      \ appointments as entities (not just boolean flags), we can capture:\n- Lead\
      \ time requirements (24h, 48h, 1 week in advance)\n- Booking methods (email,\
      \ phone, online form)\n- Confirmation requirements\n- Cancellation policies\n\
      - Temporal validity (when appointments are required)\n\n**ONTOLOGY ALIGNMENT**:\n\
      - schema:Reservation - \"A reservation for an event, service, or product\"\n\
      - rico:conditionsOfAccess - Links to RiC-O access condition patterns\n\n**REPLACES**:\n\
      - appointment_required (boolean) - Now modeled as structured entity\n- requires_appointment\
      \ (boolean) - Preserved for backward compatibility\n"
    exact_mappings:
    - schema:Reservation
    close_mappings:
    - rico:Rule
    slots:
    - has_or_had_label
    - has_or_had_description
    - temporal_extent
    slot_usage:
      has_or_had_label:
        examples:
        - value: Reading Room Appointment
        - value: Special Collections Viewing
        - value: Conservation Lab Access
      has_or_had_description:
        examples:
        - value: "Appointments for the Special Collections reading room must be made\
            \ \nat least 48 hours in advance. Please specify which materials you \n\
            wish to consult. Maximum 5 items per visit.\n"
      temporal_extent:
        range: TimeSpan
        inlined: true
    examples:
    - value:
        appointment_id: hc:appointment/nationaal-archief-special-collections
        has_or_had_label: Special Collections Appointment
        has_or_had_description: Advance appointment required for manuscript and map
          collections
    - value:
        appointment_id: hc:appointment/reading-room-recommended
        has_or_had_label: Reading Room Reservation
        has_or_had_description: Reservations recommended but walk-ins accepted based
          on availability
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: '[''*'']'