# eclipse-tractusx/dataspace-mgm-services architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-tractusx/dataspace-mgm-services
- Repository: https://github.com/eclipse-tractusx/dataspace-mgm-services

## Overview

This repository is the backend of Dataspace Management, a modular FastAPI service for OSP-led company onboarding and later dataspace administration. Its principal workflow is wallet-backed company registration, application review, CSP registration, wallet and credential setup, with C12 process orchestration coordinating module operations. The tree and README describe substantial people/access, connector, offer, subscription and notification capabilities; README also notes that this checkout is a hackathon scaffold where modules are stand-ins. Relationships among unsampled modules are therefore shown only where documented, not inferred from their names.

Main entry points: [`modules/c12_m1/engine.py`](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c12_m1/engine.py) (Process orchestration), [`scaffold/app.py`](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/app.py) (Installation app), [`scaffold/registry.py`](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/registry.py) (Module registry), [`modules/c3_m2/router.py`](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c3_m2/router.py) (CSP connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Service runtime"]
  node_service["Installation app<br/>[app.py]"]
  node_registry["Module registry<br/>[registry.py]"]
  node_orchestration["Process orchestration<br/>[engine.py]"]
end

subgraph group_onboarding["Onboarding and company"]
  node_registration["Company registration<br/>[router.py]"]
  node_review["Application review<br/>[router.py]"]
  node_company_profile["Company profile<br/>[router.py]"]
  node_csp_connection["CSP connection<br/>[router.py]"]
end

subgraph group_administration["Access and dataspace"]
  node_people["People and app access<br/>[router.py]"]
  node_technical_users["Technical users<br/>[router.py]"]
  node_credentials["Credentials<br/>[router.py]"]
  node_wallet_interface["Wallet interface<br/>[router.py]"]
  node_connectors["Connectors<br/>[router.py]"]
  node_offers["Offers<br/>[router.py]"]
  node_subscriptions["Subscriptions<br/>[router.py]"]
  node_notifications["Notifications<br/>[router.py]"]
end

subgraph group_framework["Shared framework"]
  node_spec["Module specifications<br/>[spec.py]"]
  node_standins["Stand-in interfaces<br/>[standin.py]"]
  node_events["Event relay<br/>[events.py]"]
  node_http["HTTP transport<br/>[http.py]"]
  node_neighbours["Neighbour clients<br/>[neighbours.py]"]
  node_auth["Token verification<br/>[tokens.py]"]
end

subgraph group_wallet["Wallet integration"]
  node_ebw_connector["EBW-Connector<br/>[app.py]"]
  node_business_wallet["Business Wallet<br/>[app.py]"]
end

node_ui(("Dataspace UI"))
node_osp_staff(("OSP staff"))
node_iam{{"Portal IAM"}}
node_csp{{"CSP services"}}
node_wallets{{"Dataspace wallets"}}

node_ui -->|"calls APIs"| node_service
node_service -->|"loads modules"| node_registry
node_registry -.->|"registers module"| node_orchestration
node_orchestration -->|"orchestrates"| node_registration
node_orchestration -->|"orchestrates"| node_review
node_orchestration -->|"orchestrates"| node_company_profile
node_orchestration -->|"orchestrates"| node_csp_connection
node_orchestration -->|"orchestrates"| node_people
node_orchestration -->|"orchestrates"| node_technical_users
node_orchestration -->|"orchestrates"| node_credentials
node_orchestration -->|"orchestrates"| node_wallet_interface
node_orchestration -->|"orchestrates"| node_connectors
node_orchestration -->|"orchestrates"| node_offers
node_orchestration -->|"orchestrates"| node_subscriptions
node_orchestration -->|"orchestrates"| node_notifications
node_service -->|"mounts fallbacks"| node_standins
node_service -->|"starts relay"| node_events
node_service -->|"resets tokens"| node_auth
node_orchestration -->|"uses relay"| node_events
node_orchestration -->|"loads flow specs"| node_spec
node_orchestration -->|"uses clients"| node_neighbours
node_neighbours -->|"sends requests"| node_http
node_standins -->|"resolves operations"| node_spec
node_csp_connection -->|"connects"| node_csp
node_ui -->|"authenticates via"| node_iam
node_iam -->|"checks wallet proof"| node_ebw_connector
node_ebw_connector -.->|"checks company wallet"| node_business_wallet
node_credentials -->|"issues credentials"| node_wallets
node_wallet_interface -->|"interfaces with"| node_wallets

click node_service "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/app.py"
click node_registry "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/registry.py"
click node_orchestration "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c12_m1/engine.py"
click node_registration "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c1_m2/router.py"
click node_review "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c1_m3/router.py"
click node_company_profile "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c3_m1/router.py"
click node_csp_connection "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c3_m2/router.py"
click node_people "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c2_m2/router.py"
click node_technical_users "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c2_m3/router.py"
click node_credentials "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c4_m1/router.py"
click node_wallet_interface "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c4_m2/router.py"
click node_connectors "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c6_m1/router.py"
click node_offers "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c8_m1/router.py"
click node_subscriptions "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c10_m1/router.py"
click node_notifications "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c11_m1/router.py"
click node_spec "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/spec.py"
click node_standins "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/standin.py"
click node_events "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/events.py"
click node_http "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/http.py"
click node_neighbours "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/neighbours.py"
click node_auth "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/tokens.py"
click node_ebw_connector "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/ebw/connector/app.py"
click node_business_wallet "https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/ebw/business_wallet/app.py"

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_service,node_registry,node_orchestration,node_ui toneBlue
class node_registration,node_review,node_company_profile,node_csp_connection toneAmber
class node_people,node_technical_users,node_credentials,node_wallet_interface,node_connectors,node_offers,node_subscriptions,node_notifications toneMint
class node_spec,node_standins,node_events,node_http,node_neighbours,node_auth toneRose
class node_ebw_connector,node_business_wallet,node_osp_staff,node_iam,node_csp,node_wallets toneIndigo
```

## Components

### Service runtime

- [Installation app](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/app.py): `scaffold/app.py`
- [Module registry](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/scaffold/registry.py): `scaffold/registry.py`
- [Process orchestration](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c12_m1/engine.py): `modules/c12_m1/engine.py`

### Onboarding and company

- [Company registration](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c1_m2/router.py): `modules/c1_m2/router.py`
- [Application review](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c1_m3/router.py): `modules/c1_m3/router.py`
- [Company profile](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c3_m1/router.py): `modules/c3_m1/router.py`
- [CSP connection](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c3_m2/router.py): `modules/c3_m2/router.py`

### Access and dataspace

- [People and app access](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c2_m2/router.py): `modules/c2_m2/router.py`
- [Technical users](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c2_m3/router.py): `modules/c2_m3/router.py`
- [Credentials](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c4_m1/router.py): `modules/c4_m1/router.py`
- [Wallet interface](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c4_m2/router.py): `modules/c4_m2/router.py`
- [Connectors](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c6_m1/router.py): `modules/c6_m1/router.py`
- [Offers](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c8_m1/router.py): `modules/c8_m1/router.py`
- [Subscriptions](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c10_m1/router.py): `modules/c10_m1/router.py`
- [Notifications](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/modules/c11_m1/router.py): `modules/c11_m1/router.py`

### Shared framework

- [Module specifications](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/spec.py): `portal_common/spec.py`
- [Stand-in interfaces](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/standin.py): `portal_common/standin.py`
- [Event relay](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/events.py): `portal_common/events.py`
- [HTTP transport](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/http.py): `portal_common/http.py`
- [Neighbour clients](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/neighbours.py): `portal_common/neighbours.py`
- [Token verification](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/portal_common/tokens.py): `portal_common/tokens.py`

### Wallet integration

- [EBW-Connector](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/ebw/connector/app.py): `ebw/connector/app.py`
- [Business Wallet](https://github.com/eclipse-tractusx/dataspace-mgm-services/blob/main/ebw/business_wallet/app.py): `ebw/business_wallet/app.py`

### Other components

- **Dataspace UI**
- **OSP staff**
- **Portal IAM**
- **CSP services**
- **Dataspace wallets**

## Connections

- Dataspace UI → Installation app: calls APIs
- Installation app → Module registry: loads modules (evidence: `scaffold/app.py`)
- Module registry → Process orchestration: registers module
- Process orchestration → Company registration: orchestrates
- Process orchestration → Application review: orchestrates
- Process orchestration → Company profile: orchestrates
- Process orchestration → CSP connection: orchestrates
- Process orchestration → People and app access: orchestrates
- Process orchestration → Technical users: orchestrates
- Process orchestration → Credentials: orchestrates
- Process orchestration → Wallet interface: orchestrates
- Process orchestration → Connectors: orchestrates
- Process orchestration → Offers: orchestrates
- Process orchestration → Subscriptions: orchestrates
- Process orchestration → Notifications: orchestrates
- Installation app → Stand-in interfaces: mounts fallbacks (evidence: `scaffold/app.py`)
- Installation app → Event relay: starts relay (evidence: `scaffold/app.py`)
- Installation app → Token verification: resets tokens (evidence: `scaffold/app.py`)
- Process orchestration → Event relay: uses relay (evidence: `modules/c12_m1/engine.py`)
- Process orchestration → Module specifications: loads flow specs (evidence: `modules/c12_m1/engine.py`)
- Process orchestration → Neighbour clients: uses clients (evidence: `modules/c12_m1/engine.py`)
- Neighbour clients → HTTP transport: sends requests (evidence: `portal_common/neighbours.py`)
- Stand-in interfaces → Module specifications: resolves operations (evidence: `portal_common/standin.py`)
- CSP connection → CSP services: connects
- Dataspace UI → Portal IAM: authenticates via
- Portal IAM → EBW-Connector: checks wallet proof
- EBW-Connector → Business Wallet: checks company wallet
- Credentials → Dataspace wallets: issues credentials
- Wallet interface → Dataspace wallets: interfaces with
