From cd769a31a73f698dc5bdbc5bc5a856cd75ac3df9 Mon Sep 17 00:00:00 2001 From: Galan Heidenreich Date: Thu, 28 May 2026 11:38:04 +0000 Subject: [PATCH 1/2] updated the readme which was the original tractus-x readme before --- README.md | 103 ++++++++++++++++++++++++++---------------------------- 1 file changed, 50 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index c0acbfb12c..7df45b4133 100644 --- a/README.md +++ b/README.md @@ -1,93 +1,90 @@ -# Tractus-X EDC (Eclipse Dataspace Connector) +# Construct-X EDC -[![Contributors][contributors-shield]][contributors-url] -[![Stargazers][stars-shield]][stars-url] [![Apache 2.0 License][license-shield]][license-url] -[![Latest Release][release-shield]][release-url] -[![Latest Snapshot][snapshot-shield]]() +Construct-X specific Eclipse Dataspace Connector distributions and extensions, based on the Eclipse Tractus-X EDC. -[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=eclipse-tractusx_tractusx-edc&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=eclipse-tractusx_tractusx-edc) +## Overview -Container images and deployments of the Eclipse Dataspace Components for the Tractus-X project. +The Construct-X EDC extends the Eclipse Tractus-X EDC with +Construct-X specific policies, extensions and configurations. -Please also refer to: +This repository provides: +- Construct-X specific EDC extensions +- Control-Plane and Data-Plane distributions +- Helm charts and container images +- Local development and testing environments -- [Our docs](https://github.com/eclipse-tractusx/tractusx-edc/tree/main/docs) -- [Our Releases](https://github.com/eclipse-tractusx/tractusx-edc/releases) -- [Eclipse Dataspace Components](https://github.com/eclipse-edc/Connector) -- [Report Bug / Request Feature](https://github.com/eclipse-tractusx/tractusx-edc/issues) - -## About The Project +## Inventory -The project provides pre-built control- and data-plane [docker](https://www.docker.com/) images -and [helm](https://helm.sh/) charts of -the [Eclipse DataSpaceConnector Project](https://github.com/eclipse-edc/Connector). +The Construct-X EDC is split into a Control Plane and a Data Plane. -## Inventory +The Control Plane is responsible for resource management, +contract negotiation and transfer orchestration. -The eclipse data space connector is split up into Control-Plane and Data-Plane, whereas the Control-Plane functions as -administration layer and has responsibility of resource management, contract negotiation and administer data transfer. -The Data-Plane does the heavy lifting of transferring and receiving data streams. +The Data Plane handles the actual transfer of data streams. -Control-Plane distribution: +### Control Plane distributions - [edc-controlplane-postgresql-hashicorp-vault](edc-controlplane/edc-controlplane-postgresql-hashicorp-vault) with - dependency onto + dependencies on - [Hashicorp Vault](https://www.vaultproject.io/) - [PostgreSQL 8.2 or newer](https://www.postgresql.org/) +- [edc-runtime-memory](edc-controlplane/edc-runtime-memory) -Data-Plane distribution: +### Data Plane distributions -- [edc-dataplane-hashicorp-vault](edc-dataplane/edc-dataplane-hashicorp-vault) with dependency onto +- [edc-dataplane-hashicorp-vault](edc-dataplane/edc-dataplane-hashicorp-vault) with dependencies on - [Hashicorp Vault](https://www.vaultproject.io/) -For testing/development purposes: +## Important Resources -- [edc-runtime-memory](edc-controlplane/edc-runtime-memory) +### Local Testbed + +The local testbed provides a lightweight environment for local Construct-X EDC development and integration testing. + +- [Construct-X Local Testbed](https://github.com/project-construct-x/constructx-edc/blob/develop/edc-controlplane/edc-controlplane-construct-x/local/README.md) + +### Upstream References + +- [Eclipse Tractus-X EDC](https://github.com/eclipse-tractusx/tractusx-edc) +- [Eclipse Dataspace Components](https://github.com/eclipse-edc/Connector) + +## Construct-X Extensions + +Construct-X adds custom integrations and runtime extensions +on top of the Eclipse Tractus-X EDC. + +This includes: +- Construct-X specific policy extensions +- Custom credential handling +- Wallet integration support +- Local testbed environments ## Getting Started ### Build -Build Tractus-X EDC together with its Container Images +Build Construct-X EDC together with its Container Images ```shell ./gradlew dockerize ``` -## Known Incompatibilities - -- Hashicorp Vault 1.18.1 is not compatible with the EDC due to a bug in the vault concerning path handling - - [Internal Issue](https://github.com/eclipse-tractusx/tractusx-edc/issues/1772) - - [Hashicorp Vault Issue](https://github.com/hashicorp/vault/issues/29357) - +```shell +./gradlew build +``` ## Contributing -See [CONTRIBUTING](https://github.com/eclipse-tractusx/tractusx-edc/blob/main/CONTRIBUTING.md). +See [CONTRIBUTING](https://github.com/project-construct-x/constructx-edc/blob/develop/CONTRIBUTING.md). ## License Distributed under the Apache 2.0 License. -See [LICENSE](https://github.com/eclipse-tractusx/tractusx-edc/blob/main/LICENSE) for more information. +See [LICENSE](https://github.com/project-construct-x/constructx-edc/blob/develop/LICENSE) for more information. -[contributors-shield]: https://img.shields.io/github/contributors/eclipse-tractusx/tractusx-edc.svg?style=for-the-badge - -[contributors-url]: https://github.com/eclipse-tractusx/tractusx-edc/graphs/contributors - -[stars-shield]: https://img.shields.io/github/stars/eclipse-tractusx/tractusx-edc.svg?style=for-the-badge - -[stars-url]: https://github.com/eclipse-tractusx/tractusx-edc/stargazers - -[license-shield]: https://img.shields.io/github/license/eclipse-tractusx/tractusx-edc.svg?style=for-the-badge - -[license-url]: https://github.com/eclipse-tractusx/tractusx-edc/blob/main/LICENSE - -[release-shield]: https://img.shields.io/github/v/release/eclipse-tractusx/tractusx-edc.svg?style=for-the-badge - -[release-url]: https://github.com/eclipse-tractusx/tractusx-edc/releases - -[snapshot-shield]: https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Feclipse-tractusx%2Ftractusx-edc%2Frefs%2Fheads%2Fgh-pages%2Fmisc%2Flatest-versioned-snapshot.txt&search=.*&style=for-the-badge&label=Latest-Snapshot \ No newline at end of file +[license-shield]: https://img.shields.io/github/license/project-construct-x/constructx-edc.svg?style=for-the-badge +[license-url]: https://github.com/project-construct-x/constructx-edc/blob/develop/LICENSE \ No newline at end of file From 1f2250dac25777e83dc30a19a31e6298d6f0d451 Mon Sep 17 00:00:00 2001 From: Galan Heidenreich Date: Fri, 29 May 2026 10:27:12 +0000 Subject: [PATCH 2/2] Address review feedback --- README.md | 31 ++++++++----------------------- 1 file changed, 8 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 7df45b4133..1727932bca 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![Apache 2.0 License][license-shield]][license-url] -Construct-X specific Eclipse Dataspace Connector distributions and extensions, based on the Eclipse Tractus-X EDC. +[Construct-X](https://www.construct-x.org/) specific Eclipse Dataspace Connector distributions and extensions, based on the [Eclipse Tractus-X EDC](https://github.com/eclipse-tractusx/tractusx-edc). ## Overview @@ -12,7 +12,7 @@ Construct-X specific policies, extensions and configurations. This repository provides: - Construct-X specific EDC extensions - Control-Plane and Data-Plane distributions -- Helm charts and container images +- Helm charts and docker compose - Local development and testing environments ## Inventory @@ -26,7 +26,7 @@ The Data Plane handles the actual transfer of data streams. ### Control Plane distributions -- [edc-controlplane-postgresql-hashicorp-vault](edc-controlplane/edc-controlplane-postgresql-hashicorp-vault) with +- [edc-controlplane-postgresql-hashicorp-vault](edc-controlplane/edc-controlplane-construct-x/con-x-controlplane-postgresql-hashicorp-vault) with dependencies on - [Hashicorp Vault](https://www.vaultproject.io/) - [PostgreSQL 8.2 or newer](https://www.postgresql.org/) @@ -34,18 +34,10 @@ The Data Plane handles the actual transfer of data streams. ### Data Plane distributions -- [edc-dataplane-hashicorp-vault](edc-dataplane/edc-dataplane-hashicorp-vault) with dependencies on +- [edc-dataplane-hashicorp-vault](edc-dataplane/edc-dataplane-construct-x/con-x-dataplane-postgresql-hashicorp-vault) with dependencies on - [Hashicorp Vault](https://www.vaultproject.io/) -## Important Resources - -### Local Testbed - -The local testbed provides a lightweight environment for local Construct-X EDC development and integration testing. - -- [Construct-X Local Testbed](https://github.com/project-construct-x/constructx-edc/blob/develop/edc-controlplane/edc-controlplane-construct-x/local/README.md) - -### Upstream References +## Upstream References - [Eclipse Tractus-X EDC](https://github.com/eclipse-tractusx/tractusx-edc) - [Eclipse Dataspace Components](https://github.com/eclipse-edc/Connector) @@ -63,17 +55,10 @@ This includes: ## Getting Started -### Build - -Build Construct-X EDC together with its Container Images - -```shell -./gradlew dockerize -``` +The local testbed provides a lightweight environment for local Construct-X EDC development and integration testing. +It is the recommended starting point for developers getting started with the Construct-X EDC. -```shell -./gradlew build -``` +- [Construct-X Local Testbed](https://github.com/project-construct-x/constructx-edc/blob/develop/edc-controlplane/edc-controlplane-construct-x/local/README.md) ## Contributing See [CONTRIBUTING](https://github.com/project-construct-x/constructx-edc/blob/develop/CONTRIBUTING.md).