glam/frontend/public/schemas/20251121/linkml/modules/classes/AccessPolicy.yaml

id: https://nde.nl/ontology/hc/class/AccessPolicy
name: access_policy_class
title: AccessPolicy Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  premis: http://www.loc.gov/premis/rdf/v3/
  dcterms: http://purl.org/dc/terms/
  rico: https://www.ica.org/standards/RiC/ontology#
  schema: http://schema.org/
  skos: http://www.w3.org/2004/02/skos/core#
  wd: http://www.wikidata.org/entity/
default_prefix: hc
imports:
  - linkml:types
  - ../slots/credentials_required
  - ../slots/cultural_protocol_url
  - ../slots/has_or_had_description
  - ../slots/has_or_had_embargo_end_date
  - ../slots/has_or_had_embargo_reason
  - ../slots/has_or_had_level
  - ../slots/has_or_had_score
  - ../slots/imposes_or_imposed
  - ../slots/legal_basis
  - ../slots/policy_id
  - ../slots/policy_name
  - ../slots/poses_or_posed_condition
  - ../slots/registration_required
  - ../slots/requires_appointment
  - ../slots/requires_or_required
  - ../slots/review_date
  - ../slots/rights_statement
  - ../slots/rights_statement_url
  - ../slots/temporal_extent
classes:
  AccessPolicy:
    class_uri: premis:RightsStatus
    description: "Access policy defining conditions under which heritage collections can be accessed.\n\n**PURPOSE**:\n\nAccessPolicy captures the access conditions governing a Collection:\n- WHO can access (public, researchers, staff only)\n- HOW access is granted (open, by appointment, with credentials)\n- WHEN access is available (opening hours, embargo periods)\n- WHAT restrictions apply (fragile materials, privacy, cultural sensitivity)\n\n1. **PREMIS**:\n   - `premis:RightsStatus` - \"Information about the rights status of an object.\"\n   - Links to Collection via premis:rightsStatus\n\n2. **Dublin Core**:\n   - `dcterms:accessRights` - \"Information about who may access the resource\n     or an indication of its security status.\"\n\n3. **RiC-O**:\n   - `rico:hasOrHadAllMembersWithAccessConditions` - Links RecordSet to access\n     conditions applying to all members\n\n4. **RightsStatements.org**:\n   - Standardized rights statements for cultural heritage\n   - E.g., \"In Copyright\"\
      , \"No Copyright\", \"Unknown Copyright\"\n\n**ACCESS LEVEL TAXONOMY**:\n\n```\nAccessPolicy (root)\n  \u2502\n  \u251C\u2500\u2500 OpenAccess\n  \u2502     \u251C\u2500\u2500 PUBLIC_OPEN - No restrictions, walk-in access\n  \u2502     \u251C\u2500\u2500 PUBLIC_REGISTRATION - Free registration required\n  \u2502     \u2514\u2500\u2500 PUBLIC_ONLINE - Digital access freely available\n  \u2502\n  \u251C\u2500\u2500 RestrictedAccess\n  \u2502     \u251C\u2500\u2500 RESEARCHERS_ONLY - Academic researchers with credentials\n  \u2502     \u251C\u2500\u2500 BY_APPOINTMENT - Advance booking required\n  \u2502     \u251C\u2500\u2500 STAFF_ONLY - Internal access only\n  \u2502     \u2514\u2500\u2500 PERMISSION_REQUIRED - Written permission needed\n  \u2502\n  \u251C\u2500\u2500 ClosedAccess\n  \u2502     \u251C\u2500\u2500 TEMPORARILY_CLOSED - Renovation, conservation\n  \u2502     \u251C\u2500\u2500 EMBARGOED - Time-limited closure\n  \u2502     \u251C\u2500\u2500 PERMANENTLY_CLOSED - Not accessible\n\
      \  \u2502     \u2514\u2500\u2500 REPATRIATED - Returned to community of origin\n  \u2502\n  \u2514\u2500\u2500 ConditionalAccess\n        \u251C\u2500\u2500 CULTURALLY_SENSITIVE - Indigenous/sacred materials\n        \u251C\u2500\u2500 PRIVACY_RESTRICTED - Personal data protection\n        \u251C\u2500\u2500 FRAGILE_HANDLING - Special handling required\n        \u2514\u2500\u2500 LEGAL_RESTRICTION - Copyright, legal constraints\n```\n\n**USE CASES**:\n\n1. **Archive Open Access**:\n   ```yaml\n   AccessPolicy:\n     policy_id: \"hc:access-policy/nationaal-archief-open\"\n     access_level: \"PUBLIC_OPEN\"\n     access_description: \"Open to all visitors during reading room hours\"\n     conditions: \"Valid ID required for registration\"\n   ```\n\n2. **Restricted Research Materials**:\n   ```yaml\n   AccessPolicy:\n     policy_id: \"hc:access-policy/university-special-collections\"\n     access_level: \"RESEARCHERS_ONLY\"\n     access_description: \"Academic researchers with institutional\
      \ affiliation\"\n     conditions: \"Letter of introduction required from supervising institution\"\n     requires_appointment: true\n   ```\n\n3. **Embargoed Collection**:\n   ```yaml\n   AccessPolicy:\n     policy_id: \"hc:access-policy/donor-embargo-2050\"\n     access_level: \"EMBARGOED\"\n     access_description: \"Closed until 2050 per donor agreement\"\n     embargo_end_date: \"2050-01-01\"\n     embargo_reason: \"Donor privacy restrictions\"\n   ```\n\n4. **Culturally Sensitive**:\n   ```yaml\n   AccessPolicy:\n     policy_id: \"hc:access-policy/indigenous-protocols\"\n     access_level: \"CULTURALLY_SENSITIVE\"\n     access_description: \"Access governed by Traditional Knowledge protocols\"\n     conditions: \"Consultation with originating community required\"\n     cultural_protocol_url: \"https://localcontexts.org/tk-labels/\"\n   ```\n\n**RELATIONSHIP TO DIM ARCHIVE**:\n\nDimArchive (Dark archive / Preservation-only storage) uses AccessPolicy to express:\n- Materials stored\
      \ for preservation, not current access\n- Access restricted until triggering conditions (time, event)\n- \"Gray literature\" or un-catalogued backlogs awaiting processing\n"
    exact_mappings:
    - premis:RightsStatus
    close_mappings:
    - dcterms:accessRights
    - rico:Rule
    - schema:ActionAccessSpecification
    related_mappings:
    - rico:hasOrHadAllMembersWithAccessConditions
    slots:
    - has_or_had_description
    - has_or_had_level
    - requires_appointment
    - poses_or_posed_condition
    - requires_or_required
    - credentials_required
    - cultural_protocol_url
    - has_or_had_embargo_end_date
    - has_or_had_embargo_reason
    - imposes_or_imposed
    - legal_basis
    - policy_id
    - policy_name
    - registration_required
    - review_date
    - rights_statement
    - rights_statement_url
    - has_or_had_score
    - temporal_extent
    slot_usage:
      policy_id:
