id: https://w3id.org/heritage/custodian/dutch
name: dutch
title: Dutch Heritage Custodian Module
description: >-
  Dutch-specific extensions for heritage institutions, including KvK registration,
  regional identifiers, and integration with national aggregation platforms
  (Museum Register, Rijkscollectie, Collectie Nederland, Archieven.nl).
  Integrates TOOI (Thesaurus Overheidsorganisaties en Overheidspersonen) patterns
  for Dutch public organizations.

license: https://creativecommons.org/publicdomain/zero/1.0/
version: 0.2.1

prefixes:
  linkml: https://w3id.org/linkml/
  heritage: https://w3id.org/heritage/custodian/
  tooi: https://identifier.overheid.nl/tooi/def/ont/
  dcterms: http://purl.org/dc/terms/

default_prefix: heritage
default_range: string

imports:
  - linkml:types
  - core

# =============================================================================
# DUTCH-SPECIFIC CLASS
# =============================================================================

classes:
  # TOOI Ontology Proxy Class
  # Local proxy for Dutch government organizational ontology
  
  TOOIOverheidsorganisatie:
    description: >-
      Local proxy for tooi:Overheidsorganisatie (Government Organization in TOOI ontology).
      Represents Dutch public sector organizations with government affiliation.
      Used as mixin for DutchHeritageCustodian to align with TOOI patterns.
    class_uri: tooi:Overheidsorganisatie
    abstract: true
    notes: >-
      This is a mixin class providing TOOI ontology alignment for Dutch public institutions.
      In RDF serialization, DutchHeritageCustodian will also be typed as tooi:Overheidsorganisatie.

  DutchHeritageCustodian:
    description: >-
      A heritage custodian organization based in the Netherlands, with additional
      Dutch-specific identification and organizational metadata. Integrates with
      TOOI (Thesaurus Overheidsorganisaties) for public sector organizations.
      Network memberships and thematic partnerships are represented using the
      universal Partnership class (not Dutch-specific boolean flags).
    is_a: HeritageCustodian
    mixins:
      - TOOIOverheidsorganisatie
    slots:
      - kvk_number
      - gemeente_code
    slot_usage:
      identifiers:
        description: Must include ISIL code if registered in Dutch ISIL registry
        comments:
          - "Dutch ISIL codes follow pattern: NL-{City}{Abbreviation}"
          - "Example: NL-AsdAM (Amsterdam Museum)"
      partnerships:
        description: >-
          Use Partnership objects for ALL network and platform memberships:
          
          National platforms: Museum Register, Rijkscollectie, Collectie Nederland, Archieven.nl
          (partnership_type: 'national_museum_certification', 'national_collection_designation', 
          'national_aggregation_platform', 'national_archival_portal')
          
          EU/International: Archives Portal Europe, DC4EU
          (partnership_type: 'international_platform', 'eu_platform')
          
          Digitization programs: Versnellen
          (partnership_type: 'digitization_program')
          
          Thematic networks: WO2Net, Modemuze, Maritiem Digitaal, Delfts aardewerk, 
          Academisch Erfgoed, Coleccion Aruba, Van Gogh Worldwide, OODE24
          (partnership_type: 'thematic_network')
        comments:
          - "Example: Partnership(partner_name='WO2Net', partnership_type='thematic_network')"
          - "Example: Partnership(partner_name='DC4EU', partnership_type='eu_platform', description='API integration')"
          - "Example: Partnership(partner_name='Museum Register', partnership_type='national_museum_certification')"
      locations:
        description: >-
          Use locations[0].region for Dutch province (Noord-Holland, Zuid-Holland, etc.).
          The core schema's 'region' field is universal (state/province/region).
        comments:
          - "Province goes in Location.region, not a separate field"
          - "Example: Location(city='Amsterdam', region='Noord-Holland', country='NL')"

# =============================================================================
# DUTCH-SPECIFIC SLOTS
# =============================================================================

slots:
  kvk_number:
    description: >-
      Dutch Chamber of Commerce number (Kamer van Koophandel).
      8-digit numeric identifier for organizations registered in the Netherlands.
      
      NOTE: This is a Dutch-specific field. The universal equivalent is
      'chamber_of_commerce_number' in core.yaml, which works for any country
      (Brazil: CNPJ, USA: EIN, UK: Companies House number, etc.).
    range: string
    pattern: "^[0-9]{8}$"
    slot_uri: dcterms:identifier
    comments:
      - "Required for all Dutch legal entities"
      - "Format: 8 digits, no spaces or hyphens"
      - "Example: 41224096"
      - "Universal equivalent: chamber_of_commerce_number (see core.yaml)"

  gemeente_code:
    description: >-
      Dutch municipality code (CBS gemeentecode).
      4-digit code identifying the municipality where the institution is located.
      
      NOTE: This is a Dutch-specific field. The universal equivalent is
      'municipality_identifier' in core.yaml, which works for any country's
      local government coding systems.
    range: string
    pattern: "^[0-9]{4}$"
    slot_uri: tooi:gemeente
    comments:
      - "Based on CBS (Statistics Netherlands) coding system"
      - "Example: 0363 (Amsterdam)"
      - "Universal equivalent: municipality_identifier (see core.yaml)"