glam/schemas/20251121/linkml/modules/classes/Warehouse.yaml

id: https://nde.nl/ontology/hc/class/warehouse
name: warehouse_class
title: Warehouse Class
imports:
- linkml:types
- ./ReconstructedEntity
- ./CustodianObservation
- ./ReconstructionActivity
- ../slots/has_or_had_access_restriction
- ../slots/climate_control_type
- ../slots/contents_description
- ../slots/has_climate_control
- ../slots/has_forklift_access
- ../slots/has_loading_dock
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/warehouse_description
- ../slots/warehouse_floor_area_sqm
- ../slots/warehouse_id
- ../slots/warehouse_managed_by
- ../slots/warehouse_name
- ../slots/warehouse_security_level
- ../slots/warehouse_type
- ../slots/was_derived_from
- ../slots/was_generated_by
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  org: http://www.w3.org/ns/org#
  dcterms: http://purl.org/dc/terms/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  prov: http://www.w3.org/ns/prov#
  skos: http://www.w3.org/2004/02/skos/core#
  aat: http://vocab.getty.edu/aat/
classes:
  Warehouse:
    is_a: ReconstructedEntity
    class_uri: aat:300007775
    description: |
      General warehouse or logistics facility for heritage custodian operations.

      **DEFINITION**:

      A Warehouse is a general-purpose storage and logistics facility used by
      heritage custodians for non-collection materials such as exhibition
      equipment, supplies, furniture, and operational materials. Distinguished
      from the Storage class which is specifically for climate-controlled
      collection storage.

      **GETTY AAT ALIGNMENT**:

      `aat:300007775` (warehouses) - "Buildings or sections of buildings used
      for storage of goods or materials."

      **CRITICAL DISTINCTION FROM Storage**:

      | Property | Storage | Warehouse |
      |----------|---------|-----------|
      | **Contents** | Collection materials | Non-collection items |
      | **Climate** | Controlled (T/RH) | Basic (may not be controlled) |
      | **Security** | High (valuable items) | Standard |
      | **Staff access** | Collections staff | Operations/facilities staff |
      | **Purpose** | Preservation | Logistics/operations |

      **TYPICAL WAREHOUSE CONTENTS**:

      - **Exhibition equipment**: Display cases, lighting, pedestals
      - **Packing materials**: Crates, foam, tissue, boxes
      - **Furniture**: Office furniture, event furniture
      - **Supplies**: Cleaning supplies, office supplies
      - **Signage**: Exhibition signage, wayfinding signs
      - **Technical equipment**: AV equipment, tools
      - **Archive boxes**: Empty/unused archival housing

      **USE CASES**:

      1. **Exhibition Equipment Warehouse**:
         ```yaml
         Warehouse:
           warehouse_id: "https://nde.nl/ontology/hc/aux/rm-logistics-warehouse"
           warehouse_name: "Rijksmuseum Logistics Warehouse"
           warehouse_type: EXHIBITION_EQUIPMENT
           contents_description: "Exhibition cases, lighting rigs, pedestals, crates"
         ```

      2. **General Supplies Warehouse**:
         ```yaml
         Warehouse:
           warehouse_name: "KB Operations Warehouse"
           warehouse_type: GENERAL_SUPPLIES
           contents_description: "Office furniture, cleaning supplies, archival boxes"
         ```

      **RELATIONSHIP TO Storage CLASS**:

      ```
      Heritage Custodian Storage Locations:

      Storage (class)           Warehouse (class)
      ├── Collection materials  ├── Exhibition equipment
      ├── Climate-controlled    ├── Packing materials
      ├── High security         ├── Furniture/supplies
      └── Preservation focus    └── Operations focus
      ```

      If in doubt whether items are "collection" or "operational":
      - Accessioned items with inventory numbers → Storage
      - Non-accessioned operational items → Warehouse      
    exact_mappings:
    - aat:300007775
    close_mappings:
    - org:Site
    - schema:Place
    - schema:Warehouse
    related_mappings:
    - hc:Storage
    - schema:LocalBusiness
    slots:
    - has_or_had_access_restriction
    - climate_control_type
    - contents_description
    - has_climate_control
    - has_forklift_access
    - has_loading_dock
    - specificity_annotation
    - template_specificity
    - warehouse_description
    - warehouse_floor_area_sqm
    - warehouse_id
    - warehouse_managed_by
    - warehouse_name
    - warehouse_security_level
    - warehouse_type
    - was_derived_from
    - was_generated_by
    slot_usage:
      warehouse_id:
        slot_uri: dcterms:identifier
        description: |
          Unique identifier for this warehouse.
          Format: URI following NDE Heritage Custodian ontology conventions.          
        range: uriorcurie
        required: true
        identifier: true
        examples:
        - value: https://nde.nl/ontology/hc/aux/rm-logistics-warehouse
          description: Rijksmuseum logistics warehouse
      warehouse_name:
        slot_uri: skos:prefLabel
        description: |
          Name of this warehouse facility.

          SKOS: prefLabel for preferred name.          
        range: string
        required: true
        examples:
        - value: Rijksmuseum Logistics Warehouse
          description: Museum logistics facility
        - value: KB Operations Warehouse Leiden
          description: Library operations warehouse
      warehouse_description:
        slot_uri: dcterms:description
        description: |
          Free-text description of this warehouse.

          Include:
          - What is stored here
          - Operational purpose
          - Access arrangements          
        range: string
        examples:
        - value: Logistics warehouse for exhibition equipment, packing materials,
            and furniture. Facilities team access only.
          description: Exhibition logistics warehouse
      warehouse_type:
        slot_uri: dcterms:type
        description: |
          Type classification of this warehouse.

          Common types:
          - EXHIBITION_EQUIPMENT: Display cases, lighting, pedestals
          - PACKING_MATERIALS: Crates, boxes, foam, tissue
          - FURNITURE: Office and event furniture
          - GENERAL_SUPPLIES: Mixed operational supplies
          - TECHNICAL_EQUIPMENT: AV, tools, machinery          
        range: WarehouseTypeEnum
        required: true
        examples:
        - value: EXHIBITION_EQUIPMENT
          description: Exhibition equipment storage
        - value: GENERAL_SUPPLIES
          description: General supplies
      contents_description:
        slot_uri: schema:description
        description: |
          Description of typical contents stored in this warehouse.          
        range: string
        examples:
        - value: Exhibition cases, lighting rigs, pedestals, crates, packing foam
          description: Exhibition equipment contents
      warehouse_floor_area_sqm:
        slot_uri: schema:floorSize
        description: |
          Floor area of warehouse in square meters.

          Schema.org: floorSize for area measurement.          
        range: float
        examples:
        - value: 500.0
          description: 500 m² warehouse
      has_loading_dock:
        slot_uri: schema:amenityFeature
        description: |
          Whether warehouse has a loading dock for truck access.          
        range: boolean
        examples:
        - value: true
          description: Has loading dock
      has_forklift_access:
        slot_uri: schema:amenityFeature
        description: |
          Whether warehouse has forklift access/capability.          
        range: boolean
        examples:
        - value: true
          description: Forklift accessible
      has_climate_control:
        slot_uri: schema:amenityFeature
        description: |
          Whether warehouse has climate control (heating/cooling).

          Note: For collection storage with precise climate control, use Storage class.
          Warehouse climate control is typically basic (prevent extremes).          
        range: boolean
        examples:
        - value: true
          description: Basic climate control
        - value: false
          description: Uncontrolled
      climate_control_type:
        slot_uri: schema:additionalType
        description: |
          Type of climate control if present.

          Common types:
          - HEATED: Heating only (prevent freezing)
          - HVAC: Heating and cooling
          - DEHUMIDIFIED: Humidity control
          - NONE: No climate control          
        range: string
        examples:
        - value: HEATED
          description: Heating only
        - value: HVAC
          description: Full HVAC
      warehouse_security_level:
        slot_uri: schema:securityClearance
        description: |
          Security level of this warehouse.

          Typically lower than collection storage:
          - BASIC: Locked, standard alarm
          - STANDARD: Access control, CCTV
          - ENHANCED: Additional monitoring          
        range: string
        examples:
        - value: STANDARD
          description: Standard security
      has_or_had_access_restriction:
        slot_uri: schema:conditionsOfAccess
        description: |
          Access restriction for this warehouse.          
        range: string
        examples:
        - value: Facilities staff only
          description: Staff restriction
        - value: Operations team badge required
          description: Badge access
      warehouse_managed_by:
        slot_uri: schema:provider
        description: |
          Department or team that manages this warehouse.

          Schema.org: provider for managing entity.          
        range: string
        examples:
        - value: Facilities Management
          description: Facilities team
        - value: Exhibition Services
          description: Exhibition team
      was_derived_from:
        slot_uri: prov:wasDerivedFrom
        description: |
          CustodianObservation(s) from which this warehouse record was derived.

          PROV-O: wasDerivedFrom for observation provenance.          
        range: CustodianObservation
        multivalued: true
        required: false
      was_generated_by:
        slot_uri: prov:wasGeneratedBy
        description: |
          ReconstructionActivity that generated this warehouse record.

          PROV-O: wasGeneratedBy for generation activity.          
        range: ReconstructionActivity
        required: false
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    comments:
    - Warehouse models general logistics/operations storage facilities
    - Getty AAT 300007775 for warehouses
    - 'CRITICAL: Distinguished from Storage class (which is for collection materials)'
    - Warehouse = non-collection items (equipment, supplies, furniture)
    - Storage = collection materials (climate-controlled, high security)
    see_also:
    - http://vocab.getty.edu/aat/300007775
    - https://schema.org/Warehouse
    examples:
    - value:
        warehouse_id: https://nde.nl/ontology/hc/aux/rm-logistics-warehouse
        warehouse_name: Rijksmuseum Logistics Warehouse
        warehouse_description: Logistics warehouse for exhibition equipment and packing
          materials. Used by exhibition services team.
        warehouse_type: EXHIBITION_EQUIPMENT
        contents_description: Exhibition cases, lighting rigs, pedestals, crates,
          packing foam, display furniture
        warehouse_floor_area_sqm: 800.0
        has_loading_dock: true
        has_forklift_access: true
        has_climate_control: true
        climate_control_type: HEATED
        warehouse_security_level: STANDARD
        access_restriction: Exhibition Services and Facilities staff
        warehouse_managed_by: Exhibition Services
      description: Museum logistics warehouse
    - value:
        warehouse_id: https://nde.nl/ontology/hc/aux/na-supplies-warehouse
        warehouse_name: Nationaal Archief Supplies Warehouse
        warehouse_description: General supplies warehouse for archival boxes, office
          furniture, and operational materials.
        warehouse_type: GENERAL_SUPPLIES
        contents_description: Empty archival boxes, office furniture, cleaning supplies,
          signage
        warehouse_floor_area_sqm: 300.0
        has_loading_dock: true
        has_forklift_access: false
        has_climate_control: false
        warehouse_security_level: BASIC
        warehouse_managed_by: Facilities Management
      description: Archive supplies warehouse
