# Registration Information Classes
# Classes for organizational registration details

id: https://nde.nl/ontology/hc/class/RegistrationInfo
name: registration-info-classes
title: Registration Information Classes

description: >-
  Classes for capturing organizational registration details including
  registration numbers, dates, and authorities.

prefixes:
  linkml: https://w3id.org/linkml/
  heritage: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  rov: http://www.w3.org/ns/regorg#
  org: http://www.w3.org/ns/org#
  tooi: https://identifier.overheid.nl/tooi/def/ont/

imports:
  - linkml:types
  - TimeSpan

classes:
  RegistrationNumber:
    class_uri: rov:registration
    description: >-
      Official registration number assigned by an authority.
      Examples: Chamber of Commerce number, charity registration number.
      
      Maps to:
      - rov:registration (Registered Organizations Vocabulary)
      - schema:identifier
      - tooi:organisatieIdentificatie (TOOI for Dutch entities)
    
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: Unique identifier for this registration record
        range: uriorcurie
        required: true
      
      number:
        slot_uri: rov:registration
        description: >-
          The actual registration number/code.
          Examples: "41215422" (KvK number), "CHY 4700" (Irish charity number)
        range: string
        required: true
      
      type:
        slot_uri: schema:additionalType
        description: >-
          Type of registration number.
          Examples: "KvK" (Dutch Chamber of Commerce), "EIN" (US Employer ID)
        range: string
        required: true
      
      temporal_validity:
        slot_uri: schema:temporalCoverage
        description: >-
          Time period during which this registration number is/was valid.
          Captures registration date through deregistration (if applicable).
        range: TimeSpan
        required: true

  RegistrationAuthority:
    class_uri: rov:hasRegisteredOrganization
    description: >-
      Authority that maintains official registrations of organizations.
      Examples: Chamber of Commerce, Charity Commission, Companies House.
      
      Maps to:
      - rov:RegisteredOrganization (the registering authority)
      - org:Organization
    
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: Unique identifier for the registration authority
        range: uriorcurie
        required: true
      
      name:
        slot_uri: schema:name
        description: >-
          Official name of the registration authority.
          Examples: "Kamer van Koophandel", "Companies House", "IRS"
        range: string
        required: true
      
      abbreviation:
        slot_uri: schema:alternateName
        description: >-
          Common abbreviation.
          Examples: "KvK", "CH", "IRS"
        range: string
      
      jurisdiction:
        slot_uri: schema:areaServed
        description: >-
          Geographic jurisdiction of the authority.
          Usually a country code, may be regional for federal systems.
        range: string
        required: true
      
      website:
        slot_uri: schema:url
        description: Official website of the registration authority
        range: uri
      
      registration_types:
        slot_uri: schema:knowsAbout
        description: >-
          Types of entities this authority can register.
          Examples: ["companies", "charities", "foundations"]
        range: string
        multivalued: true

  GovernanceStructure:
    class_uri: org:hasUnit
    description: >-
      Organizational governance structure including departments, branches, and units.
      Used to model the internal structure of complex organizations.
      
      Maps to:
      - org:hasUnit (W3C Organization Ontology)
      - org:OrganizationalUnit
    
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: Unique identifier for the governance structure
        range: uriorcurie
        required: true
      
      structure_type:
        slot_uri: schema:additionalType
        description: >-
          Type of governance structure.
          Examples: "hierarchical", "matrix", "flat", "network"
        range: string
        required: true
      
      organizational_units:
        slot_uri: org:hasUnit
        description: >-
          List of organizational units within the structure.
          Note: Range references CustodianLegalStatus (circular dependency handled at runtime).
        range: string
        multivalued: true
      
      governance_body:
        slot_uri: org:reportsTo
        description: >-
          Top-level governance body (board, trustees, council).
          Note: Range references CustodianLegalStatus (circular dependency handled at runtime).
        range: string
      
      description:
        slot_uri: schema:description
        description: Description of the governance structure and its characteristics
        range: string

  LegalStatus:
    class_uri: schema:status
    description: >-
      Legal status of an organization (active, dissolved, suspended, etc.).
      Status definitions vary by jurisdiction and legal framework.
    
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: Unique identifier for the legal status
        range: uriorcurie
        required: true
      
      status_code:
        slot_uri: schema:codeValue
        description: >-
          Standardized status code.
          Examples: "ACTIVE", "DISSOLVED", "SUSPENDED", "MERGED"
        range: string
        required: true
        pattern: "^[A-Z_]+$"
      
      status_name:
        slot_uri: schema:name
        description: Human-readable status name
        range: string
        required: true
      
      description:
        slot_uri: schema:description
        description: Detailed description of what this status means legally
        range: string
      
      temporal_validity:
        slot_uri: schema:temporalCoverage
        description: Time period during which this status applies
        range: TimeSpan
        required: true
      
      jurisdiction:
        slot_uri: schema:legislationJurisdiction
        description: Legal jurisdiction where this status is defined
        range: string