Valueflows

Valueflows is a set of common vocabularies to describe flows of economic resources of all kinds within distributed economic ecosystems. It implements an Resources, Events, Agents (REA) model which can be expressed in several data formats like Resource Description Framework (RDF), GraphQL or UML.

Examples

These and more can be found here on the project’s website.

Resources

'@context':
  - https://git.io/vf-examples-jsonld-context
  - farm: https://farm.example/
    ose: https://www.opensourceecology.org/

'@id': rgh:valueflows/valueflows/master/examples/resource.yaml
'@graph':

  - '@id': ose:822b6baf-d66f-45a0-98f2-57450e2aec23
    '@type': ResourceSpecification
    name: Tractor - LifeTrac 6
    uri: https://www.opensourceecology.org/portfolio/tractor/
    image: https://www.opensourceecology.org/wp-content/uploads/2014/02/Tractor_gray.png
    defaultUnit: unit:Number
    substitutable: true
    resourceClassifiedAs: https://www.wikidata.org/wiki/Q39495
    skos:note: A versatile, 4-wheel drive, hydraulically-driven tractor with 18 to 200 horsepower capacity for agriculture, construction and other utility duties.

  - '@id': farm:fbff9852-36ca-4364-a943-bc0b49e1cab5
    '@type': EconomicResource
    name: Tractor - LifeTrac 6
    trackingIdentifier: 889jcd00s # the serial number assigned by the manufacturer
    conformsTo: ose:822b6baf-d66f-45a0-98f2-57450e2aec23
    accountingQuantity:
      om2:hasUnit: om2:one
      om2:hasNumericalValue: 1

  - '@id': farm:8baa8ff7-9c1e-4586-ae7b-79d620a3cac9
    '@type': ResourceSpecification
    name: Carrots organic
    defaultUnit: unit:Kilogram
    substitutable: true
    resourceClassifiedAs: https://www.wikidata.org/wiki/Q39495
    skos:note: Organic loose carrots without tops. 

  - '@id': farm:07819789-dd51-44c3-b35c-9210165bc832
    '@type': EconomicResource
    name: Loose organic carrots
    lot: farm:fd399b37-0740-4a68-a184-1e655021ca21 # the lot number assigned by the farm
    conformsTo: farm:8baa8ff7-9c1e-4586-ae7b-79d620a3cac9
    accountingQuantity:
      om2:hasUnit: om2:kilogram
      om2:hasNumericalValue: 650
    skos:note: Medium size, clean, harvested after the first frost, will store well.

  - '@id': farm:fd399b37-0740-4a68-a184-1e655021ca21
    '@type': dfc:ProductBatch
    dfc:batchNumber: 3409888

  - '@id': farm:68cabaf3-deb8-4bd5-a439-798263abe35a
    '@type': ResourceSpecification
    name: Farm documentation
    defaultUnit: unit:Number
    substitutable: false
    resourceClassifiedAs: https://www.wikidata.org/wiki/Q49848 # document
    skos:note: Any of the documentation produced and/or used by the farm.

  - '@id': farm:a7e94dde-2997-451e-a7e1-8d364d5e6dee
    '@type': EconomicResource
    name: Intern orientation instructions
    conformsTo: farm:68cabaf3-deb8-4bd5-a439-798263abe35a
    uri: https://farm.example/docs/intern-orientation.odt
    accountingQuantity:
      om2:hasUnit: om2:one
      om2:hasNumericalValue: 1

Agents and Agent Relationships

'@context':
  - https://git.io/vf-examples-jsonld-context
  - alice: https://alice.example/
    bob: https://bob.example/
    fablab: https://fablab.example/
    coop: https://coop.example/

'@id': rgh:valueflows/valueflows/master/examples/agent.yaml
'@graph':

  # Agents

  - '@id': https://alice.example/
    '@type': foaf:Person
    name: Alice
    image: https://alice.example/avatar.png
    primaryLocation: https://somelocation.example
    skos:note: Alice is a mechanical engineer who likes to work in the fablab.

  - '@id': https://bob.example/
    '@type': foaf:Person
    name: Bob

  - '@id': https://fablab.example/
    '@type': org:Organization
    name: Driftless Fablab

  - '@id': https://coop.example/
    '@type': org:Organization
    name: Community Tool Lending Coop

  # Roles

  - '@id': fablab:52f0e212-3c4f-4d27-b345-5e964c135824
    '@type': AgentRelationshipRole
    roleLabel: is member of
    inverseRoleLabel: has member
    skos:note: Both persons and organizations can be members of this fablab.

  - '@id': fablab:02b39a30-3e04-4305-9656-7f261aa63c84
    '@type': AgentRelationshipRole
    roleLabel: is supplier of
    inverseRoleLabel: is customer of

  - '@id': fablab:a25500e0-0106-43cd-8cbb-e74779488835
    '@type': AgentRelationshipRole
    roleLabel: mentors
    inverseRoleLabel: has mentor

  # Relationships

  - '@id': fablab:6b97b1be-8e07-44ac-82e5-214f1b2aaf33
    '@type': AgentRelationship
    subject: https://alice.example/
    relationship: fablab:52f0e212-3c4f-4d27-b345-5e964c135824 # member
    object: https://fablab.example/

  - '@id': fablab:a8236bbb-81e0-422d-9861-56d2417db0fb
    '@type': AgentRelationship
    subject: https://coop.example/
    relationship: fablab:02b39a30-3e04-4305-9656-7f261aa63c84 # trading partner
    object: https://fablab.example/
    skos:note: The coop is a supplier of tools for the fablab.

  - '@id': fablab:6f438393-7f87-4914-806c-e23a4fd15e89
    '@type': AgentRelationship
    subject: https://alice.example/
    relationship: fablab:a25500e0-0106-43cd-8cbb-e74779488835 # mentor
    object: https://bob.example/
    inScopeOf: https://fablab.example/
    skos:note: Alice mentors Bob at the fablab.

Further Reading