# UnitIdentifier - Storage unit identifier class
# Created: 2026-01-14 for unit_id/unit_identifier migration (Rule 53)
# 
# This class replaces the unit_id and unit_identifier slots
# with a proper Identifier subclass for storage units.

id: https://nde.nl/ontology/hc/class/UnitIdentifier
name: UnitIdentifier
title: Storage Unit Identifier

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

default_prefix: hc

imports:
  - linkml:types
  - ../slots/has_or_had_code
  - ../slots/identifier_scheme

classes:
  UnitIdentifier:
    class_uri: hc:UnitIdentifier
    description: |
      Identifier for storage units within heritage institutions.
      
      **DEFINITION**:
      
      UnitIdentifier represents unique identifiers assigned to individual
      storage compartments, shelves, cabinets, or other discrete units.
      
      **REPLACED SLOTS**:
      - unit_id: URI identifier for the storage unit
      - unit_identifier: Local string identifier (barcode, label)
      
      **IDENTIFIER FORMATS**:
      | Format | Example | Use Case |
      |--------|---------|----------|
      | URI | https://nde.nl/ontology/hc/unit/na-depot-a-r12-b3-s4 | Persistent web ID |
      | Barcode | BOX-2024-00145 | Physical box barcode |
      | Label | FF-MAPS-042 | Flat file drawer label |
      | Rack | RACK-TEXT-A12 | Storage rack identifier |
      
    slots:
      - has_or_had_code
      - identifier_scheme
    
    slot_usage:
      has_or_had_code:
        range: string
        required: true
        description: The identifier value
        examples:
          - value: BOX-2024-00145
            description: Archive box barcode
          - value: FF-MAPS-042
            description: Flat file drawer label
      identifier_scheme:
        range: string
        description: The identifier scheme (URI, Barcode, Label, etc.)
        examples:
          - value: barcode
          - value: label
          - value: uri
    
    annotations:
      migration_date: "2026-01-14"
      replaces_slots: "unit_id, unit_identifier"
      rule_compliance: "53 (full slot migration)"