valueflows

valueflows docs
git clone https://s.sonu.ch/~srfsh/valueflows.git
Log | Files | Refs | README

commit 8c250684c9395db65ce91a4fd72311dc70d3dbad
parent 359bd36f91ec853e93b93d6e52f30af5c4660feb
Author: elf Pavlik <elf-pavlik@hackers4peace.net>
Date:   Fri,  9 Nov 2018 18:48:35 -0600

generalized scoping (#289)

generalized scoping
Diffstat:
Mdocs/SUMMARY.md | 8+++++++-
Ddocs/introduction/scope.md | 29-----------------------------
Adocs/introduction/scoping.md | 32++++++++++++++++++++++++++++++++
Mrelease-doc-in-process/all_vf.TTL | 8++++----
4 files changed, 43 insertions(+), 34 deletions(-)

diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md @@ -1,6 +1,7 @@ # Summary ## Introduction + * [Introduction](README.md) * [Flows of Value](introduction/concepts.md) * [Core](introduction/core.md) @@ -8,29 +9,34 @@ * [Status](introduction/status.md) ## Diagrams + * [RDF Diagram](specification/diagrams/vowl.md) * [UML Diagram](specification/diagrams/uml.md) ## Concepts + * [Agent](introduction/agents.md) * [Resource](introduction/resources.md) * [Flows](introduction/flows.md) * [Process](introduction/processes.md) * [Exchange](introduction/exchanges.md) * [Proposals](introduction/proposals.md) -* [Scoping](introduction/scope.md) +* [Scoping](introduction/scoping.md) * [Classification](introduction/classification.md) * [Conversation for Action](introduction/cfa.md) * [Accounting](introduction/accounting.md) ## Specification + * [Classes and Properties](http://www.essepuntato.it/lode/owlapi/https://raw.githubusercontent.com/valueflows/valueflows/master/release-doc-in-process/all_vf.TTL) ## Appendices + * [REA References](appendix/rea.md) * [Uses of the Vocabulary](introduction/usedfor.md) ### Algorithms + * [Overview](appendix/overview.md) * [Dependent Demand](appendix/dependent-demand.md) * [Critical Path](appendix/critical-path.md) diff --git a/docs/introduction/scope.md b/docs/introduction/scope.md @@ -1,29 +0,0 @@ -# Scoping - -Scope defines a boundary or context for sets of economic events, commitments, and intents. This can be for purposes of: -* accounting -* planning -* distributing income - -The scope is where work is done, where processes live, where value is created and exchanged. Economic events and commitments can reference an organization (an agent) as an entity that defines their scope. It may be a formal or informal organization, and will include the network(s) themselves. Or economic events and commitments can reference a geographic area (a city, a bioregion, etc.), or a community, or a loose network, or a less formal shorter lived project, or any other bounded concept that is useful for grouping economic events. - -An economic event or commitment can reference any number of entities to define scopes it belongs to. It is not required that events, commitments, or intents designate a scope. In fact, sometimes the scope is the same as the provider or recipient agent. Or sometimes there is no useful scope. - -A scope is different than an agreement, although sometimes something that is a scope will have agreements that define some of the economic governance of that scope. - -For functions that require traversing value flows, often the value flow will cross from one scope to another. For example, perhaps another network or organization makes a component that you consume when making your product. When this happens, there are some options. -* Standing agreements can govern what happens. -* A conversation for action might be required to determine what should occur for the specific instance. - -#### Accounting - -Accounting is usually done for an agent or other bounded scope. Where a computer system supports one enterprise, this is simple. When a computer system supports many organizations or there is a distributed network of economic activity, it is useful to be able to segregate the accounting using scope. It basically enables multi-party accounting in a networked scenario. - -#### Planning - -Sometimes a generic recipe will cross scope boundaries for particular agents. For example one agent could produce a resource that consumes a component made by another agent. In this case, can the first agent schedule the production of the component by the second agent? Possibly yes, if there are agreements in place for that, and the first agent has verified that inventory does not already exist. Or possibly, based again on agreements, the first agent can assume the second agent will provide the component, with the second agent taking responsibility for checking if it is onhand, and if not, scheduling it for production. Or possibly, the first agent plans only to source the component in some way. - -#### Income Distribution - -Some organizations distribute income backwards on value flows, based on people's contributions to the resources that generated the income. When traversing the value chain, it is useful to know when the traversal has crossed a scope boundary, because it is possible that the rules for distributing the income will change for a different scope. If the rules change or the rules are unknown, the income can be passed on to the other scope for them to distribute. - diff --git a/docs/introduction/scoping.md b/docs/introduction/scoping.md @@ -0,0 +1,32 @@ +# Scoping + +`vf:inScopeOf` + +Scoping allows grouping entities together in a defined boundary or context. Mostly used for sets of economic events, commitments, and intents. This can be for purposes of: + +* accounting +* planning +* distributing incoming resources + +The scope is where work is done, where processes live, where value is created and exchanged. Economic events, commitments and intents can reference an organization (an agent) as an entity that defines their scope. It may be a formal or informal organization, and will include the network(s) themselves. Or economic events, commitments and intents can reference a geographic area (a city, a bio-region, etc.), or a community, or a loose network, or a less formal shorter lived project, or plan, or any other bounded concept that is useful for grouping economic events. + +An economic event, commitment or intent can reference any number of entities which scope it. It is not required that events, commitments, or intents designate a scope. In fact, sometimes the scope is the same as the provider or recipient agent. Or sometimes there is no useful scope. + +A scope is different than an agreement, although sometimes something that is a scope will have agreements that define some of the economic governance of that scope. + +For functions that require traversing value flows, often the value flow will cross from one scope to another. For example, perhaps another network or organization makes a component that you consume when making your product. When this happens, there are some options. + +* Standing agreements can govern what happens. +* A conversation for action might be required to determine what should occur for the specific instance. + +## Accounting + +Accounting is usually done for an agent or other bounded scope. Where a computer system supports one enterprise, this is simple. When a computer system supports many organizations or there is a distributed network of economic activity, it is useful to be able to segregate the accounting using scope. It basically enables multi-party accounting in a networked scenario. + +## Planning + +Sometimes a generic recipe will cross scope boundaries for particular agents. For example one agent could produce a resource that consumes a component made by another agent. In this case, can the first agent schedule the production of the component by the second agent? Possibly yes, if there are agreements in place for that, and the first agent has verified that inventory does not already exist. Or possibly, based again on agreements, the first agent can assume the second agent will provide the component, with the second agent taking responsibility for checking if it is onhand, and if not, scheduling it for production. Or possibly, the first agent plans only to source the component in some way. + +## Distributing Incoming Resources + +Some organizations distribute incoming resources backwards on value flows, based on people's contributions to the resources that generated the income. When traversing the value chain, it is useful to know when the traversal has crossed a scope boundary, because it is possible that the rules for distributing the incoming resources will change for a different scope. If the rules change or the rules are unknown, the income can be passed on to the other scope for them to distribute. diff --git a/release-doc-in-process/all_vf.TTL b/release-doc-in-process/all_vf.TTL @@ -279,11 +279,11 @@ vf:object a owl:ObjectProperty ; rdfs:range foaf:Agent ; rdfs:comment "The object of a relationship between 2 agents." . -vf:scope a owl:ObjectProperty ; - rdfs:domain [ owl:unionOf (vf:EconomicEvent vf:Commitment vf:AgentRelationship) ] ; - rdfs:label "scope" ; +vf:inScopeOf a owl:ObjectProperty ; + rdfs:domain owl:Thing ; + rdfs:label "in scope of" ; rdfs:range owl:Thing ; - rdfs:comment "The larger boundary or context, used for documenting, accounting, planning, distributing income." . + rdfs:comment "Grouping around something to create a boundary or context, used for documenting, accounting, planning." . vf:under a owl:ObjectProperty ; rdfs:domain [ owl:unionOf (vf:EconomicEvent vf:Commitment vf:Reciprocity vf:Fulfillment ) ] ;