# Legal Form Class
# Specific legal forms based on ISO 20275 Entity Legal Forms standard

id: https://nde.nl/ontology/hc/class/LegalForm
name: legal-form-class
title: Legal Form Class

description: >-
  Specific legal forms of organizations as defined by national and international law.
  Based on ISO 20275 Entity Legal Form (ELF) codes.

prefixes:
  linkml: https://w3id.org/linkml/
  rov: http://www.w3.org/ns/regorg#
  gleif: https://www.gleif.org/ontology/Base/
  iso20275: https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list

imports:
  - linkml:types
  - ../metadata
  - ./LegalEntityType
  - ./Country

classes:
  LegalForm:
    class_uri: rov:orgType
    description: >-
      Legal form of an organization as recognized by law.
      Based on ISO 20275 Entity Legal Forms (ELF) standard.
      
      Maps to:
      - rov:orgType (Registered Organizations Vocabulary)
      - gleif:hasLegalForm (GLEIF ontology)
      - tooi:rechtsvorm (TOOI for Dutch entities)
    
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: Unique identifier for the legal form
        range: uriorcurie
        required: true
      
      elf_code:
        slot_uri: gleif:hasEntityLegalFormCode
        description: >-
          ISO 20275 Entity Legal Form code (4 alphanumeric characters).
          Examples: 8888 (Stichting), RJFM (Public Limited Company)
        range: string
        required: true
        pattern: "^[A-Z0-9]{4}$"
      
      country_code:
        slot_uri: schema:addressCountry
        description: >-
          Country jurisdiction for this legal form.
          
          Links to Country class with ISO 3166-1 codes.
          
          Legal forms are jurisdiction-specific - a "Stichting" in Netherlands (NL)
          has different legal meaning than a "Fundación" in Spain (ES).
          
          Schema.org: addressCountry indicates jurisdiction.
          
          Examples:
          - Dutch Stichting → country.alpha_2 = "NL"
          - German GmbH → country.alpha_2 = "DE"
          - French Association → country.alpha_2 = "FR"
        range: Country
        required: true
      
      local_name:
        slot_uri: schema:name
        description: >-
          Name of the legal form in the local language.
          Examples: "Stichting", "Gesellschaft mit beschränkter Haftung"
        range: string
        required: true
      
      transliterated_name:
        slot_uri: schema:alternateName
        description: >-
          Transliterated name for non-Latin scripts.
          Used for legal forms from countries using non-Latin alphabets.
        range: string
      
      abbreviation:
        slot_uri: schema:additionalName
        description: >-
          Common abbreviation of the legal form.
          Examples: "BV", "GmbH", "LLC"
        range: string
      
      legal_entity_type:
        slot_uri: org:classification
        description: >-
          Reference to the high-level LegalEntityType.
          Links to either PERSON or ORGANIZATION.
        range: LegalEntityType
        required: true
      
      parent_form:
        slot_uri: org:hasSubOrganization
        description: >-
          Parent legal form in the hierarchy.
          Example: "Limited Company" may have subtypes like "Public Limited Company"
        range: LegalForm
      
      valid_from:
        slot_uri: schema:validFrom
        description: Date when this legal form code became valid
        range: date
      
      valid_to:
        slot_uri: schema:validThrough
        description: Date when this legal form code ceased to be valid (if applicable)
        range: date
    
    comments:
      - "ISO 20275 defines over 1,600 legal forms across 150+ jurisdictions"
      - "Each legal form has specific rights, obligations, and governance requirements"
      - "Legal forms determine tax treatment, liability, and reporting requirements"