glam/schemas/20251121/linkml/modules/classes/Activity.yaml

id: https://nde.nl/ontology/hc/class/Activity
name: Activity
title: Activity Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  rico: https://www.ica.org/standards/RiC/ontology#
  prov: http://www.w3.org/ns/prov#
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  aat: http://vocab.getty.edu/aat/
  skos: http://www.w3.org/2004/02/skos/core#
default_prefix: hc
imports:
  - linkml:types
  - ../metadata
  - ../slots/20260202_matang/has_description
  - ../slots/20260202_matang/identified_by
  - ../slots/20260202_matang/has_label
  - ../slots/20260202_matang/has_score
  - ../slots/20260202_matang/has_status
  - ../slots/20260202_matang/succeeded_by
  - ../slots/20260202_matang/new/note
  - ../slots/20260202_matang/new/preceding_activity
  - ../slots/20260202_matang/temporal_extent
classes:
  Activity:
    class_uri: prov:Activity
    description: "Base class for activities performed by heritage custodians.\n\n**DEFINITION**:\n\nAn Activity represents a discrete or ongoing action undertaken by a heritage\ncustodian. This is the base class for all activity instances in the ontology.\n\n**ONTOLOGICAL ALIGNMENT**:\n\n| Ontology | Class | Use Case |\n|----------|-------|----------|\n| PROV-O | prov:Activity | Primary - provenance tracking |\n| CIDOC-CRM | crm:E7_Activity | Cultural heritage domain |\n| RiC-O | rico:Activity | Archival activities |\n| Schema.org | schema:Action | Web semantics |\n\n**KEY RELATIONSHIPS**:\n\n```\nActivity\n    \u2502\n    \u251C\u2500\u2500 has_activity_type \u2192 ActivityType (classification)\n    \u2502       \u2514\u2500\u2500 CurationActivityType, ConservationActivityType, etc.\n    \u2502\n    \u251C\u2500\u2500 has_timespan \u2192 TimeSpan (temporal extent)\n    \u2502       \u2514\u2500\u2500 start_date, end_date, fuzzy bounds\n    \u2502\n    \u251C\u2500\u2500 succeeded_by\
      \ \u2192 Activity (succession)\n    \u2502\n    \u2514\u2500\u2500 preceding_activity \u2192 Activity (inverse succession)\n```\n\n**SPECIALIZATION**:\n\nThis base class is extended by domain-specific activity classes:\n- CurationActivity - Collection management (existing, to be refactored)\n- ConservationActivity - Preservation work\n- ExhibitionActivity - Exhibition planning and execution\n- DigitizationActivity - Digital transformation projects\n\n**PROVENANCE (PROV-O)**:\n\nActivities generate provenance information:\n- `prov:Activity` - The activity itself\n- `prov:wasAssociatedWith` - Responsible agents\n- `prov:used` - Entities processed\n- `prov:generated` - Entities created\n- `prov:atTime` - Temporal extent\n"
    exact_mappings:
    - prov:Activity
    close_mappings:
    - crm:E7_Activity
    - rico:Activity
    - schema:Action
    related_mappings:
    - aat:300054277
    slots:
    - identified_by
    - has_label
    - has_description
    - temporal_extent
    - succeeded_by
    - preceding_activity
    - has_status
    - note
    - has_score
    slot_usage:
      identified_by:
#         range: string # uriorcurie
        required: true
        identifier: true
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value:
            identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
        - value:
            identifier_value: https://nde.nl/ontology/hc/activity/nationaal-archief-digitization-voc-2024
      has_label:
#         range: string
        required: true
        examples:
        - value: 2025 Annual Collection Inventory
        - value: VOC Archives Digitization Project Phase 2
      has_description:
#         range: string
        required: false
        examples:
        - value: "Annual physical inventory of the Dutch Masters collection, \ncovering approximately 450 paintings. Spot-check methodology \nwith 20% sample verified against catalog records.\n"
        - value: CurationActivityType
        - value: '[DigitizationActivityType, ResearchActivityType]'
      temporal_extent:
        range: TimeSpan
        required: false
        inlined: true
        examples:
        - value:
            begin_of_the_begin: '2025-01-15'
            end_of_the_end: '2025-03-31'
      succeeded_by:
#         range: string
        multivalued: true
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/activity/conservation-treatment-2025
      preceding_activity:
#         range: string
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/activity/condition-survey-2024
      has_status:
#         range: string
        required: false
        examples:
        - value: IN_PROGRESS
        - value: COMPLETED
        - value: PLANNED
      note:
#         range: string
        multivalued: true
    annotations:
      specificity_score: '0.50'
      specificity_rationale: Moderately specific - Activity is a core domain concept but broadly applicable across all heritage custodian types.
      has_score: null
      custodian_types: "['*']"
    comments:
    - Base class for all heritage domain activities
    - Extended by CurationActivity, ConservationActivity, etc.
    - 'Uses generic slots: has_activity_identifier, has_activity_type, has_timespan'
    - PROV-O primary alignment for provenance tracking
    - Supports activity chaining via succeeded_by/preceding_activity
    see_also:
    - https://www.w3.org/TR/prov-o/
    - http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E7
    - https://www.ica.org/standards/RiC/ontology
    examples:
    - value:
        identified_by:
          identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
        has_label: 2025 Annual Collection Inventory - Dutch Masters
        has_description: "Annual physical inventory of the Dutch Masters collection \n(Gallery of Honour and adjacent galleries). Spot-check methodology \nwith 20% sample verification against CMS records.\n"
        temporal_extent:
          begin_of_the_begin: '2025-01-15'
          end_of_the_end: '2025-03-31'
        has_status: IN_PROGRESS
    - value:
        identified_by:
          identifier_value: https://nde.nl/ontology/hc/activity/kb-digitization-medieval-2024
        has_label: Medieval Manuscripts Digitization Project
        has_description: "High-resolution digitization of 342 medieval manuscripts with \nHTR processing and metadata enhancement. IIIF-compliant output.\n"
        temporal_extent:
          begin_of_the_begin: '2024-03-01'
          end_of_the_end: '2025-12-31'
        has_status: IN_PROGRESS
        preceding_activity: https://nde.nl/ontology/hc/activity/kb-condition-survey-2023