id: https://nde.nl/ontology/hc/class/BoxNumber
name: box_number_class
title: Box Number Class
description: |
  A storage box number or position identifier on a shelf.
  
  MIGRATED from box_number slot (Rule 53).
  Uses generic has_or_had_identifier slot with range narrowed to BoxNumber.
  Updated 2026-01-16: Migrated from inline attributes to proper slots.
imports:
  - linkml:types
  - ../slots/numeric_value
  - ../slots/specificity_annotation
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes
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

classes:
  BoxNumber:
    class_uri: hc:BoxNumber
    description: |
      An identifier for a storage box or its position on a shelf.
      
      **DEFINITION**:
      
      BoxNumber represents the position or identifier of a storage box within 
      a storage unit hierarchy. Archive boxes are the most common physical 
      containers for heritage materials, particularly in archives.
      
      ```
      Shelf
        └── Box 1 (THIS CLASS - position on shelf)
        └── Box 2
        └── Box 3
        ...
      ```
      
      **TYPICAL VALUES**:
      
      | Type | Example | Description |
      |------|---------|-------------|
      | Sequential | 1, 2, 3, 12 | Position on shelf left-to-right |
      | Inventory | 145, 2024-0042 | Unique box inventory number |
      | Combined | 12.3 | Bay 12, Box 3 |
      
      **ARCHIVE BOX STANDARDS**:
      
      Heritage institutions typically use acid-free archive boxes conforming to:
      - ISO 16245 (Boxes for documents)
      - ANSI/NISO Z39.77 (Guidelines for materials in archives)
      
      **HERITAGE USE CASES**:
      
      | Material Type | Box Format |
      |---------------|------------|
      | Documents | Standard archive box (legal/letter) |
      | Photographs | Photo storage boxes |
      | Oversized | Flat boxes, tubes |
      | Fragile | Custom padded boxes |
      
      **PROVENANCE**:
      
      Created as part of slot migration (Rule 53) from deprecated
      `box_number` slot to generic `has_or_had_identifier` pattern.
    exact_mappings:
      - hc:BoxNumber
    close_mappings:
      - crm:E42_Identifier
    related_mappings:
      - schema:identifier
    slots:
      - numeric_value
      - specificity_annotation
      - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      numeric_value:
        required: true
        minimum_value: 1
        description: The box number (position on shelf or inventory number).
    comments:
      - Storage box position identifier
      - Typically integer representing shelf position or inventory number
      - Part of Rule 53 slot migration from box_number
      - "Updated 2026-01-16: Migrated from inline attributes to proper slots"
    see_also:
      - https://nde.nl/ontology/hc/StorageUnit
      - https://www.wikidata.org/wiki/Q854619