commit 75045b1549da04bce76ea5ff68f961916e980813 parent a3c8f8a7c5bd5785ec61f24a86374826bd700cf3 Author: Bob Haugen <bob.haugen@gmail.com> Date: Thu, 15 Aug 2019 13:58:25 -0500 Merge pull request #557 from valueflows/possession trial balloon for tranfer naming Diffstat:
21 files changed, 138 insertions(+), 220 deletions(-)
diff --git a/docs/introduction/flows.md b/docs/introduction/flows.md @@ -52,14 +52,16 @@ All flows use an action property to designate what the flow is doing and how it * vf:consume - for example an ingredient or component composed into the output, after the process the ingredient is gone * vf:cite - for example a design file, neither used nor consumed, the file remains available at all times * vf:work - labor power applied to a process -* vf:load - transported resource enters the process, the same resource will appear in output with *vf:unload* verb -* vf:unload - transported resource leaves the process, the same resource will appear in input with *vf:load* verb +* vf:pickup - transported resource or person enters the process, the same resource will appear in output with *vf:dropoff* verb +* vf:dropoff - transported resource or person leaves the process, the same resource will appear in input with *vf:pickup* verb * vf:accept - in processes like repair or modification or testing, the same resource will appear in output with *vf:modify* verb * vf:modify - in processes like repair or modification, the same resource will appear in input with *vf:accept* verb * vf:pass - possible output of a testing or reviewing process, indicating the resource passed, the same resource will appear in input with *vf:accept* verb * vf:fail - possible output of a testing or reviewing process, indicating the resource failed, the same resource will appear in input with *vf:accept* verb * vf:service - new service produced and delivered (a service implies that an agent actively receives the service) -* vf:transfer - give rights and/or possession of a resource from one agent to another +* vf:transfer-all-rights - give full (in the human realm) rights and responsibilities to another agent, without transferring physical custody +* vf:transfer-custody - give physical custody and control of a resource, without full accounting or ownership rights +* vf:transfer-complete - give full rights and responsibilities plus physical custody * vf:move - change location and possibly identifier, if location is part of the identification, of a resource with no change of agent rights or possession * vf:raise - adjusts a quantity up based on a beginning balance or inventory count * vf:lower - adjusts a quantity down based on a beginning balance or inventory count @@ -71,14 +73,16 @@ consume | Decrement | Input | Yes | N/A | use | No effect(1) | Input | No | N/A | work | No effect(1) | Input | N/A | N/A | cite | No effect | Input | No | N/A | -load | No effect | Input | No | unload | -unload | No effect | Output | No | load | +pickup | No effect | Input | No | dropoff | +dropoff | No effect | Output | No | pickup | accept | No effect | Input | No | modify | modify | No effect | Output | No | accept | pass | No effect | Output | No | accept | fail | No effect | Output | No | accept | -transfer | Incr+Decr(2) | N/A | No | N/A | -move | Incr+Decr(2) | N/A | No | N/A | +transfer-custody | Decr+Incr(2) | N/A | No | N/A | +transfer-all-rights | Decr+Incr(2) | N/A | No | N/A | +transfer-complete | Decr+Incr(2) | N/A | No | N/A | +move | Decr+Incr(2) | N/A | No | N/A | raise | Increment | N/A | No | N/A | lower | Decrement | N/A | No | N/A | diff --git a/docs/introduction/resources.md b/docs/introduction/resources.md @@ -88,17 +88,16 @@ An event can trigger incrementing or decrementing a resource. Sometimes it does For serialized or uniquely identified resources, if the logical and technical unique identifiers are not changed by an event, such as moving a vehicle to another location without any changes to its custody (and assuming location is not part of the logical identifier), the resource does not behave like a stock and is not decremented or incremented. +#### How resources relate to transfers -#### How resources related to each other +Two different kinds of "inventorying" of resources are affected by transfers. +* quantity of the resource where the agent has full (human realm) rights and responsibilities, irrespective of custody +* quantity of the resource where the agent has custody or physical possession, irrespective of rights, more of an operational focus -##### Underlying resource +We are defining two current quantities on the economic resource for these two concepts, accounting quantity for the first and onhand quantity for the second. -This occurs when a resource is basically certain defined rights to another resource. It is often useful to define the rights as a different resource for purposes of processes or exchanges. +#### How resources related to each other: contained resources -One example: a resource which defines the rental of an apartment has the apartment itself as its underlying resource. - -##### Contains resource - -Unlike underlying resource, if one resource contains other resources, the contained resources are part of, or make up the larger resource. +If one resource contains other resources, the contained resources are part of, or make up the larger resource. For example, a bank account might contain a number of "virtual accounts" that a group manages itself, outside the bank's knowledge. Or, a bike shed resource might contain 10 bikes, which are identified and tracked by their serial numbers as individual resources. diff --git a/docs/introduction/transfers.md b/docs/introduction/transfers.md @@ -1,13 +1,16 @@ # Transfer -A transfer is an activity that re-assigns some rights and responsibilities for an economic resource from one agent to another, but does not transform or transport the economic resource. +One kind of transfer is an activity that re-assigns rights and responsibilities for an economic resource from one agent to another, but does not transform or transport the economic resource. A second kind is an activity that operationally changes physical custody or possession of an economic resource from one agent to another, without affecting rights, and without rising to the level of a process required to make that transfer. -We think that now, and more so in the future, there will be more gradations of rights and responsibilities for resources than are sometimes considered now. For example, as a society we may decide that we should take more responsibility for recycling or upcycling resources at the end of their useful life for us, or not wasting them. The concept of "ownership" may transition more into "stewardship" in a concept of the world that does not put humans in a position of controlling the world's resources or abdicating responsibilities to the ecosystem in the name of ownership. +We think that now, and more so in the future, there will be more gradations of rights and responsibilities for resources than are sometimes considered now. For example, as a society we may decide that we should take more responsibility for recycling or upcycling resources at the end of their useful life for us, or not wasting them. The concept of "ownership" may transition more into "stewardship" in a concept of the world that does not put humans in a position of controlling the world's resources or abdicating responsibilities to the ecosystem in the name of ownership. So, we are for the most part avoiding talking about ownership in this vocabulary, as we work towards more of an ecosystemic perspective. -* For example, perhaps some agent has many apple trees, and plans on pressing apple cider. Another agent has an apple press and agrees to exchange use of the press (a resource) for a portion of the apple cider. The use of the press involves some rights (to use the press for some period of time) and responsibilities (to not run it beyond its capacity and to clean it up before returning it). The rights and responsibilities to a portion of apple cider is transferred in exchange for the use of the press. +#### Examples -* Or in a library, a book can be checked out for a period of time. The agent who checks it out can read it and is responsible for caring for it and returning it on time. +* For example, perhaps some agent has many apple trees, and plans on pressing apple cider. Another agent has an apple press and agrees to exchange use of the press (a resource) for a portion of the apple cider. The use of the press involves some rights (to use the press for some period of time) and responsibilities (to not run it beyond its capacity and to clean it up before returning it). The rights and responsibilities to a portion of apple cider is transferred in exchange for the transfer of use of the press. + +* Or in a library, a book can be checked out for a period of time. The agent who checks it out can read it and is responsible for caring for it and returning it on time, another transfer. * Or let's say that a community has farmland and equipment held in common. The community transfers responsibility for the land and equipment to some farmers to use and take care of. The community also transfers seeds every year to the farmers, enough to grow the food the community needs. During the year, the harvests are distributed (transferred) to the community members for their consumption. In reciprocity, the community provides for other needs of the farmers. In spite of these examples, we also want to note that transfers do not imply explicit or implicit exchanges, only a one-directional flow. + diff --git a/examples/checkout-book.yaml b/examples/checkout-book.yaml @@ -11,7 +11,10 @@ - '@id': library:2402b57c-1c45-423a-acb2-f50961c97d65 '@type': EconomicResource skos:note: Valueflows cookbook ISBN:1234 copy 2 - currentQuantity: + accountingQuantity: + qudt:unit: unit:Number + qudt:numericValue: 1 + onhandQuantity: qudt:unit: unit:Number qudt:numericValue: 1 @@ -24,7 +27,7 @@ - '@id': urn:uuid:54b814ee-62dc-40c1-bb96-f8582aa4f771 '@type': EconomicEvent realizationOf: library:f47064eb-7120-4b31-b882-770165901fe6 - action: transfer + action: transfer-custody resourceInventoriedAs: library:2402b57c-1c45-423a-acb2-f50961c97d65 time:inXSDDateTimeStamp: 2019-04-18T8:00:00-5:00 provider: https://library.example/ @@ -36,7 +39,7 @@ - '@id': urn:uuid:98c2bfeb-9c70-4801-896c-4646b975a7d9 '@type': Commitment clauseOf: library:f47064eb-7120-4b31-b882-770165901fe6 - action: transfer + action: transfer-custody resourceInventoriedAs: library:2402b57c-1c45-423a-acb2-f50961c97d65 provider: https://bob.example/ receiver: https://library.example/ @@ -50,7 +53,10 @@ - '@id': library:2402b57c-1c45-423a-acb2-f50961c97d65 '@type': EconomicResource skos:note: Valueflows cookbook ISBN:1234 copy 2 - currentQuantity: + accountingQuantity: + qudt:unit: unit:Number + qudt:numericValue: 1 + onhandQuantity: qudt:unit: unit:Number qudt:numericValue: 0 @@ -59,7 +65,7 @@ - '@id': urn:uuid:d4d2fd71-34f2-41c3-b1c5-19ad5ed2da59 '@type': EconomicEvent realizationOf: library:f47064eb-7120-4b31-b882-770165901fe6 - action: transfer + action: transfer-custody resourceInventoriedAs: library:2402b57c-1c45-423a-acb2-f50961c97d65 provider: https://bob.example/ receiver: https://library.example/ @@ -81,6 +87,9 @@ - '@id': library:2402b57c-1c45-423a-acb2-f50961c97d65 '@type': EconomicResource skos:note: Valueflows cookbook ISBN:1234 copy 2 - currentQuantity: + accountingQuantity: + qudt:unit: unit:Number + qudt:numericValue: 1 + onhandQuantity: qudt:unit: unit:Number qudt:numericValue: 1 diff --git a/examples/claim.yaml b/examples/claim.yaml @@ -26,7 +26,7 @@ - '@id': mfg:d4d2fd71-34f2-41c3-b1c5-19ad5ed2da58 '@type': Claim - action: transfer + action: transfer-complete provider: https://manufacturing.example/ receiver: https://bob.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q1104069 # Canadian dollar @@ -41,9 +41,9 @@ - '@id': mfg:c7897c39-7f05-4a5d-a487-80e130a2414a '@type': EconomicEvent - action: transfer - provider: https://bob.example/ - receiver: https://manufacturing.example/ + action: transfer-complete + provider: https://manufacturing.example/ + receiver: https://bob.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q1104069 # Canadian dollar resourceQuantity: qudt:unit: unit:Number diff --git a/examples/exch-agreement.yaml b/examples/exch-agreement.yaml @@ -4,8 +4,6 @@ - https://git.io/vf-examples-jsonld-context - alice: https://alice.example/ bob: https://bob.example/ - carol: https://carol.example/ - store: https://store.example/ '@id': rgh:valueflows/valueflows/master/examples/exch-agreement.yaml '@graph': @@ -19,7 +17,7 @@ - '@id': alice:2342d456-5d6f-46d5-a7ed-3ac7bfd5a86c '@type': Commitment clauseOf: alice:57f1c1d0-432e-4bfa-9d32-002b8955a708 - action: transfer + action: transfer-complete provider: https://alice.example/ receiver: https://bob.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q89 # apples @@ -30,7 +28,7 @@ - '@id': bob:fd399b37-0740-4a68-a184-1e655021ca21 '@type': Commitment clauseOf: alice:57f1c1d0-432e-4bfa-9d32-002b8955a708 - action: transfer + action: transfer-complete provider: https://bob.example/ receiver: https://alice.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q5977438 # soft apple cider diff --git a/examples/exch-retail.yaml b/examples/exch-retail.yaml @@ -2,9 +2,7 @@ '@context': - https://git.io/vf-examples-jsonld-context - - alice: https://alice.example/ - bob: https://bob.example/ - carol: https://carol.example/ + - carol: https://carol.example/ store: https://store.example/ '@id': rgh:valueflows/valueflows/master/examples/exch-retail.yaml @@ -17,7 +15,7 @@ - '@id': store:a8356625-bf64-4c16-9099-28aa1b718c4b '@type': EconomicEvent realizationOf: store:ac9ec98d-db80-44dc-97be-7aa149b2fe5d - action: transfer + action: transfer-complete provider: https://store.example/ receiver: https://carol.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q47107 # bucket @@ -28,7 +26,7 @@ - '@id': store:2342d456-5d6f-46d5-a7ed-3ac7bfd5a86c '@type': EconomicEvent realizationOf: store:ac9ec98d-db80-44dc-97be-7aa149b2fe5d - action: transfer + action: transfer-complete provider: https://carol.example/ receiver: https://store.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q4917 # US dollar diff --git a/examples/move-crypto.yaml b/examples/move-crypto.yaml @@ -14,7 +14,7 @@ '@type': EconomicResource skos:note: Bob's first wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 540 @@ -22,7 +22,7 @@ '@type': EconomicResource skos:note: Bob's second wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 480 @@ -47,7 +47,7 @@ '@type': EconomicResource skos:note: Bob's first wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 440 @@ -55,6 +55,6 @@ '@type': EconomicResource skos:note: Bob's second wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 580 diff --git a/examples/multi-lateral-proposal.yaml b/examples/multi-lateral-proposal.yaml @@ -1,115 +0,0 @@ -# Example: Multi-lateral proposal and intents -# Not ready to use yet !! - -'@context': - - https://git.io/vf-examples-jsonld-context - - alice: https://alice.example/ - -'@id': rgh:valueflows/valueflows/master/examples/multi-lateral-proposal.yaml -'@graph': - - - '@id': alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 - '@type': Proposal - name: 2019 offers and wants to trade - hasBeginning: 2019-01-01T00:00:00-5:00 - hasEnd: 2019-12-31T00:00:00-5:00 - eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI - - - '@id': alice:27be5cab-d740-4194-9298-1661a69d9d95 - '@type': Intent - name: Housing - skos:note: One bedroom apartment to rent - action: transfer - receiver: https://alice.example/ - resourceClassifiedAs: wd:Q1247867 # housing - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:27be5cab-d740-4194-9298-1661a69d9d95 # the intent - reciprocal: false - intentLogic: or - - - '@id': alice:40df0092-5455-4507-83fc-7f3d64538163 - '@type': Intent - name: Community garden - skos:note: Access to space in a community garden - action: transfer - receiver: https://alice.example/ - resourceClassifiedAs: wd:Q251958 # community garden - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:40df0092-5455-4507-83fc-7f3d645381635 # the intent - reciprocal: false - intentLogic: or - - - '@id': alice:f12fc3b7-1033-4da0-85fd-a378b4cfb36f - '@type': Intent - name: CSA vegetable box - skos:note: CSA vegetable box weekly in season - action: transfer - receiver: https://alice.example/ - resourceClassifiedAs: wd:Q427249 # community supported agriculture - totalQuantity: - qudt:unit: unit:Number - qudt:numericValue: 20 - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:f12fc3b7-1033-4da0-85fd-a378b4cfb36f # the intent - reciprocal: false - intentLogic: or - - - '@id': alice:40bb78fe-28df-41a6-b698-525fa9d411d6 - '@type': Intent - name: Child clothing - skos:note: Clothing for child, age 10 - action: transfer - receiver: https://alice.example/ - resourceClassifiedAs: wd:Q11460 # clothing - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:40bb78fe-28df-41a6-b698-525fa9d411d6 # the intent - reciprocal: false - intentLogic: or - - - '@id': alice:7a63ea10-b1c3-441a-9a08-fb8630c02614 - '@type': Intent - name: Elder care - skos:note: Elder care in your home - action: work - provider: https://alice.example/ - resourceClassifiedAs: wd:Q15297473 # care giving - totalQuantity: - qudt:unit: unit:Hour - qudt:numericValue: 1000 - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:7a63ea10-b1c3-441a-9a08-fb8630c02614 # the intent - reciprocal: false - intentLogic: or - - - '@id': alice:2402b57c-1c45-423a-acb2-f50961c97d65 - '@type': Intent - name: Child clothing - skos:note: Clothing for children, ages 0 to 6 - action: transfer - provider: https://alice.example/ - resourceClassifiedAs: wd:Q11460 # clothing - totalQuantity: - qudt:unit: unit:Number - qudt:numericValue: 50 - - - '@id': alice:a8236bbb-81e0-422d-9861-56d2417db0fb - '@type': ProposedIntent - publishedIn: alice:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 # the proposal - publishes: alice:2402b57c-1c45-423a-acb2-f50961c97d65 # the intent - reciprocal: false - intentLogic: or diff --git a/examples/process-manufacturing.yaml b/examples/process-manufacturing.yaml @@ -4,7 +4,6 @@ - https://git.io/vf-examples-jsonld-context - alice: https://alice.example/ mfg: https://manufacturing.example/ - make: https://makezine.com/ '@id': rgh:valueflows/valueflows/master/examples/process-manufacturing.yaml '@graph': @@ -14,14 +13,14 @@ - '@id': mfg:e1721a61-cd47-4556-84b9-8b1b81da15bf '@type': EconomicResource resourceConformsTo: https://www.opendesk.cc/lean/desk # desk - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 8 - '@id': mfg:3129ca8b-fcda-45be-bbda-294dc924d3b9 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q219803 # plywood - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 130 skos:note: 4 x 8 sheet of 1/2 inch plywood @@ -29,14 +28,14 @@ - '@id': mfg:6b97b1be-8e07-44ac-82e5-214f1b2aaf33 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q2101564 # desk design specification - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 - '@id': mfg:52f0e212-3c4f-4d27-b345-5e964c135824 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q13231055 # CNC machine - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 @@ -106,14 +105,14 @@ - '@id': mfg:e1721a61-cd47-4556-84b9-8b1b81da15bf '@type': EconomicResource resourceConformsTo: https://www.opendesk.cc/lean/desk # desk - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 9 - '@id': mfg:3129ca8b-fcda-45be-bbda-294dc924d3b9 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q219803 # plywood - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 127 note: 4 x 8 sheet of 1/2 inch plywood @@ -121,13 +120,13 @@ - '@id': mfg:6b97b1be-8e07-44ac-82e5-214f1b2aaf33 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q2101564 # desk design specification - currentQuantity: + accountingQuantity: qudt:unit: unit:Unitless qudt:numericValue: 1 - '@id': mfg:52f0e212-3c4f-4d27-b345-5e964c135824 '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q13231055 # CNC machine - currentQuantity: + accountingQuantity: qudt:unit: unit:Unitless qudt:numericValue: 1 diff --git a/examples/process-service.yaml b/examples/process-service.yaml @@ -30,14 +30,14 @@ - '@id': training:e1721a61-cd47-4556-84b9-8b1b81da15bf '@type': EconomicResource classifiedAs: https://www.wikidata.org/wiki/Q53953506 # 3D printer - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 - '@id': training:6b97b1be-8e07-44ac-82e5-214f1b2aaf33 '@type': EconomicResource conformsTo: training:52f0e212-3c4f-4d27-b345-5e964c135824 # 3D printing class handout - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 100 diff --git a/examples/process-workflow.yaml b/examples/process-workflow.yaml @@ -14,7 +14,7 @@ '@type': EconomicResource resourceConformsTo: http://opensourceecology.org/wiki/Wikispeed_SGT01 # car trackingIdentifier: JHMCD38698S061469 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 @@ -53,6 +53,6 @@ '@type': EconomicResource resourceConformsTo: http://opensourceecology.org/wiki/Wikispeed_SGT01 # car trackingIdentifier: JHMCD38698S061469 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 diff --git a/examples/proposal-barter.yaml b/examples/proposal-barter.yaml @@ -35,7 +35,7 @@ '@type': Intent name: Cider skos:note: Fresh cider from the pressing - action: transfer + action: transfer-complete provider: https://carol.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q5977438 # apple cider resourceQuantity: diff --git a/examples/proposal-list.yaml b/examples/proposal-list.yaml @@ -20,7 +20,7 @@ - '@id': farm:c7897c39-7f05-4a5d-a487-80e130a24345 '@type': Intent name: Carrots case 25# - action: transfer + action: transfer-complete provider: https://farm.example/ resourceClassifiedAs: wd:Q81 # carrot resourceSpecifiedAs: farm:2402b57c-1c45-423a-acb2-f50961c97d65 # 25 pound case organic carrots seconds @@ -37,7 +37,7 @@ - '@id': farm:0f563083-7f05-4a5d-a487-80e130a24345 '@type': Intent name: Payment - action: transfer + action: transfer-complete receiver: https://farm.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q4917 # US Dollar resourceQuantity: @@ -60,7 +60,7 @@ - '@id': farm:54b814ee-62dc-40c1-bb96-f8582aa4f771 '@type': Intent name: Beets case 25# - action: transfer + action: transfer-complete provider: https://farm.example/ resourceClassifiedAs: wd:Q165437 # beet root resourceSpecifiedAs: farm:8baa8ff7-9c1e-4586-ae7b-79d620a3cac9 # 25 pound case organic beets @@ -77,7 +77,7 @@ - '@id': farm:21f361a6-2375-46bb-b192-c21b5ba833bf '@type': Intent name: Payment - action: transfer + action: transfer-complete receiver: https://farm.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q4917 # US Dollar resourceQuantity: diff --git a/examples/proposal-plan.yaml b/examples/proposal-plan.yaml @@ -47,7 +47,7 @@ '@type': Intent name: Payment skos:note: Payment when the unit is manufactured and sold - action: transfer + action: transfer-complete provider: https://fablab.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q4917 # US Dollar agreedIn: https://fablab.example/soil-sensor-project/value-equation/ diff --git a/examples/resource.yaml b/examples/resource.yaml @@ -23,7 +23,7 @@ name: Tractor - LifeTrac 6 trackingIdentifier: 889jcd00s # the serial number assigned by the manufacturer conformsTo: ose:822b6baf-d66f-45a0-98f2-57450e2aec23 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 @@ -40,7 +40,7 @@ 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 - currentQuantity: + accountingQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 650 skos:note: Medium size, clean, harvested after the first frost, will store well. @@ -62,3 +62,6 @@ name: Intern orientation instructions conformsTo: farm:68cabaf3-deb8-4bd5-a439-798263abe35a uri: https://farm.example/docs/intern-orientation.odt + accountingQuantity: + qudt:unit: unit:Number + qudt:numericValue: 1 diff --git a/examples/simple-proposals.yaml b/examples/simple-proposals.yaml @@ -21,7 +21,7 @@ '@type': Intent name: Old adult Schwinn one speed bike skos:note: Pedals fine, not good for hills, has basket, brakes are a bit dodgy - action: transfer + action: transfer-complete provider: https://alice.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q11442 # bicycle @@ -34,7 +34,7 @@ - '@id': alice:e72f7d1d-4f0a-4518-a44c-96658cafda95 '@type': Intent name: Payment - action: transfer + action: transfer-complete receiver: https://alice.example/ resourceClassifiedAs: https://www.wikidata.org/wiki/Q4917 # US Dollar resourceQuantity: diff --git a/examples/transfer-crypto.yaml b/examples/transfer-crypto.yaml @@ -15,7 +15,7 @@ '@type': EconomicResource skos:note: Alice's wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 540 @@ -23,7 +23,7 @@ '@type': EconomicResource skos:note: Bob's wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 480 @@ -31,7 +31,7 @@ - '@id': urn:uuid:e5afaa28-1080-4912-835b-46883efb83e6 '@type': EconomicEvent - action: transfer + action: transfer-complete resourceClassifiedAs: wd:Q21002847 # FairCoin resourceInventoriedAs: fair:b75d8f6a-e2df-4e52-b36d-1a22a66f4ead # Alice's wallet address toResourceInventoriedAs: fair:3be5259d-10f0-431c-9fec-9c0c15a461d3 # Bob's wallet address @@ -48,7 +48,7 @@ '@type': EconomicResource skos:note: Alice's wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 440 @@ -56,6 +56,6 @@ '@type': EconomicResource skos:note: Bob's wallet address classifiedAs: wd:Q21002847 # FairCoin - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 580 diff --git a/examples/transport-with-transfer.yaml b/examples/transport-with-transfer.yaml @@ -16,7 +16,10 @@ classifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 locatedAt: geo:70ee3034-0d15-4471-8ee3-91c60bb1a9c9 - currentQuantity: + accountingQuantity: + qudt:unit: unit:Kilogram + qudt:numericValue: 230 + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 230 @@ -24,7 +27,7 @@ - '@id': urn:uuid:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 '@type': Commitment - action: transfer + action: transfer-complete resourceClassifiedAs: wd:Q41777871 # haralson apples provider: https://alice.example/ receiver: https://bob.example/ @@ -40,7 +43,7 @@ - '@id': urn:uuid:33e8933b-ff73-4a01-964a-ca7a98893083 '@type': Commitment - action: transfer + action: transfer-complete resourceClassifedAs: wd:Q4917 # US Dollar provider: https://alice.example/ receiver: https://claudia.example/ @@ -61,11 +64,11 @@ qudt:numericValue: 1 clauseOf: urn:uuid:f325a950-5737-488d-b122-8f21114d0eb0 # transportation agreement - # alice transfers possession of the apples to claudia for transportation + # alice transfers custody of the apples to claudia for transportation - '@id': urn:uuid:6b5bc786-b9ed-4189-b34f-5ef7d10f1f86 '@type': EconomicEvent - action: transfer + action: transfer-custody resourceClassifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 provider: https://alice.example/ @@ -82,7 +85,10 @@ classifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 locatedAt: geo:70ee3034-0d15-4471-8ee3-91c60bb1a9c9 - currentQuantity: + accountingQuantity: + qudt:unit: unit:Kilogram + qudt:numericValue: 230 + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 200 @@ -90,7 +96,7 @@ '@type': EconomicResource classifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 - currentQuantity: + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 30 @@ -103,7 +109,7 @@ - '@id': claudia:fd399b37-0740-4a68-a184-1e655021ca21 '@type': EconomicEvent inputOf: claudia:633f6e56-6c7d-4a5b-b9c9-1a8adafd8960 - action: load + action: pickup resourceInventoriedAs: claudia:27be5cab-d740-4194-9298-1661a69d9d95 provider: https://claudia.example/ receiver: https://claudia.example/ @@ -114,7 +120,7 @@ - '@id': claudia:57f1c1d0-432e-4bfa-9d32-002b8955a708 '@type': EconomicEvent outputOf: claudia:633f6e56-6c7d-4a5b-b9c9-1a8adafd8960 - action: unload + action: dropoff resourceInventoriedAs: claudia:27be5cab-d740-4194-9298-1661a69d9d95 provider: https://claudia.example/ receiver: https://claudia.example/ @@ -129,7 +135,7 @@ - '@id': claudia:856c43b1-0a63-445f-a56f-707b257f086e '@type': EconomicEvent inputOf: claudia:c404cff5-19c7-453d-b0d8-d8e96055bd0c - action: load + action: pickup resourceInventoriedAs: claudia:27be5cab-d740-4194-9298-1661a69d9d95 provider: https://claudia.example/ receiver: https://claudia.example/ @@ -140,7 +146,7 @@ - '@id': claudia:9cb4944b-d26d-4774-a530-d18f2747c0d8 '@type': EconomicEvent outputOf: claudia:c404cff5-19c7-453d-b0d8-d8e96055bd0c - action: unload + action: dropoff resourceInventoriedAs: claudia:27be5cab-d740-4194-9298-1661a69d9d95 provider: https://claudia.example/ receiver: https://claudia.example/ @@ -172,7 +178,7 @@ - '@id': urn:uuid:7a63ea10-b1c3-441a-9a08-fb8630c02614 '@type': EconomicEvent - action: transfer + action: transfer-custody resourceClassifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 resourceInventoriedAs: claudia:27be5cab-d740-4194-9298-1661a69d9d95 @@ -187,7 +193,7 @@ - '@id': urn:uuid:ad56a7ed-be3c-4937-a3fb-0f156bcd2c47 '@type': EconomicEvent - action: transfer + action: transfer-all-rights resourceClassifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 provider: https://alice.example/ @@ -212,7 +218,10 @@ classifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 locatedAt: geo:70ee3034-0d15-4471-8ee3-91c60bb1a9c9 # only the possessed amount - currentQuantity: + accountingQuantity: + qudt:unit: unit:Kilogram + qudt:numericValue: 200 + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 200 @@ -221,14 +230,17 @@ classifiedAs: wd:Q41777871 # haralson apples trackingIdentifier: lot-alice-apples-2018-10-11 locatedAt: geo:b52a5815-fae9-43bf-be95-833b95dc0ada # only the possessed amount - currentQuantity: + accountingQuantity: + qudt:unit: unit:Kilogram + qudt:numericValue: 30 + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 30 - '@id': claudia:27be5cab-d740-4194-9298-1661a69d9d95 # claudia's bill of lading on the truck '@type': EconomicResource classifiedAs: wd:Q41777871 # haralson apples - currentQuantity: + onhandQuantity: qudt:unit: unit:Kilogram qudt:numericValue: 0 @@ -236,7 +248,7 @@ - '@id': urn:uuid:8baa8ff7-9c1e-4586-ae7b-79d620a3cac9 '@type': EconomicEvent - action: transfer + action: transfer-complete resourceClassifedAs: wd:Q4917 # US Dollar resourceInventoriedAs: alice:daa2ec3b-2c1a-4eb1-839f-8dcec1a1f93a # alice's bank account toResourceInventoriedAs: claudia:bd5806d6-4a36-45b9-b3b6-3e7d361a5a14 # claudia's bank account diff --git a/examples/workflow-stage-state.yaml b/examples/workflow-stage-state.yaml @@ -42,7 +42,7 @@ '@type': EconomicResource name: Bucket white 5 gallon resourceConformsTo: urn:uuid:3be5259d-10f0-431c-9fec-9c0c15a461d3 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 320 @@ -50,7 +50,7 @@ '@type': EconomicResource name: Thermoplastic polymer white resourceConformsTo: urn:uuid:d4d2fd71-34f2-41c3-b1c5-19ad5ed2da58 - currentQuantity: + accountingQuantity: qudt:unit: unit:Kilograms qudt:numericValue: 2455 @@ -59,7 +59,7 @@ name: Injection molding maching resourceConformsTo: urn:uuid:c7897c39-7f05-4a5d-a487-80e130a2414a trackingIdentifier: DDE098989099911 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 unitOfEffort: unit:Hour @@ -313,7 +313,7 @@ '@type': EconomicResource name: Bucket white 5 gallon resourceConformsTo: urn:uuid:3be5259d-10f0-431c-9fec-9c0c15a461d3 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1318 @@ -321,7 +321,7 @@ '@type': EconomicResource name: Thermoplastic polymer white resourceConformsTo: urn:uuid:d4d2fd71-34f2-41c3-b1c5-19ad5ed2da58 - currentQuantity: + accountingQuantity: qudt:unit: unit:Kilograms qudt:numericValue: 1531.8 @@ -330,7 +330,7 @@ name: Injection molding maching resourceConformsTo: urn:uuid:c7897c39-7f05-4a5d-a487-80e130a2414a trackingIdentifier: DDE098989099911 - currentQuantity: + accountingQuantity: qudt:unit: unit:Number qudt:numericValue: 1 unitOfEffort: unit:Hour diff --git a/release-doc-in-process/all_vf.TTL b/release-doc-in-process/all_vf.TTL @@ -216,13 +216,6 @@ vf:independentDemandOf rdfs:domain vf:Commitment ; rdfs:comment "Represents a desired deliverable to the outside of this plan." . -vf:scheduled - a owl:ObjectProperty ; - rdfs:label "scheduled" ; - rdfs:range xsd:boolean ; - rdfs:domain vf:Plan ; - rdfs:comment "The plan is scheduled, or is a higher level estimated plan." . - vf:resourceInventoriedAs a owl:ObjectProperty ; rdfs:label "resource inventoried as" ; @@ -344,12 +337,19 @@ vf:hasEnd a owl:DatatypeProperty ; owl:propertyChainAxiom (time:hasEnd time:inXSDDateTimeStamp) ; rdfs:comment "Specific time marking the exact end of flow or process". -vf:currentQuantity a owl:ObjectProperty ; - rdfs:label "current quantity" ; +vf:accountingQuantity a owl:ObjectProperty ; + rdfs:label "accounting quantity" ; rdfs:domain vf:EconomicResource ; rdfs:range qudt:QuantityValue ; vs:term_status "unstable" ; - rdfs:comment "The current amount and unit of the economic resource. This can be stored or derived from economic events affecting the resource" . + rdfs:comment "The current amount and unit of the economic resource for which the agent has primary rights and responsibilities, sometimes thought of as ownership. This can be stored or derived from economic events affecting the resource." . + +vf:onhandQuantity a owl:ObjectProperty ; + rdfs:label "onhand quantity" ; + rdfs:domain vf:EconomicResource ; + rdfs:range qudt:QuantityValue ; + vs:term_status "unstable" ; + rdfs:comment "The current amount and unit of the economic resource which is under direct control of the agent. It may be more or less than the accounting quantity. This can be stored or derived from economic events affecting the resource." . vf:resourceQuantity a owl:ObjectProperty ; rdfs:label "involved quantity" ; @@ -773,8 +773,16 @@ vf:lower a vf:Action ; rdfs:label "lower" ; rdfs:subPropertyOf vf:decrement . -vf:transfer a vf:Action ; - rdfs:label "transfer" ; +vf:transfer-complete a vf:Action ; + rdfs:label "transfer-complete" ; + vs:term_status "unstable" . + +vf:transfer-all-rights a vf:Action ; + rdfs:label "transfer-all-rights" ; + vs:term_status "unstable" . + +vf:transfer-custody a vf:Action ; + rdfs:label "transfer-custody" ; vs:term_status "unstable" . vf:move a vf:Action ;