From cd03e120cd708e4c350575c126180c5f3e4c25a9 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Fri, 29 Mar 2024 10:37:43 +0100 Subject: [PATCH] Added changes to the vocabulary --- vocab/template.html | 109 ++++++++ vocab/vocabulary.drawio | 330 ++++++++++++++++++++++++ vocab/vocabulary.svg | 539 ++++++++++++++++++++++++++++++++++++++++ vocab/vocabulary.yml | 17 +- 4 files changed, 990 insertions(+), 5 deletions(-) create mode 100644 vocab/vocabulary.drawio create mode 100644 vocab/vocabulary.svg diff --git a/vocab/template.html b/vocab/template.html index 4032188..e47681c 100644 --- a/vocab/template.html +++ b/vocab/template.html @@ -157,6 +157,16 @@

Specification of terms

document (and the `rdfs:comment` property is used to include them in the RDFS representations).

+
+
+
Overview diagram of the vocabulary (without the`xsd` + datatypes). The terms prefixed by cred: or sec: are not defined in this vocabulary; + they have only been added to the diagram for the sake of clarity.
+ A separate, stand-alone SVG version of the diagram, as well as a textual description, + are also available. +
+

Namespaces

@@ -216,5 +226,104 @@

Deprecated individuals

+
+

Diagram description

+
+ Overview diagram of the vocabulary (without the `xsd` datatypes). The terms prefixed by cred: or + sec: are not defined in this vocabulary; they have only been added to the diagram for the sake of clarity. +

+ The diagram uses boxes, ellipses, and connecting lines with different "styles" + (border color, end marker, line type) to differentiate their semantic meaning: + "Property", "Class", and "Datatype" are identified by the shape of the + graph node (e.g., an ellipse signifies a "Class"); "Superclass", "Domain Of", or "Range" relationships + are identified by the style of the connecting line. + These style names are used in the explanation text that follows, below. +

+

+ The diagram is roughly divided into three sections — left, middle, and right. + To make this description easier to understand, these sections will be respectively referred to + as the "Classes", "Properties", and "Values" sections. + Shapes in the three sections are connected by lines of different styles. +

+
+

Classes Section

+ +

+ The section contains three ellipses, labeled as "cred:CredentialStatus", + "BitstringStatusListEntry", and "BitstringStatusList". It also contains + a box, styled as "Property" and labeled as "cred:credentialStatus". +

+ +

+ The "cred:CredentialStatus" ellipse, is connected to the ellipse, + labeled as "cred:CredentialStatus", with a line styled "Range". + The ellipse labeled as "BitstringStatusListEntry" is connected to the + ellipse, labeled as "cred:CredentialStatus", with a line styled as + "Superclass". +

+ +

+ The ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are + also connected to a number of boxes, all styled as "Property", with lines styled as + "Domain Of"; see the "Properties" section below for further details. +

+
+
+

Properties Section

+ +

+ The section contains a number of boxes, each styles as "Property". The labels of + these boxes are "statusListIndex", "statusListCredential", "statusPurpose", + "statusMessage", "ttl", "statusReference", "statusSize", and "encodedList". + There is also a small, unlabeled circle, which serves as an intersection point for connector + lines. +

+ +

+ The ellipse labeled as "BitstringStatusListEntry", described in the previous section, is + connected to the "statusListIndex", and "statusListCredential" boxes with lines styled as "Domain Of". + The ellipse labeled as "BitstringStatusList", also described in the previous section, + is connected to the "statusMessage", "ttl", "statusReference", "statusSize", + and "encodedList" boxes, also with lines styled as "Domain Of". +

+ +

+ Both the ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are connected to the + intersection point with a line styled as "Domain Of", and the intersection point is connected to the + box labeled as "statusPurpose with a line styled as "Domain Of". +

+
+
+

Values Section

+ +

+ The section contains and ellipse, labeled as "BitstringStatusListCredential", which is connected to + another ellipse, labeled as "cred:VerifiableCredential", with a line styled as "Superclass". + The box labeled as "statusListCredential", described in the previous section, is connected to the ellipse, + labeled as "BitstringStatusListCredential", with a line styled as "Range". +

+ +

+ Another ellipse, labeled as "BistringStatusMessage", is connected to two boxes with lines styled + as "Domain Of". The boxes are styled as "Property" and are labeled with "status" and "message". + The box labeled as "statusMessage", described in the previous section, is connected to the ellipse, + labeled as "BistringStatusMessage", with a line styled as "Range". +

+ +

+ The box labeled as "statusSize", described in the previous section, is connected to a box, styled + as "Datatype", and labeled as "xsd:positiveInteger", with a line styled as "Range". +

+ +

+ The box labeled as "encodedList", described in the previous section, is connected to a box, styled + as "Datatype", and labeled as "sec:multibase", with a line styled as "Range". +

