id: https://nde.nl/ontology/hc/class/Version
name: version_class
title: Version Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  doap: http://usefulinc.com/ns/doap#
imports:
- linkml:types
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/temporal_extent
- ./TimeSpan
default_prefix: hc
classes:
  Version:
    class_uri: schema:SoftwareApplication
    description: |
      A version identifier for software, documents, schemas, or other entities.
      **Purpose**: Represents a structured version record with version number,
      release date, and semantic versioning components.
      **Semantic Versioning Support**:
      - major_version: Breaking changes
      - minor_version: New features (backwards compatible)
      - patch_version: Bug fixes
      **Use Cases**:
      1. **CMS Product Version**: Version of deployed CMS software
      2. **API Version**: REST API version
      3. **Schema Version**: Ontology/schema version
      4. **Document Version**: Document revision number
      **Example**:
      ```yaml
      CollectionManagementSystem:
        cms_name: CollectiveAccess
        has_or_had_version:
          version_string: "1.8.0"
          major_version: 1
          minor_version: 8
          patch_version: 0
          release_date: "2023-06-15"
      ```
      **Migration Note**: Created 2026-01-19 per slot_fixes.yaml (Rule 53).
      Replaces simple string cms_product_version with structured Version class.
    exact_mappings:
      - doap:Version
    close_mappings:
      - schema:version
    slots:
      - temporal_extent
    slot_usage:
      temporal_extent:
        range: TimeSpan
        required: false
        examples:
          - value:
              begin_of_the_begin: "2023-06-15"
              end_of_the_end: null
    annotations:
      custodian_types: '["D"]'
      custodian_types_rationale: Primarily used by digital platforms (D) for software versioning
      specificity_score: 0.55
      specificity_rationale: Moderately specific to software/document version contexts