id: https://nde.nl/ontology/hc/class/DataLicense
name: data_license
title: Data License Class
prefixes:
  linkml: https://w3id.org/linkml/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  cc: http://creativecommons.org/ns#
  hc: https://nde.nl/ontology/hc/
imports:
  - linkml:types
  - ../slots/specificity_annotation
  - ./SpecificityAnnotation
  - ../slots/template_specificity
  - ./TemplateSpecificityScores
  - ../enums/DataLicenseTypeEnum
  - ../enums/DataOpennessLevelEnum
default_prefix: hc

classes:
  DataLicense:
    class_uri: cc:License
    description: |
      A specific data license - the legal instrument that defines how data may be
      used, shared, and redistributed.

      **License Categories:**

      1. **Creative Commons (CC)** - For creative works and data
         - CC0: Public domain dedication (no rights reserved)
         - CC-BY: Attribution required
         - CC-BY-SA: Attribution + ShareAlike (copyleft)
         - CC-BY-NC: Attribution + Non-Commercial
         - CC-BY-ND: Attribution + No Derivatives
         
      2. **Open Data Commons (ODC)** - Specifically for databases
         - PDDL: Public Domain Dedication and License
         - ODC-BY: Attribution License for databases
         - ODbL: Open Database License (Attribution + ShareAlike)
         
      3. **Government Open Licenses**
         - UK OGL: UK Open Government Licence
         - French Licence Ouverte
         - US Public Domain (government works)
         
      4. **Proprietary** - Closed/restricted access
         - Subscription required
         - Terms of service restrictions
         - No redistribution rights

      **Reference**: https://creativecommons.org/licenses/

      **Ontology Alignment:**

      - cc:License (Creative Commons namespace)
      - dcterms:LicenseDocument (Dublin Core)
      - schema:CreativeWork (for license documents)
    exact_mappings:
      - cc:License
    close_mappings:
      - dcterms:LicenseDocument
      - schema:CreativeWork
    attributes:
      id:
        identifier: true
        slot_uri: schema:identifier
        description: |
          Unique identifier for this license.

          Recommended: Use standard SPDX-style identifiers.

          Examples:
          - "cc0-1.0" (Creative Commons Zero 1.0)
          - "cc-by-4.0" (Creative Commons Attribution 4.0)
          - "odc-by-1.0" (Open Data Commons Attribution 1.0)
          - "proprietary-oclc" (OCLC proprietary terms)
        range: uriorcurie
        required: true
      name:
        slot_uri: schema:name
        description: |
          Full official name of the license.

          Examples:
          - "Creative Commons Zero 1.0 Universal"
          - "Creative Commons Attribution 4.0 International"
          - "Open Data Commons Attribution License 1.0"
          - "Open Database License (ODbL) 1.0"
        range: string
        required: true
      has_or_had_abbreviation:
        slot_uri: schema:alternateName
        description: |
          Common has_or_had_abbreviation for the license.

          Examples: "CC0", "CC-BY", "CC-BY-SA", "ODC-BY", "ODbL"
        range: string
      license_type:
        slot_uri: schema:additionalType
        description: |
          Classification of this license by its framework/family.
        range: DataLicenseTypeEnum
        required: true
      openness_level:
        slot_uri: schema:accessMode
        description: |
          Degree of openness on a spectrum from fully open to fully closed.

          This is the PRIMARY indicator for data accessibility:

          - **FULLY_OPEN**: No restrictions (CC0, PDDL)
          - **OPEN_WITH_ATTRIBUTION**: Attribution required (CC-BY, ODC-BY)
          - **OPEN_SHAREALIKE**: Copyleft requirement (CC-BY-SA, ODbL)
          - **RESTRICTED_NONCOMMERCIAL**: Non-commercial only (CC-BY-NC)
          - **RESTRICTED_NO_DERIVATIVES**: No modifications (CC-BY-ND)
          - **CLOSED_SUBSCRIPTION**: Paid access required
          - **CLOSED_PROPRIETARY**: No reuse rights
        range: DataOpennessLevelEnum
        required: true
      license_url:
        slot_uri: cc:legalcode
        description: |
          URL to the official legal text of the license.

          Examples:
          - https://creativecommons.org/publicdomain/zero/1.0/legalcode
          - https://creativecommons.org/licenses/by/4.0/legalcode
          - https://opendatacommons.org/licenses/by/1-0/
        range: uri
        required: true
      deed_url:
        slot_uri: schema:url
        description: |
          URL to the human-readable license summary (the "deed").

          Examples:
          - https://creativecommons.org/publicdomain/zero/1.0/
          - https://creativecommons.org/licenses/by/4.0/
        range: uri
      version:
        slot_uri: schema:version
        description: |
          Version number of the license.

          Examples:
          - "1.0" (CC0 1.0, ODC-BY 1.0)
          - "4.0" (CC-BY 4.0 - current version)
          - "3.0" (legacy CC licenses)
        range: string
      allows_commercial_use:
        slot_uri: cc:commercialUse
        description: |
          Whether the license permits commercial use of the data.

          - true: Commercial use allowed (CC0, CC-BY, ODC-BY, ODbL)
          - false: Non-commercial only (CC-BY-NC, CC-BY-NC-SA)
        range: boolean
        required: true
      requires_attribution:
        slot_uri: cc:attributionRequired
        description: |
          Whether the license requires attribution to the source.

          - true: Attribution required (CC-BY, ODC-BY, ODbL)
          - false: No attribution needed (CC0, PDDL)
        range: boolean
        required: true
      requires_sharealike:
        slot_uri: cc:shareAlike
        description: |
          Whether derivatives must be shared under the same or compatible license.

          - true: ShareAlike/copyleft required (CC-BY-SA, ODbL)
          - false: No ShareAlike requirement (CC0, CC-BY, ODC-BY)
        range: boolean
        required: true
      allows_derivatives:
        slot_uri: cc:DerivativeWorks
        description: |
          Whether the license permits creating derivative works.

          - true: Derivatives allowed (most open licenses)
          - false: No derivatives allowed (CC-BY-ND, CC-BY-NC-ND)
        range: boolean
        required: true
      jurisdiction:
        slot_uri: cc:jurisdiction
        description: |
          Legal jurisdiction of the license (if jurisdiction-specific).

          Most modern licenses (CC 4.0+) are "international" (jurisdiction-agnostic).
          Earlier versions (CC 3.0, 2.x) had jurisdiction-specific "ports".

          Examples:
          - null: International/universal (CC 4.0 licenses)
          - "NL": Netherlands-specific ported license
          - "US": United States-specific
        range: string
      steward_organization:
        slot_uri: schema:maintainer
        description: |
          Organization that maintains and stewards this license.

          Examples:
          - "Creative Commons" (for CC licenses)
          - "Open Knowledge Foundation" (for ODC licenses)
          - "UK National Archives" (for UK OGL)
        range: string
      spdx_identifier:
        slot_uri: dcterms:identifier
        description: |
          SPDX License Identifier for software license compatibility.

          SPDX (Software Package Data Exchange) provides standardized
          identifiers for licenses used in software and data.

          Examples:
          - "CC0-1.0"
          - "CC-BY-4.0"
          - "ODbL-1.0"

          Reference: https://spdx.org/licenses/
        range: string
      description:
        slot_uri: schema:description
        description: |
          Human-readable description of what this license permits and requires.
        range: string
    slots:
      - specificity_annotation
      - template_specificity
    slot_usage:
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true