diff --git a/README.md b/README.md index 42517e58..70048d38 100644 --- a/README.md +++ b/README.md @@ -56,4 +56,4 @@ A connector will implement additional internal functionalities, like monitoring The same applies for the data, which is transferred between the systems. While this document does not define the transport protocol, the structure, syntax and semantics of the data, a specification for those aspects is required and subject to the agreements of the participants or the data space. -![Overview on protocol and context](./figures/ProtocolOverview.png) +![Overview on protocol and context](./resources/figures/ProtocolOverview.png) diff --git a/SUMMARY.md b/SUMMARY.md index f8ee869b..97099233 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -21,51 +21,10 @@ * [Specification](./transfer/transfer.process.protocol.md) * [Binding: HTTPS](./transfer/transfer.process.binding.https.md) -## List of files +## List of Files -* [README.md](./README.md) -* [SUMMARY.md](./SUMMARY.md) -* [Section 1 Terminology and Section 2 Concepts](./model/information.model.md) -* [Figure: Entities and Relationships in Data Space](./model/m.dataspace.relationships.png) -* [Figure (source): Entities and Relationships in Data Space](./model/m.dataspace.relationships.puml) -* [Figure: Entities and relationships to DCAT and ODRL](./model/m.participant.entities.png) -* [Figure (source): Entities and relationships to DCAT and ODRL](./model/m.participant.entities.drawio) -* [Section 3 Catalog protocol](./catalog/catalog.protocol.md) -* [Catalog HTTPS Binding](./catalog/catalog.binding.https.md) -* [Example: DCAT Distribution (json)](./catalog/message/example/dcat.distribution.example.json) -* [Example: DCAT Distribution option 1 (json)](./catalog/message/example/dcat.distribution.example.option1.json) -* [Example: DCAT Distribution option 2 (json)](./catalog/message/example/dcat.distribution.example.option2.json) -* [Catalog Error Message (json)](./catalog/message/catalog-error-message.json) -* [Catalog Message (json)](./catalog/message/catalog.json) -* [Catalog Request Message (json)](./catalog/message/catalog-request-message.json) -* [Section 4 Contract Negotiation](./negotiation/contract.negotiation.protocol.md) -* [Contract Negotiation HTTPS Binding](./negotiation/contract.negotiation.binding.https.md) -* [Figure: Contract Negotiation State Machine](./negotiation/contract.negotiation.state.machine.png) -* [Figure (Source): Contract Negotiation State Machine](./negotiation/contract.negotiation.state.machine.puml) -* [Contract Agreement Message (json)](./negotiation/message/contract-agreement-message.json) -* [Contract Agreement Verification Message (json)](./negotiation/message/contract-agreement-verification-message.json) -* [Contract Negotiation Error Message (json)](./negotiation/message/contract-negotiation.json) -* [Contract Negotiation Event Message (json)](./negotiation/message/contract-negotiation-event-message.json) -* [Contract Negotiation Message (json)](./negotiation/message/contract-negotiation.json) -* [Contract Negotiation Termination Message (json)](./negotiation/message/contract-negotiation-termination-message.json) -* [Contract Offer Message (json)](./negotiation/message/contract-offer-message.json) -* [Contract Request Message (json)](./negotiation/message/contract-request-message.json) -* [Example: Contract Agreement Message HTTP](./negotiation/message/example/contract.agreement.message.http.transfer.json) -* [Section 5 Transfer process](./transfer/transfer.process.protocol.md) -* [Transfer process HTTPS Binding](./transfer/transfer.process.binding.https.md) -* [Figure: Transfer Process State Machine](./transfer/transfer-process-state-machine.png) -* [Figure (source): Transfer Process State Machine](./transfer/transfer-process-state-machine.puml) -* [Transfer Completion Message (json)](./transfer/message/transfer-completion-message.json) -* [Transfer Error Message (json)](./transfer/message/transfer-error.json) -* [Transfer Process Message (json)](./transfer/message/transfer-process.json) -* [Transfer Request Message (json)](./transfer/message/transfer-request-message.json) -* [Transfer Start Message (json)](./transfer/message/transfer-start-message.json) -* [Transfer Suspension Message (json)](./transfer/message/transfer-suspension-message.json) -* [Transfer Termination Message (json)](./transfer/message/transfer-termination-message.json) -* [Common Schema (json)](./common/schema/definitions.schema.json) -* [Shape: Contract Agreement Message (ttl)](./negotiation/message/shape/contract-agreement-message-shape.ttl) -* [Shape: Contract Agreement Verification message (ttl)](./negotiation/message/shape/contract-agreement-verification-message-shape.ttl) -* [Shape: Contract Negotiation Event Message (ttl)](./negotiation/message/shape/contract-negotiation-event-message-shape.ttl) -* [Shape: Contract Negotiation Termination Message (ttl)](./negotiation/message/shape/contract-negotiation-termination-message-shape.ttl) -* [Shape: Contract Request Message (ttl)](./negotiation/message/shape/contract-request-message-shape.ttl) -* [diagram.styles.puml](./common/style/diagram.styles.puml) +* [Common](./resources/list_common.md) +* [Figures](./resources/list_figures.md) +* [Messages](./resources/list_messages.md) +* [Schemes](./resources/list_schemes.md) +* [Shapes](./resources/list_shapes.md) \ No newline at end of file diff --git a/figures/ProtocolOverview.png b/resources/figures/ProtocolOverview.png similarity index 100% rename from figures/ProtocolOverview.png rename to resources/figures/ProtocolOverview.png diff --git a/resources/list_common.md b/resources/list_common.md new file mode 100644 index 00000000..ec200336 --- /dev/null +++ b/resources/list_common.md @@ -0,0 +1,7 @@ +# Common + +* [Context (json)](./../common/schema/context.json) +* [Definitions Scheme (json)](./../common/schema/definitions.schema.json) +* [Message Shape (ttl)](./../common/shape/message-shape.ttl) +* [ODRL Shape (ttl)](./../common/shape/odrl-shapes.ttl) +* [Diagram Style (puml)](./../common/style/diagram.styles.puml) \ No newline at end of file diff --git a/resources/list_figures.md b/resources/list_figures.md new file mode 100644 index 00000000..af75ed57 --- /dev/null +++ b/resources/list_figures.md @@ -0,0 +1,49 @@ +# Figures + +* [Protocol Overview (png)](./figures/ProtocolOverview.png) +* [Dataspace Relations (png)](./../model/m.dataspace.relationships.png) +* [Dataspace Relations (source)](./../model/m.dataspace.relationships.puml) +* [Participant Entities (png)](./../model/m.participant.entities.png) +* [Participant Entities (source)](./../model/m.participant.entities.drawio) + +## Catalog +* [Catalog (png)](./../catalog/message/diagram/catalog.png) +* [Catalog (source)](./../catalog/message/diagram/catalog.puml) +* [Catalog error message (png)](./../catalog/message/diagram/catalog-error-message.png) +* [Catalog error message (source)](./../catalog/message/diagram/catalog-error-message.puml) +* [Catalog request message (png)](./../catalog/message/diagram/catalog-request-message.png) +* [Catalog request message (source)](./../catalog/message/diagram/catalog-request-message.puml) + +## Contract Negotiation +* [Contract agreement message (png)](./../negotiation/message/diagram/contract-agreement-message.png) +* [Contract agreement message (source)](./../negotiation/message/diagram/contract-agreement-message.puml) +* [Contract agreement verification message (png)](./../negotiation/message/diagram/contract-agreement-verification-message.png) +* [Contract agreement verification message (source)](./../negotiation/message/diagram/contract-agreement-verification-message.puml) +* [Contract negotiation (png)](./../negotiation/message/diagram/contract-negotiation.png) +* [Contract negotiation (source)](./../negotiation/message/diagram/contract-negotiation.puml) +* [Contract negotiation error (png)](./../negotiation/message/diagram/contract-negotiation-error.png) +* [Contract negotiation error (source)](./../negotiation/message/diagram/contract-negotiation-error.puml) +* [Contract negotiation event message (png)](./../negotiation/message/diagram/contract-negotiation-event-message.png) +* [Contract negotiation event message (source)](./../negotiation/message/diagram/contract-negotiation-event-message.puml) +* [Contract negotiation termination message (png)](./../negotiation/message/diagram/contract-negotiation-termination-message.png) +* [Contract negotiation termination message (source)](./../negotiation/message/diagram/contract-negotiation-termination-message.puml) +* [Contract offer message (png)](./../negotiation/message/diagram/contract-offer-message.png) +* [Contract offer message (source)](./../negotiation/message/diagram/contract-offer-message.puml) +* [Contract request message (png)](./../negotiation/message/diagram/contract-request-message.png) +* [Contract request message (source)](./../negotiation/message/diagram/contract-request-message.puml) + +## Transfer Process +* [Transfer completion message (png)](./../transfer/message/diagram/transfer-completion-message.png) +* [Transfer completion message (source)](./../transfer/message/diagram/transfer-completion-message.puml) +* [Transfer error (png)](./../transfer/message/diagram/transfer-error.png) +* [Transfer error (source)](./../transfer/message/diagram/transfer-error.puml) +* [Transfer prcess (png)](./../transfer/message/diagram/transfer-process.png) +* [Transfer prcess (source)](./../transfer/message/diagram/transfer-process.puml) +* [Transfer request message (png)](./../transfer/message/diagram/transfer-request-message.png) +* [Transfer request message (source)](./../transfer/message/diagram/transfer-request-message.puml) +* [Transfer start message (png)](./../transfer/message/diagram/transfer-start-message.png) +* [Transfer start message (source)](./../transfer/message/diagram/transfer-start-message.puml) +* [Transfer suspension message (png)](./../transfer/message/diagram/transfer-suspension-message.png) +* [Transfer suspension message (source)](./../transfer/message/diagram/transfer-suspension-message.puml) +* [Transfer termination message (png)](./../transfer/message/diagram/transfer-termination-message.png) +* [Transfer termination message (source)](./../transfer/message/diagram/transfer-termination-message.puml) \ No newline at end of file diff --git a/resources/list_messages.md b/resources/list_messages.md new file mode 100644 index 00000000..44a934a2 --- /dev/null +++ b/resources/list_messages.md @@ -0,0 +1,27 @@ +# Messages + +## Catalog +* [Catalog (json)](./../catalog/message/catalog.json) +* [Catalog error message (json)](./../catalog/message/catalog-error-message.json) +* [Catalog request message (json)](./../catalog/message/catalog-request-message.json) +* [Dataset (json)](./../catalog/message/dataset.json) +* [Dataset request message (json)](./../catalog/message/dataset-request-message.json) + +## Contract Negotiation +* [Contract agreement message (json)](./../negotiation/message/contract-agreement-message.json) +* [Contract agreement verification message (json)](./../negotiation/message/contract-agreement-verification-message.json) +* [Contract negotiation (json)](./../negotiation/message/contract-negotiation.json) +* [Contract negotiation error (json)](./../negotiation/message/contract-negotiation-error.json) +* [Contract negotiation event message (json)](./../negotiation/message/contract-negotiation-event-message.json) +* [Contract negotiation termination message (json)](./../negotiation/message/contract-negotiation-termination-message.json) +* [Contract offer message (json)](./../negotiation/message/contract-offer-message.json) +* [Contract request message (json)](./../negotiation/message/contract-request-message.json) + +## Transfer Process +* [Transfer completion message (json)](./../transfer/message/transfer-completion-message.json) +* [Transfer error (json)](./../transfer/message/transfer-error.json) +* [Transfer prcess (json)](./../transfer/message/transfer-process.json) +* [Transfer request message (json)](./../transfer/message/transfer-request-message.json) +* [Transfer start message (json)](./../transfer/message/transfer-start-message.json) +* [Transfer suspension message (json)](./../transfer/message/transfer-suspension-message.json) +* [Transfer termination message (json)](./../transfer/message/transfer-termination-message.json) \ No newline at end of file diff --git a/resources/list_schemes.md b/resources/list_schemes.md new file mode 100644 index 00000000..5f643675 --- /dev/null +++ b/resources/list_schemes.md @@ -0,0 +1,28 @@ +# Schemes + + +## Catalog +* [Catalog error schema (json)](./../catalog/message/schema/catalog-error-message-schema.json) +* [Catalog message schema (json)](./../catalog/message/schema/catalog-message-schema.json) +* [Catalog request message schema (json)](./../catalog/message/schema/catalog-request-message-schema.json) +* [Catalog schema (json)](./../catalog/message/schema/catalog-schema.json) +* [Dataset request message schema (json)](./../catalog/message/schema/dataset-request-message-schema.json) + +## Contract Negotiation +* [Contract agreement schema (json)](./../negotiation/message/schema/contract-agreement-message-schema.json) +* [Contract agreement verification schema (json)](./../negotiation/message/schema/contract-agreement-verification-message-schema.json) +* [Contract negotiation error schema (json)](./../negotiation/message/schema/contract-negotiation-error-schema.json) +* [Contract negotiation event schema (json)](./../negotiation/message/schema/contract-negotiation-event-message-schema.json) +* [Contract negotiation schema (json)](./../negotiation/message/schema/contract-negotiation-schema.json) +* [Contract negotiation termination schema (json)](./../negotiation/message/schema/contract-negotiation-termination-message-schema.json) +* [Contract offer message schema (json)](./../negotiation/message/schema/contract-offer-message-schema.json) +* [Contract request schema (json)](./../negotiation/message/schema/contract-request-message-schema.json) + +## Transfer Process +* [Transfer completion schema (json)](./../transfer/message/schema/transfer-completion-message-schema.json) +* [Transfer error schema (json)](./../transfer/message/schema/transfer-error-schema.json) +* [Transfer prcess schema (json)](./../transfer/message/schema/transfer-process-schema.json) +* [Transfer request schema (json)](./../transfer/message/schema/transfer-request-message-schema.json) +* [Transfer start schema (json)](./../transfer/message/schema/transfer-start-message-schema.json) +* [Transfer suspension schema (json)](./../transfer/message/schema/transfer-suspension-message-schema.json) +* [Transfer termination schema (json)](./../transfer/message/schema/transfer-termination-message-schema.json) \ No newline at end of file diff --git a/resources/list_shapes.md b/resources/list_shapes.md new file mode 100644 index 00000000..7b81d3f7 --- /dev/null +++ b/resources/list_shapes.md @@ -0,0 +1,28 @@ +# Shapes + +## Catalog +* [Catalog error shape (ttl)](./../catalog/message/shape/catalog-error-message-shape.ttl) +* [Catalog message shape (ttl)](./../catalog/message/shape/catalog-message-shape.ttl) +* [Catalog request message shape (ttl)](./../catalog/message/shape/catalog-request-message-shape.ttl) +* [Catalog shape (ttl)](./../catalog/message/shape/catalog-shape.ttl) +* [Dataset request message shape (ttl)](./../catalog/message/shape/dataset-request-message-shape.ttl) + +## Contract Negotiation +* [Contract agreement shape (ttl)](./../negotiation/message/shape/contract-agreement-message-shape.ttl) +* [Contract agreement verification shape (ttl)](./../negotiation/message/shape/contract-agreement-verification-message-shape.ttl) +* [Contract negotiation error shape (ttl)](./../negotiation/message/shape/contract-negotiation-error-shape.ttl) +* [Contract negotiation event shape (ttl)](./../negotiation/message/shape/contract-negotiation-event-message-shape.ttl) +* [Contract negotiation message shape (ttl)](./../negotiation/message/shape/contract-negotiation-message-shape.ttl) +* [Contract negotiation shape (ttl)](./../negotiation/message/shape/contract-negotiation-shape.ttl) +* [Contract negotiation termination shape (ttl)](./../negotiation/message/shape/contract-negotiation-termination-message-shape.ttl) +* [Contract offer message shape (ttl)](./../negotiation/message/shape/contract-offer-message-shape.ttl) +* [Contract request shape (ttl)](./../negotiation/message/shape/contract-request-message-shape.ttl) + +## Transfer Process +* [Transfer completion shape (ttl)](./../transfer/message/shape/transfer-completion-message-shape.ttl) +* [Transfer error shape (ttl)](./../transfer/message/shape/transfer-error-shape.ttl) +* [Transfer prcess shape (ttl)](./../transfer/message/shape/transfer-process-shape.ttl) +* [Transfer request shape (ttl)](./../transfer/message/shape/transfer-request-message-shape.ttl) +* [Transfer start shape (ttl)](./../transfer/message/shape/transfer-start-message-shape.ttl) +* [Transfer suspension shape (ttl)](./../transfer/message/shape/transfer-suspension-message-shape.ttl) +* [Transfer termination shape (ttl)](./../transfer/message/shape/transfer-termination-message-shape.ttl) \ No newline at end of file