id: https://nde.nl/ontology/hc/class/ReconstructedEntity
name: reconstructed_entity_class
title: Reconstructed Entity Abstract Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  prov: http://www.w3.org/ns/prov#
imports:
- linkml:types
- ../slots/was_generated_by
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./ReconstructionActivity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
classes:
  ReconstructedEntity:
    class_uri: prov:Entity
    abstract: true
    description: |
      Abstract base class for all entities that are generated by a ReconstructionActivity.

      **RDFS Compliance**:
      This class exists to ensure proper RDFS domain/range semantics for the
      `generates`/`was_generated_by` inverse relationship:
      - `generates`: domain=ReconstructionActivity, range=ReconstructedEntity
      - `was_generated_by`: domain=ReconstructedEntity, range=ReconstructionActivity

      **PROV-O Alignment**:
      Maps to `prov:Entity` - "An entity is a physical, digital, conceptual, or
      other kind of thing with some fixed aspects; entities may be real or imaginary."

      **Subclasses**:
      All reconstructed aspects of a custodian inherit from this class:
      - CustodianLegalStatus (formal legal entity)
      - CustodianName (standardized name)
      - CustodianPlace (physical location)
      - CustodianCollection (collection metadata)
      - DigitalPlatform (digital infrastructure)
      - OrganizationBranch (organizational units)
      - And other aspect entities...

      **Usage Pattern**:
      ```yaml
      # ReconstructionActivity generates ReconstructedEntity instances
      ReconstructionActivity:
        activity_type: ISIL_REGISTRATION
        has_or_had_generate:
          - "https://nde.nl/ontology/hc/legal-status/nl-am-rm"  # CustodianLegalStatus
          - "https://nde.nl/ontology/hc/name/rijksmuseum"       # CustodianName

      # Each ReconstructedEntity links back to its generating activity
      CustodianLegalStatus:
        was_generated_by: "https://nde.nl/ontology/hc/activity/isil-reg-2024"
      ```
    exact_mappings:
    - prov:Entity
    slots:
    - specificity_annotation
    - template_specificity
    - was_generated_by
    slot_usage:
      was_generated_by:
        description: |
          The ReconstructionActivity that generated this entity.
          PROV-O: prov:wasGeneratedBy links Entity to generating Activity.
        required: false
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true