enums:
  WarehouseTypeEnum:
    description: Types of warehouse facilities
    permissible_values:
      EXHIBITION_EQUIPMENT:
        description: Display cases, lighting, pedestals, exhibition furniture
      PACKING_MATERIALS:
        description: Crates, boxes, foam, tissue, packing supplies
      FURNITURE:
        description: Office furniture, event furniture
      GENERAL_SUPPLIES:
        description: Mixed operational supplies
      TECHNICAL_EQUIPMENT:
        description: AV equipment, tools, machinery
      SIGNAGE:
        description: Exhibition signage, wayfinding, banners
slots:
  warehouse_id:
    description: Unique identifier for warehouse
    range: uriorcurie
  warehouse_name:
    description: Name of warehouse
    range: string
  warehouse_description:
    description: Description of warehouse
    range: string
  warehouse_type:
    description: Type of warehouse
    range: WarehouseTypeEnum
  contents_description:
    description: Description of typical contents
    range: string
  warehouse_floor_area_sqm:
    description: Floor area in square meters
    range: float
  has_loading_dock:
    description: Has loading dock
    range: boolean
  has_forklift_access:
    description: Has forklift access
    range: boolean
  climate_control_type:
    description: Type of climate control
    range: string
  warehouse_security_level:
    description: Security level
    range: string
  warehouse_managed_by:
    description: Department managing warehouse
    range: string