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

id: https://nde.nl/ontology/hc/class/Alpha2Code
name: Alpha2Code
title: ISO 3166-1 Alpha-2 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:
  Alpha2Code:
    class_uri: skos:Concept
    description: |
      ISO 3166-1 alpha-2 country code (two-letter code).
      
      **DEFINITION**:
      
      A two-letter country code as defined by ISO 3166-1 alpha-2 standard.
      Used for representing countries and dependent territories.
      
      **EXAMPLES**:
      - NL = Netherlands
      - BE = Belgium
      - DE = Germany
      - US = United States
      
      **ONTOLOGY ALIGNMENT**:
      - SKOS Concept: Codes are concepts in ISO 3166-1 vocabulary
      - Schema.org: addressCountry can use alpha-2 codes
      
    slots:
      - has_or_had_code
    
    slot_usage:
      has_or_had_code:
        pattern: "^[A-Z]{2}$"
        required: true
        description: Two-letter ISO 3166-1 alpha-2 country code
        examples:
          - value: "NL"
            description: Netherlands
          - value: "BE"
            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: "NL"
        description: Netherlands country code