# Access class
# Structured access information for heritage collections and services
#
# Created per slot_fixes.yaml revision for collection_access migration
# Generation date: 2026-01-19
# Rule compliance: 53 (slot_fixes.yaml), 39 (RiC-O naming)

id: https://nde.nl/ontology/hc/class/Access
name: Access
title: Access Class

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  crm: http://www.cidoc-crm.org/cidoc-crm/

default_prefix: hc

imports:
  - linkml:types
  - ../metadata
  - ./TimeSpan
  - ../slots/has_or_had_frequency
  - ./Frequency

classes:
  Access:
    class_uri: dcterms:RightsStatement
    description: |
      Structured access information for heritage collections, services, or facilities.
      
      **Purpose**:
      Replaces simple string descriptions of access conditions with structured
      data capturing access types, eligible users, conditions, and restrictions.
      
      **Key Properties**:
      - `access_type`: Type of access (PUBLIC, BY_APPOINTMENT, RESTRICTED, etc.)
      - `eligible_users`: Who can access (public, students, faculty, researchers)
      - `access_conditions`: Conditions or requirements for access
      - `access_restrictions`: Specific restrictions that apply
      - `temporal_extent`: When this access policy applies
      
      **Access Types**:
      - PUBLIC: Open to general public
      - BY_APPOINTMENT: Requires advance appointment
      - ACADEMIC: Restricted to academic community
      - RESEARCHER: Restricted to credentialed researchers
      - MEMBER: Requires membership
      - RESTRICTED: Limited access with specific conditions
      - CLOSED: Not currently accessible
      - DIGITAL_ONLY: Available only in digital form
      
      **Ontological Alignment**:
      - **Primary**: `dcterms:RightsStatement` - Dublin Core rights statement
      - **Close**: `schema:publicAccess` - Schema.org access indicator
      - **Related**: `crm:E30_Right` - CIDOC-CRM rights
      
    exact_mappings:
      - dcterms:RightsStatement
    
    close_mappings:
      - schema:publicAccess
    
    related_mappings:
      - crm:E30_Right
    
    slots:
      - access_type
      - eligible_users
      - access_conditions
      - access_restrictions
      - access_description
      - temporal_extent
      - is_digital_access
      - has_or_had_frequency
    
    slot_usage:
      access_type:
        required: true
        range: AccessTypeEnum
        description: Type of access offered
        examples:
          - value: PUBLIC
          - value: BY_APPOINTMENT
          - value: ACADEMIC
      
      eligible_users:
        required: false
        range: string
        multivalued: true
        description: |
          Categories of users eligible for this access.
          Examples: "enrolled students", "faculty", "visiting scholars",
          "credentialed researchers", "general public"
        examples:
          - value: "enrolled students"
          - value: "faculty and staff"
          - value: "visiting researchers with credentials"
      
      access_conditions:
        required: false
        range: string
        multivalued: true
        description: |
          Conditions that must be met for access.
          Examples: "valid university ID", "advance booking required",
          "handling training completed"
        examples:
          - value: "valid university ID required"
          - value: "24-hour advance booking required"
      
      access_restrictions:
        required: false
        range: string
        multivalued: true
        description: |
          Specific restrictions on access.
          Examples: "conservation concerns limit handling",
          "donor restrictions apply", "high-value items in secure storage"
        examples:
          - value: "fragile materials limited to supervised viewing"
          - value: "donor bequest restricts reproduction"
      
      access_description:
        required: false
        range: string
        description: |
          Free-text description of access policy.
          For backward compatibility with string-based collection_access.
        examples:
          - value: "Open to enrolled students and faculty; public by appointment"
      
      temporal_extent:
        required: false
        range: TimeSpan
        inlined: true
        description: |
          Time period during which this access policy applies.
          Useful for temporary restrictions or seasonal access.
      
      is_digital_access:
        required: false
        range: boolean
        description: Whether this access is for digital materials
      has_or_had_frequency:
        required: false
        range: Frequency
        description: Frequency of access (e.g., daily, weekly, by appointment)
        inlined: true
        examples:
          - value:
              has_or_had_label: "Daily"
            description: Access available daily
    
    annotations:
      specificity_score: 0.50
      specificity_rationale: "Moderately specific - applies to collection and service access contexts"
      custodian_types: '["*"]'
      custodian_types_rationale: "All institution types offer some form of access"
    
    comments:
      - "Created per slot_fixes.yaml revision for collection_access migration"
      - "Replaces string-based collection_access with structured access data"
      - "RULE 53: Part of collection_access → offers_or_offered_access + Access migration"
    
    examples:
      - value:
          access_type: PUBLIC
          access_description: "Open to general public during gallery hours"
          eligible_users:
            - "general public"
          access_conditions:
            - "during posted gallery hours"
        description: "Public access during gallery hours"
      
      - value:
          access_type: BY_APPOINTMENT
          eligible_users:
            - "credentialed researchers"
            - "graduate students with faculty sponsor"
          access_conditions:
            - "48-hour advance booking required"
            - "handling training required for original materials"
          access_restrictions:
            - "fragile materials limited to supervised viewing only"
        description: "Research access by appointment with conditions"
      
      - value:
          access_type: ACADEMIC
          access_description: "Open to enrolled students and faculty; public by appointment"
          eligible_users:
            - "enrolled students"
            - "faculty"
            - "research staff"
          access_conditions:
            - "valid university ID"
          is_digital_access: false
        description: "Academic community access with public by appointment"
      
      - value:
          access_type: DIGITAL_ONLY
          access_description: "Collection accessible only through online database"
          eligible_users:
            - "anyone with internet access"
          is_digital_access: true
        description: "Digital-only access"

slots:
  access_type:
    slot_uri: dcterms:accessRights
    description: Type of access offered
    range: string
    required: true
  
  eligible_users:
    slot_uri: schema:eligibleRegion
    description: Categories of users eligible for access
    range: string
    multivalued: true
  
  access_conditions:
    slot_uri: schema:termsOfService
    description: Conditions for access
    range: string
    multivalued: true
  
  access_restrictions:
    slot_uri: schema:usageInfo
    description: Restrictions on access
    range: string
    multivalued: true
  
  access_description:
    slot_uri: schema:description
    description: Free-text description of access policy
    range: string
  
  is_digital_access:
    slot_uri: schema:isAccessibleForFree
    description: Whether this is digital access
    range: boolean

enums:
  AccessTypeEnum:
    description: Types of access to collections or services
    permissible_values:
      PUBLIC:
        description: Open to general public
      BY_APPOINTMENT:
        description: Requires advance appointment
      ACADEMIC:
        description: Restricted to academic community
      RESEARCHER:
        description: Restricted to credentialed researchers
      MEMBER:
        description: Requires membership
      RESTRICTED:
        description: Limited access with specific conditions
      CLOSED:
        description: Not currently accessible
      DIGITAL_ONLY:
        description: Available only in digital form
      MIXED:
        description: Multiple access types apply