glam/schemas/20251121/linkml/modules/classes/Appointment.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

67 lines
2.8 KiB
YAML

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: '[''*'']'