+
+
+
+ + + diff --git a/vocab/vocabulary.drawio b/vocab/vocabulary.drawio new file mode 100644 index 0000000..abe026c --- /dev/null +++ b/vocab/vocabulary.drawio @@ -0,0 +1,330 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/vocab/vocabulary.svg b/vocab/vocabulary.svg new file mode 100644 index 0000000..ad9b5da --- /dev/null +++ b/vocab/vocabulary.svg @@ -0,0 +1,539 @@ + + + + + +
+
+
+ + + cred:VerifiableCredential + + +
+
+
+ + cred:VerifiableCredential + + + + + + + + + +
+
+
+ + Datatype + +
+
+
+ + Datatype + + + + + + +
+
+
+ Property +
+
+
+ + Property + + + + + + + + + +
+
+
+ Superclass +
+
+
+ + Superclass + + + + + + + + + +
+
+
+ Domain +
+ of +
+
+
+ + Domain... + + + + + + + + + +
+
+
+ Range +
+
+
+ + Range + + + + + + +
+
+
+ Class +
+
+
+ + Class + + + + + + + + + +
+
+
+ + + BitstringStatusList + + +
+
+
+ + BitstringStatusList + + + + + + +
+
+
+ + + statusPurpose + + +
+
+
+ + statusPurpose + + + + + + + + + + + + + + + + + + + +
+
+
+ + + cred:CredentialStatus + + +
+
+
+ + cred:CredentialStatus + + + + + + + + + + + + + +
+
+
+ + xsd:positiveInteger + +
+
+
+ + xsd:positiveInteger + + + + + +
+
+
+ + sec:multibase + +
+
+
+ + sec:multibase + + + + + + +
+
+
+ + + BitstringStatusListEntry + + +
+
+
+ + BitstringStatusListEntry + + + + + + +
+
+
+ + + BitstringStatusListCredential + + +
+
+
+ + BitstringStatusListCredential + + + + + + + + + + +
+
+
+ + + statusListIndex + + +
+
+
+ + statusListIndex + + + + + + +
+
+
+ + + statusListCredential + + +
+
+
+ + statusListCredential + + + + + + +
+
+
+ + + encodedList + + +
+
+
+ + encodedList + + + + + + +
+
+
+ + + ttl + + +
+
+
+ + ttl + + + + + + +
+
+
+ + + statusSize + + +
+
+
+ + statusSize + + + + + + +
+
+
+ + + statusMessage + + +
+
+
+ + statusMessage + + + + + + +
+
+
+ + + statusReference + + +
+
+
+ + statusReference + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + + BitstringStatusMessage + + +
+
+
+ + BitstringStatusMessage + + + + + + + + + + +
+
+
+ + + cred:credentialStatus + + +
+
+
+ + cred:credentialStatus + + + + + + + + + + +
+
+
+ + + status + + +
+
+
+ + status + + + + + + +
+
+
+ + + message + + +
+
+
+ + message + + + diff --git a/vocab/vocabulary.yml b/vocab/vocabulary.yml index 5b28734..a8f8a4f 100644 --- a/vocab/vocabulary.yml +++ b/vocab/vocabulary.yml @@ -12,7 +12,7 @@ prefix: ontology: - property: dc:title - value: Verifiable Credentials Bitstring Status List v1.0 + value: Bitstring Status List Vocabulary - property: dc:description value: RDFS [[RDF-SCHEMA]] vocabulary used by the [[[VC-BITSTRING-STATUS-LIST]]] [[VC-BITSTRING-STATUS-LIST]] @@ -25,11 +25,16 @@ class: defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#bitstringstatuslist - id: BitstringStatusListEntry + upper_value: cred:CredentialStatus defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#bitstringstatuslistentry - id: BitstringStatusListCredential + upper_value: cred:VerifiableCredential defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#bitstringstatuslistcredential + - id: BitstringStatusMessage + defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusMessage + property: - id: statusPurpose defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusPurpose @@ -46,7 +51,7 @@ property: - id: statusListCredential defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusListCredential domain: cs:BitstringStatusListEntry - range: xsd:string + range: cs:BitstringStatusListCredential - id: encodedList defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#encodedList @@ -63,25 +68,27 @@ property: label: Bitstring entry size in bits defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusSize domain: cs:BitstringStatusList - range: xsd:string + range: xsd:positiveInteger - id: statusMessage defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusMessage domain: cs:BitstringStatusList - range: xsd:string + range: cs:BitstringStatusMessage - id: status label: Hexadecimal value of a status message defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#status range: xsd:string + domain: cs:BitstringStatusMessage - id: message label: Human-readable message of a status value defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#message range: xsd:string + domain: cs:BitstringStatusMessage - id: statusReference label: Reference documentation for status messages defined_by: https://www.w3.org/TR/vc-bitstring-status-list/#statusReference domain: cs:BitstringStatusList - range: xsd:string + range: URL