# Alpha3Code - ISO 3166-1 alpha-3 country code
#
# Created per slot_fixes.yaml migration for: alpha_3
# Creation date: 2026-01-14
# Rule compliance: 50 (ontology mapping)

id: https://nde.nl/ontology/hc/class/Alpha3Code
name: Alpha3Code
title: ISO 3166-1 Alpha-3 Country Code

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  skos: http://www.w3.org/2004/02/skos/core#
  schema: http://schema.org/

default_prefix: hc

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

classes:
  Alpha3Code:
    class_uri: skos:Concept
    description: |
      ISO 3166-1 alpha-3 country code (three-letter code).
      
      **DEFINITION**:
      
      A three-letter country code as defined by ISO 3166-1 alpha-3 standard.
      Used for representing countries and dependent territories with more
      recognizable abbreviations.
      
      **EXAMPLES**:
      - NLD = Netherlands
      - BEL = Belgium
      - DEU = Germany
      - USA = United States
      
      **ONTOLOGY ALIGNMENT**:
      - SKOS Concept: Codes are concepts in ISO 3166-1 vocabulary
      
    slots:
      - has_or_had_code
    
    slot_usage:
      has_or_had_code:
        pattern: "^[A-Z]{3}$"
        required: true
        description: Three-letter ISO 3166-1 alpha-3 country code
        examples:
          - value: "NLD"
            description: Netherlands
          - value: "BEL"
            description: Belgium
    
    exact_mappings:
      - skos:Concept
    
    annotations:
      specificity_score: "0.30"
      specificity_rationale: "Low specificity - standard country codes used broadly."
    
    examples:
      - value:
          has_or_had_code: "NLD"
        description: Netherlands country code