id: https://nde.nl/ontology/hc/class/Name
name: Name
title: Name
description: LinkML class definition for Name
prefixes:
  linkml: https://w3id.org/linkml/
  schema: http://schema.org/
  skos: http://www.w3.org/2004/02/skos/core#
  rico: https://www.ica.org/standards/RiC/ontology#
  wd: http://www.wikidata.org/entity/
# Name class
# Created per slot_fixes.yaml revision for: common_name
#
# MIGRATION NOTE (2026-01-22): Created as part of common_name migration per Rule 53.
# Provides structured representation of names with type classification.

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

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  skos: http://www.w3.org/2004/02/skos/core#
  rdfs: http://www.w3.org/2000/01/rdf-schema#
  dwc: http://rs.tdwg.org/dwc/terms/

imports:
  - linkml:types
  - ../metadata
  - ../slots/has_or_had_type
  - ../slots/has_or_had_language
  - ../slots/has_or_had_label

default_prefix: hc

classes:
  Name:
    class_uri: schema:name
    description: |
      Structured representation of a name associated with an entity.
      
      **MIGRATION NOTE** (2026-01-22):
      Created per slot_fixes.yaml migration from `common_name` string
      to structured Name class per Rule 53.
      
      **Purpose**:
      Provides structured representation for names including:
      - The name value itself (via has_or_had_label)
      - Name type classification (e.g., common name, scientific name, trade name)
      - Language information
      
      **Ontological Alignment**:
      - **Primary** (`class_uri`): `schema:name` - Schema.org name
      - **Close**: `skos:prefLabel`, `rdfs:label` - Label predicates
      - **Related**: `dwc:vernacularName` - Darwin Core vernacular name
      
      **Use Cases**:
      - Biological specimens with common/vernacular names in multiple languages
      - Organizations with official names and trading names
      - Places with indigenous and colonial names
      - Products with brand names and generic names
      
      **Pattern**:
      ```yaml
      has_or_had_name:
        - has_or_had_label: "Dodo"
          has_or_had_type: CommonName
          has_or_had_language: "en"
        - has_or_had_label: "Dronte"
          has_or_had_type: CommonName
          has_or_had_language: "nl"
      ```

    slots:
      - has_or_had_label
      - has_or_had_type
      - has_or_had_language

    slot_usage:
      has_or_had_label:
        description: The name value itself.
        range: string
        required: true
        examples:
          - value: "Dodo"
            description: English common name
          - value: "Dronte"
            description: Dutch common name
      has_or_had_type:
        description: |
          The type classification of this name.
          Range narrowed to NameType class hierarchy.
        range: NameType
        required: false
        examples:
          - value: CommonName
            description: Vernacular/common name
          - value: ScientificName
            description: Binomial nomenclature
      has_or_had_language:
        description: |
          The language of this name (ISO 639-1 code).
        range: string
        required: false
        examples:
          - value: "en"
            description: English
          - value: "nl"
            description: Dutch
          - value: "la"
            description: Latin (for scientific names)

    exact_mappings:
      - schema:name
    close_mappings:
      - skos:prefLabel
      - rdfs:label
    related_mappings:
      - dwc:vernacularName
      - schema:alternateName

    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Name structures applicable to all heritage custodian types.
      custodian_types_primary: M
      specificity_score: 0.25
      specificity_rationale: >-
        Broadly applicable - names are fundamental to all heritage entities
        including biological specimens, organizations, places, and objects.
      template_specificity:
        collection_discovery: 0.30
        person_research: 0.35
        general_heritage: 0.25
      migration_info:
        source_slot: common_name
        migration_date: "2026-01-22"
        rule: "Rule 53"

    comments:
      - "Structured name representation with type and language"
      - "Replaces simple string-valued common_name slot"
      - "Supports multilingual names through has_or_had_language"
      - "Type classification via NameType hierarchy"
      - "Created 2026-01-22 from common_name migration (Rule 53)"

    examples:
      - value:
          has_or_had_label: "Dodo"
          has_or_had_type: CommonName
          has_or_had_language: "en"
        description: English common name for extinct bird
      - value:
          has_or_had_label: "Dronte"
          has_or_had_type: CommonName
          has_or_had_language: "nl"
        description: Dutch common name for same species
      - value:
          has_or_had_label: "Coast Redwood"
          has_or_had_type: CommonName
          has_or_had_language: "en"
        description: English common name for tree species