# eclipse-tractusx/tractus-x-umbrella architecture

> Architecture diagram of the GitHub repository eclipse-tractusx/tractus-x-umbrella, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eclipse-tractusx/tractus-x-umbrella
- Repository: https://github.com/eclipse-tractusx/tractus-x-umbrella

## Overview

Eclipse Tractus-X Umbrella is a Helm-chart-based deployment for Catena-X dataspace environments, aimed at testing, sandbox use, and development. The user’s main workflow is to install the umbrella chart into a Kubernetes cluster and configure a complete network or a use-case subset. The chart tree identifies the principal deployment areas and bundles; their detailed chart wiring was not excerpted, so those links are shown as unverified. The README also highlights extensibility and component integration.

Main entry points: [`charts/umbrella`](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella) (Umbrella chart), [`charts/umbrella-infrastructure`](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella-infrastructure) (Infrastructure chart), [`charts/dataspace-connector-bundle`](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/dataspace-connector-bundle) (Connector bundle), [`charts/data-persistence-layer-bundle`](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/data-persistence-layer-bundle) (Persistence bundle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment"]
  node_umbrella["Umbrella chart"]
  node_infrastructure["Infrastructure chart"]
end

subgraph group_exchange["Data exchange"]
  node_dcp["Connector bundle"]
  node_dpl["Persistence bundle"]
  node_digitaltwin["Digital twin bundle"]
  node_basyx["BaSyx bundle"]
  node_provider["Test data provider"]
end

subgraph group_identity["Identity and trust"]
  node_identitybundle["Identity trust bundle"]
  node_decentralized["Identity connector"]
end

subgraph group_services["Platform services"]
  node_portal["Portal services"]
  node_observability["Observability"]
  node_simplebackend["Simple data backend"]
end

node_operator(("Cluster operator"))

node_operator -->|"installs"| node_umbrella
node_umbrella -.->|"configures"| node_infrastructure
node_umbrella -.->|"includes"| node_dcp
node_umbrella -.->|"includes"| node_dpl
node_umbrella -.->|"includes"| node_digitaltwin
node_umbrella -.->|"includes"| node_basyx
node_umbrella -.->|"configures"| node_provider
node_umbrella -.->|"includes"| node_identitybundle
node_umbrella -.->|"configures"| node_decentralized
node_umbrella -.->|"configures"| node_portal
node_umbrella -.->|"configures"| node_observability

click node_umbrella "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella"
click node_infrastructure "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella-infrastructure"
click node_dcp "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/dataspace-connector-bundle"
click node_dpl "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/data-persistence-layer-bundle"
click node_digitaltwin "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/digital-twin-bundle"
click node_basyx "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/digital-twin-basyx-bundle"
click node_provider "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/tx-data-provider"
click node_identitybundle "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/identity-and-trust-bundle"
click node_decentralized "https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/decentralized-identity-connector"
click node_portal "https://github.com/eclipse-tractusx/tractus-x-umbrella/blob/main/charts/umbrella/values-adopter-portal.yaml"
click node_observability "https://github.com/eclipse-tractusx/tractus-x-umbrella/blob/main/charts/umbrella/values-adopter-data-exchange-observability.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_umbrella,node_infrastructure toneBlue
class node_dcp,node_dpl,node_digitaltwin,node_basyx,node_provider toneAmber
class node_identitybundle,node_decentralized toneMint
class node_portal,node_observability,node_simplebackend toneRose
class node_operator toneIndigo
```

## Components

### Deployment

- [Umbrella chart](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella): `charts/umbrella`
- [Infrastructure chart](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/umbrella-infrastructure): `charts/umbrella-infrastructure`

### Data exchange

- [Connector bundle](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/dataspace-connector-bundle): `charts/dataspace-connector-bundle`
- [Persistence bundle](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/data-persistence-layer-bundle): `charts/data-persistence-layer-bundle`
- [Digital twin bundle](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/digital-twin-bundle): `charts/digital-twin-bundle`
- [BaSyx bundle](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/digital-twin-basyx-bundle): `charts/digital-twin-basyx-bundle`
- [Test data provider](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/tx-data-provider): `charts/tx-data-provider`

### Identity and trust

- [Identity trust bundle](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/identity-and-trust-bundle): `charts/identity-and-trust-bundle`
- [Identity connector](https://github.com/eclipse-tractusx/tractus-x-umbrella/tree/main/charts/decentralized-identity-connector): `charts/decentralized-identity-connector`

### Platform services

- [Portal services](https://github.com/eclipse-tractusx/tractus-x-umbrella/blob/main/charts/umbrella/values-adopter-portal.yaml): `charts/umbrella/values-adopter-portal.yaml`
- [Observability](https://github.com/eclipse-tractusx/tractus-x-umbrella/blob/main/charts/umbrella/values-adopter-data-exchange-observability.yaml): `charts/umbrella/values-adopter-data-exchange-observability.yaml`
- **Simple data backend**

### Other components

- **Cluster operator**

## Connections

- Cluster operator → Umbrella chart: installs (evidence: `README.md`)
- Umbrella chart → Infrastructure chart: configures
- Umbrella chart → Connector bundle: includes
- Umbrella chart → Persistence bundle: includes
- Umbrella chart → Digital twin bundle: includes
- Umbrella chart → BaSyx bundle: includes
- Umbrella chart → Test data provider: configures
- Umbrella chart → Identity trust bundle: includes
- Umbrella chart → Identity connector: configures
- Umbrella chart → Portal services: configures
- Umbrella chart → Observability: configures
