Skip to content

Commit

Permalink
doc: Add changes for the 0.6.0-beta5 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
absoludity committed Feb 27, 2025
1 parent 51ed8fb commit 9f4a0c3
Show file tree
Hide file tree
Showing 2 changed files with 53 additions and 1 deletion.
6 changes: 5 additions & 1 deletion docs/untp-data-model/changes-v0.6.0-beta1.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,11 @@ Updated to core 0.6.0-beta1, resaved and released 0.6.0-beta1 of DFR

Updated to core 0.6.0-alpha3 and added contextOmit=false to the main entity, released 0.6.0-alpha3. jsonld lint complains of `credentialSubject` being re-defined.

The cause was that without an `^id` for `RegisteredIdentity`, the `credentialSubject` term is redefined with an internal context (probably due to changes we requested for other contexts). The constraints we have here for the DIA are that we need to:
The cause was that without an `^id` for `RegisteredIdentity`, the
`credentialSubject` term is redefined with an internal context (probably due to
changes we requested for other contexts), as it is already defined as a
`"@type": "@id"` in the VCDM. The constraints we have here for the DIA are that
we need to:

- reference an identity without requiring all fields in the schema (I've used an objectReference to a Party, but need to confirm with Steve whether a DIA is intended also for Product or Facility?)
- allow extra data in addition to the referenced identity, which are the registerType and scope list fields
Expand Down
48 changes: 48 additions & 0 deletions docs/untp-data-model/changes-v0.6.0-beta5.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
These changes are the changes from v0.6.0-beta1 to v0.6.0-beta4.

There were certain properties which were removed from the intended references of 0.5.0 when switching to a Jargon object reference. The changes below restore those as listed.

Additionally, there's a semantic change to the DIA below after talking with Steve.


## UNTP Core

- `Attestation.issuedToParty` - add `description` to the object reference to match the intended reference in 0.5.0.
- Added `[jsonld.contextOmit]=true` to `Characteristics` and removed `Product.characteristics` otherwise when extensions add properties to `Characteristics` they re-define an existing term on `Product`.


## Digital Conformity Credential

When switching the following fields:
- `ConformityAssessment.assessedProduct` - add `serialNumber`, `batchNumber` and `IDVerifiedByCAB` to match intended reference in 0.5.0.
- `ConformityAssessment.assessedFacility` - add `locationInformation`, `address` and `IDverifiedByCAB` to the object reference to match intended reference in 0.5.0.
- `ConformityAssessment.assessedOrganisation` - add `description` to the object reference to match the intended reference in 0.5.0.
- `ConformityAssessment.auditor` - add `description` to the object reference to match the intended reference in 0.5.0.


## Digital Identity Anchor

During a call with Steve, he pointed out that the identity of the DIA is not
necessarily just a Party, nor is it just a Party, Facility or Product. It could
be a trademark, land, or a piece of intellectual property.

Even though it is unlikely to be the final solution here (Steve has work to do
related to this from recent conversation), for now, the simplest solution is to
replace the object reference with the original four fields of `Identity`. So it
is simply no longer inheriting `Identity` (as it doesn't exist anymore) but
directly using the equivalent fields, to provide a more general reference here.


## Digital Product Passport

No change other than updating to core-0.6.0-beta5.


## Digital Facility Record

No change other than updating to core-0.6.0-beta5.


## Digital traceability event

No change other than updating to core-0.6.0-beta5.

0 comments on commit 9f4a0c3

Please sign in to comment.