Skip to content

Class: ProvenanceRecord

A single provenance record capturing one completed process step — who did it, when, on which device, at what configured cost, and what observations were submitted. Corresponds to prov:Activity in W3C PROV-O.

URI: prov:Activity

 classDiagram
    class ProvenanceRecord
    click ProvenanceRecord href "../ProvenanceRecord/"
      ProvenanceRecord : actor_ref

      ProvenanceRecord : actor_role_ref





        ProvenanceRecord --> "1" ActorRoleEnum : actor_role_ref
        click ActorRoleEnum href "../ActorRoleEnum/"



      ProvenanceRecord : completed_at

      ProvenanceRecord : cost_configured

      ProvenanceRecord : device





        ProvenanceRecord --> "1" DeviceTypeEnum : device
        click DeviceTypeEnum href "../DeviceTypeEnum/"



      ProvenanceRecord : duration_seconds

      ProvenanceRecord : id

      ProvenanceRecord : observations_ref

      ProvenanceRecord : org





        ProvenanceRecord --> "1" SocialOrganisation : org
        click SocialOrganisation href "../SocialOrganisation/"



      ProvenanceRecord : override_flag

      ProvenanceRecord : override_reason

      ProvenanceRecord : started_at

      ProvenanceRecord : step_type_ref

Class Properties

Property Value
Class URI prov:Activity

Slots

Name Cardinality and Range Description Inheritance
id 1
Uriorcurie		 A unique identifier for the entity direct
step_type_ref 1
String		 Slug reference to the StepType that was executed (e direct
actor_ref 1
String		 UUID reference to the Actor who performed this step direct
actor_role_ref 1
ActorRoleEnum		 Actor role captured at step time — role may change after the fact so it is sn... direct
org 1
SocialOrganisation		 Reference to the owning SocialOrganisation direct
device 1
DeviceTypeEnum		 Device type used to complete this step direct
started_at 1
Datetime		 Timestamp when the step fragment was presented to the actor direct
completed_at 1
Datetime		 Timestamp when the actor submitted the step direct
duration_seconds 1
Integer		 Derived: completed_at - started_at in whole seconds direct
cost_configured 1
Float		 The c_s scalar from StepCost at time of execution — the configured cost for t... direct
observations_ref 1
String		 JSON blob of field values submitted by the actor during this step direct
override_flag 1
Boolean		 True if the actor acknowledged a constraint warning (UC or PC) and proceeded ... direct
override_reason 0..1
String		 Free-text reason provided by the actor when override_flag is true direct

Usages

used by used in type used
DonationSource provenance range ProvenanceRecord

Identifier and Mapping Information

Schema Source

  • from schema: https://inkind-at.github.io/inkind-knowledge-repo

Mappings

Mapping Type Mapped Value
self prov:Activity
native inkind_knowledge_repo:ProvenanceRecord

LinkML Source

Direct

name: ProvenanceRecord
description: A single provenance record capturing one completed process step — who
  did it, when, on which device, at what configured cost, and what observations were
  submitted.  Corresponds to prov:Activity in W3C PROV-O.
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
slots:
- id
- step_type_ref
- actor_ref
- actor_role_ref
- org
- device
- started_at
- completed_at
- duration_seconds
- cost_configured
- observations_ref
- override_flag
- override_reason
slot_usage:
  org:
    name: org
    range: SocialOrganisation
    required: true
  actor_role_ref:
    name: actor_role_ref
    range: ActorRoleEnum
    required: true
class_uri: prov:Activity

Induced

name: ProvenanceRecord
description: A single provenance record capturing one completed process step — who
  did it, when, on which device, at what configured cost, and what observations were
  submitted.  Corresponds to prov:Activity in W3C PROV-O.
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
slot_usage:
  org:
    name: org
    range: SocialOrganisation
    required: true
  actor_role_ref:
    name: actor_role_ref
    range: ActorRoleEnum
    required: true
attributes:
  id:
    name: id
    description: A unique identifier for the entity.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: schema:identifier
    identifier: true
    alias: id
    owner: ProvenanceRecord
    domain_of:
    - NamedThing
    - SocialOrganisation
    - Actor
    - StorageLocation
    - DonationSource
    - DonationCollection
    - DonationItem
    - DemandSignal
    - Campaign
    - ProvenanceRecord
    range: uriorcurie
    required: true
  step_type_ref:
    name: step_type_ref
    description: Slug reference to the StepType that was executed (e.g., `assign_category`).
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: step_type_ref
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: string
    required: true
  actor_ref:
    name: actor_ref
    description: UUID reference to the Actor who performed this step.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: prov:wasAssociatedWith
    alias: actor_ref
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: string
    required: true
  actor_role_ref:
    name: actor_role_ref
    description: Actor role captured at step time — role may change after the fact
      so it is snapshotted here.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: actor_role_ref
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: ActorRoleEnum
    required: true
  org:
    name: org
    description: Reference to the owning SocialOrganisation. Concrete range applied
      via slot_usage in each class.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: org
    owner: ProvenanceRecord
    domain_of:
    - Actor
    - StorageLocation
    - DonationCollection
    - DemandSignal
    - Campaign
    - ProvenanceRecord
    range: SocialOrganisation
    required: true
  device:
    name: device
    description: Device type used to complete this step.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: device
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: DeviceTypeEnum
    required: true
  started_at:
    name: started_at
    description: Timestamp when the step fragment was presented to the actor.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: started_at
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: datetime
    required: true
  completed_at:
    name: completed_at
    description: Timestamp when the actor submitted the step.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: prov:endedAtTime
    alias: completed_at
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: datetime
    required: true
  duration_seconds:
    name: duration_seconds
    description: 'Derived: completed_at - started_at in whole seconds.  Used for observed
      vs configured cost comparison.'
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: duration_seconds
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: integer
    required: true
  cost_configured:
    name: cost_configured
    description: The c_s scalar from StepCost at time of execution — the configured
      cost for this step type under this organisation.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: cost_configured
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: float
    required: true
  observations_ref:
    name: observations_ref
    description: JSON blob of field values submitted by the actor during this step.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - prov:generated
    rank: 1000
    alias: observations_ref
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: string
    required: true
  override_flag:
    name: override_flag
    description: True if the actor acknowledged a constraint warning (UC or PC) and
      proceeded anyway.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: override_flag
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: boolean
    required: true
  override_reason:
    name: override_reason
    description: Free-text reason provided by the actor when override_flag is true.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: override_reason
    owner: ProvenanceRecord
    domain_of:
    - ProvenanceRecord
    range: string
class_uri: prov:Activity