#         range: string # uriorcurie
        required: true
        identifier: true
        examples:
        - value: https://nde.nl/ontology/hc/access-policy/open-access
      policy_name:
#         range: string
        required: true
        examples:
        - value: Open Access
        - value: Researchers Only
        - value: Embargoed until 2050
      has_or_had_level:
        range: AccessLevel
        required: true
        inlined: true
        examples:
        - value:
            has_or_had_label: PUBLIC_OPEN
        - value:
            has_or_had_label: RESEARCHERS_ONLY
        - value:
            has_or_had_label: EMBARGOED
      has_or_had_description:
#         range: string
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value:
            description_text: Open to all visitors during reading room hours (Mon-Fri 9-17)
        - value:
            description_text: Access restricted to academic researchers with institutional has_or_had_affiliation
      poses_or_posed_condition:
        range: Condition
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
        - value:
          - has_or_had_type: AccessCondition
            has_or_had_description:
              description_text: Valid government-issued ID required
          - has_or_had_type: AccessCondition
            has_or_had_description:
              description_text: Registration form must be completed
      rights_statement:
#         range: string
        examples:
        - value: In Copyright
        - value: No Copyright - United States
      rights_statement_url:
        range: uri
        examples:
        - value: http://rightsstatements.org/vocab/InC/1.0/
        - value: http://rightsstatements.org/vocab/NoC-US/1.0/
      requires_appointment:
        range: boolean
        examples:
        - value: true
        - value: false
      registration_required:
        range: boolean
        examples:
        - value: true
      credentials_required:
#         range: string
        examples:
        - value: INSTITUTIONAL
        - value: true
      imposes_or_imposed:
#         range: string # Fee
        inlined: false # Fixed invalid inline for primitive type
        multivalued: true
        examples:
        - value:
            has_or_had_quantity:
            has_or_had_unit:
            has_or_had_description: Daily reading room fee
        - value:
            has_or_had_quantity:
            has_or_had_description: Free for researchers
        - value:
            has_or_had_quantity:
            has_or_had_unit:
            has_or_had_description: General public fee
      has_or_had_embargo_end_date:
        range: date
        examples:
        - value: '2050-01-01'
      has_or_had_embargo_reason:
#         range: string
        examples:
        - value: Donor privacy restrictions per deed of gift
        - value: Contains personal data protected under GDPR
      cultural_protocol_url:
        range: uri
        examples:
        - value: https://localcontexts.org/tk-labels/
      legal_basis:
#         range: string
        examples:
        - value: General Data Protection Regulation (GDPR)
        - value: Freedom of Information Act exemption 6
      review_date:
        range: date
        examples:
        - value: '2025-12-31'
      temporal_extent:
        range: TimeSpan
        inlined: true
        required: true
        examples:
        - value:
            begin_of_the_begin: '2024-01-01'
            end_of_the_end: '2050-12-31'
      requires_or_required:
        range: Appointment
        multivalued: true
        inlined: true
        examples:
        - value:
          - appointment_id: hc:appointment/special-collections-48h
            has_or_had_label: Special Collections Appointment
            has_or_had_description: Book at least 48 hours in advance for manuscript access
    comments:
    - AccessPolicy defines access conditions for Collection instances
    - Used by Collection.access_policy_ref to link policies to holdings
    - Supports RightsStatements.org and Local Contexts protocols
    - Temporal validity enables policy versioning and embargo expiration
    - DimArchive (dark archive) uses AccessPolicy to express preservation-only access
    see_also:
    - http://www.loc.gov/premis/rdf/v3/RightsStatus
    - https://rightsstatements.org/
    - https://localcontexts.org/
    - https://www.ica.org/standards/RiC/ontology#Rule
    examples:
    - value:
        policy_id: https://nde.nl/ontology/hc/access-policy/nationaal-archief-open
        policy_name: Nationaal Archief Public Access
        has_or_had_level:
          has_or_had_label: PUBLIC_OPEN
        has_or_had_description:
          description_text: Open to all visitors during reading room hours
        poses_or_posed_condition:
        - has_or_had_type: AccessCondition
          has_or_had_description:
            description_text: Valid government-issued ID required
        - has_or_had_type: AccessCondition
          has_or_had_description:
            description_text: Registration form must be completed
        - has_or_had_type: HandlingCondition
          has_or_had_description:
            description_text: Original materials handled with gloves
        registration_required: true
        requires_appointment: false
        has_or_had_contact_point:
    - value:
        policy_id: https://nde.nl/ontology/hc/access-policy/donor-embargo-2050
        policy_name: Embargoed until 2050
        has_or_had_level:
          has_or_had_label: EMBARGOED
        has_or_had_description:
          description_text: Collection closed until 2050 per donor agreement
        has_or_had_embargo_end_date: '2050-01-01'
        has_or_had_embargo_reason: Donor privacy restrictions per deed of gift
        legal_basis: Deed of Gift clause 4.2
        review_date: '2049-06-01'
    - value:
        policy_id: https://nde.nl/ontology/hc/access-policy/dim-archive-preservation
        policy_name: DIM Archive - Preservation Only
        has_or_had_level:
          has_or_had_label: TEMPORARILY_CLOSED
        has_or_had_description:
          description_text: Materials in preservation storage, not currently accessible
        poses_or_posed_condition:
        - has_or_had_type: ProcessingCondition
          has_or_had_description:
            description_text: Awaiting processing and cataloging
        - has_or_had_type: AccessCondition
          has_or_had_description:
            description_text: Access may be arranged for urgent research needs
        requires_appointment: true
        credentials_required: PROFESSIONAL
        has_or_had_contact_point:
    - value:
        policy_id: https://nde.nl/ontology/hc/access-policy/special-collections-rich
        policy_name: Special Collections - Rich Appointment Policy
        has_or_had_level:
          has_or_had_label: RESEARCHERS_ONLY
        has_or_had_description:
          description_text: Academic researchers with institutional affiliation
        requires_or_required:
        - appointment_id: hc:appointment/special-collections-booking
          has_or_had_label: Special Collections Appointment
          has_or_had_description: 'Appointments for manuscript and rare book collections must be made
            at least 48 hours in advance. Please specify which materials you
            wish to consult.
            '
        registration_required: true
        credentials_required: INSTITUTIONAL
        has_or_had_contact_point:
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"