# eclipse-tractusx/traceability-foss architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-tractusx/traceability-foss
- Repository: https://github.com/eclipse-tractusx/traceability-foss

## Overview

Trace-X is a supply-chain parts-traceability application: users inspect manufactured and planned parts, search and filter them, explore part relationships, and exchange quality investigations and alerts. Its frontend provides the user entry point; backend services expose traceability, notification, policy, and partner-mapping capabilities, with EDC supporting notification exchange. The map retains documented capabilities and central indexed modules, but many implementation links are unverified because their source was not sampled; those links are dashed rather than asserted as observed calls.

Main entry points: [`frontend/src/app/modules/page/parts/presentation/parts.component.ts`](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/parts/presentation/parts.component.ts) (Parts views), [`frontend/src/app/modules/core/api/api.service.ts`](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/api/api.service.ts) (HTTP API client), [`tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java`](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java) (Notification service), [`tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java`](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java) (BPN mapping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User application"]
  node_ui["Angular application<br/>[app.component.ts]"]
  node_parts_ui["Parts views<br/>[parts.component.ts]"]
  node_relations_ui["Parts tree<br/>[tree.component.ts]"]
  node_twin_ui["Twin details"]
  node_notifications_ui["Notification views"]
  node_api["HTTP API client<br/>[api.service.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
end

subgraph group_trace["Parts traceability"]
  node_parts_service["Parts service"]
  node_parts_controller["Parts endpoints"]
  node_aas["AAS services<br/>[AASService.java]"]
  node_parts_data["Part data models"]
end

subgraph group_exchange["Quality exchange"]
  node_notifications["Notification service"]
  node_notification_model["Notification model<br/>[Notification.java]"]
  node_publisher["Notification publisher"]
  node_edc_contract["EDC contracts"]
  node_edc{{"EDC network"}}
end

subgraph group_governance["Access and partners"]
  node_policies["Policy management<br/>[PolicyService.java]"]
  node_policy_mapping["Policy mapping<br/>[PolicyMapper.java]"]
  node_policy_response["IRS policy response"]
  node_bpn["BPN mapping<br/>[BpnService.java]"]
  node_bpn_model["BPN mapping model<br/>[BpnEdcMapping.java]"]
  node_bpn_request["BPN request"]
end

subgraph group_operations["Configuration"]
  node_properties["Traceability settings"]
  node_order_config["Order configuration"]
  node_trigger_config["Trigger configuration"]
  node_registry["Registry orders"]
  node_cron["Scheduled jobs"]
end

node_user(("Company user"))

node_user -->|"uses"| node_ui
node_ui -.->|"opens parts"| node_parts_ui
node_parts_ui -.->|"requests parts"| node_api
node_api -.->|"calls API"| node_parts_controller
node_parts_controller -.->|"delegates to"| node_parts_service
node_parts_service -.->|"returns details"| node_parts_data
node_parts_ui -->|"explores relations"| node_relations_ui
node_parts_ui -->|"views details"| node_twin_ui
node_twin_ui -.->|"loads description"| node_aas
node_user -->|"manages investigations"| node_notifications_ui
node_notifications_ui -.->|"requests notifications"| node_api
node_api -.->|"calls API"| node_notifications
node_notifications -.->|"updates state"| node_notification_model
node_notifications -.->|"publishes messages"| node_publisher
node_publisher -.->|"exchanges messages"| node_edc
node_edc_contract -.->|"configures contracts"| node_edc
node_user -.->|"manages access"| node_policies
node_policies -.->|"maps policies"| node_policy_mapping
node_policy_mapping -.->|"creates response"| node_policy_response
node_bpn -->|"accepts request"| node_bpn_request
node_bpn -->|"uses mapping"| node_bpn_model
node_registry -->|"uses settings"| node_order_config
node_registry -->|"uses triggers"| node_trigger_config
node_cron -->|"uses settings"| node_order_config
node_cron -->|"uses triggers"| node_trigger_config

click node_ui "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/app/app.component.ts"
click node_parts_ui "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/parts/presentation/parts.component.ts"
click node_relations_ui "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/shared/modules/relations/presentation/tree.component.ts"
click node_twin_ui "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/digital-twin-part/detail/digital-twin-part-detail.component.ts"
click node_notifications_ui "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/notifications/presentation/notifications.component.ts"
click node_api "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/api/api.service.ts"
click node_auth "https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/auth/auth.service.ts"
click node_parts_service "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/service/DigitalTwinPartService.java"
click node_parts_controller "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/rest/DigitalTwinPartController.java"
click node_aas "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/aas/application/service/AASService.java"
click node_parts_data "https://github.com/eclipse-tractusx/traceability-foss/tree/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/domain/model"
click node_notifications "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java"
click node_notification_model "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/model/Notification.java"
click node_publisher "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/service/NotificationPublisherService.java"
click node_edc_contract "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/contract/EdcNotificationContractService.java"
click node_policies "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/service/PolicyService.java"
click node_policy_mapping "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/mapper/PolicyMapper.java"
click node_policy_response "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-models/src/main/java/policies/response/IrsPolicyResponse.java"
click node_bpn "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java"
click node_bpn_model "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/model/BpnEdcMapping.java"
click node_bpn_request "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-models/src/main/java/bpn/request/BpnMappingRequest.java"
click node_properties "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/common/properties/TraceabilityProperties.java"
click node_order_config "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/OrderConfiguration.java"
click node_trigger_config "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/TriggerConfiguration.java"
click node_registry "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java"
click node_cron "https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java"

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_ui,node_parts_ui,node_relations_ui,node_twin_ui,node_notifications_ui,node_api,node_auth,node_user toneBlue
class node_parts_service,node_parts_controller,node_aas,node_parts_data toneAmber
class node_notifications,node_notification_model,node_publisher,node_edc_contract,node_edc toneMint
class node_policies,node_policy_mapping,node_policy_response,node_bpn,node_bpn_model,node_bpn_request toneRose
class node_properties,node_order_config,node_trigger_config,node_registry,node_cron toneIndigo
```

## Components

### User application

- [Angular application](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/app/app.component.ts): `frontend/src/app/modules/core/app/app.component.ts`
- [Parts views](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/parts/presentation/parts.component.ts): `frontend/src/app/modules/page/parts/presentation/parts.component.ts`
- [Parts tree](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/shared/modules/relations/presentation/tree.component.ts): `frontend/src/app/modules/shared/modules/relations/presentation/tree.component.ts`
- [Twin details](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/digital-twin-part/detail/digital-twin-part-detail.component.ts): `frontend/src/app/modules/page/digital-twin-part/detail/digital-twin-part-detail.component.ts`
- [Notification views](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/page/notifications/presentation/notifications.component.ts): `frontend/src/app/modules/page/notifications/presentation/notifications.component.ts`
- [HTTP API client](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/api/api.service.ts): `frontend/src/app/modules/core/api/api.service.ts`
- [Authentication](https://github.com/eclipse-tractusx/traceability-foss/blob/main/frontend/src/app/modules/core/auth/auth.service.ts): `frontend/src/app/modules/core/auth/auth.service.ts`

### Parts traceability

- [Parts service](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/service/DigitalTwinPartService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/service/DigitalTwinPartService.java`
- [Parts endpoints](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/rest/DigitalTwinPartController.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/rest/DigitalTwinPartController.java`
- [AAS services](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/aas/application/service/AASService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/aas/application/service/AASService.java`
- [Part data models](https://github.com/eclipse-tractusx/traceability-foss/tree/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/domain/model): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/domain/model`

### Quality exchange

- [Notification service](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java`
- [Notification model](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/model/Notification.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/model/Notification.java`
- [Notification publisher](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/service/NotificationPublisherService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/service/NotificationPublisherService.java`
- [EDC contracts](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/contract/EdcNotificationContractService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/contract/EdcNotificationContractService.java`
- **EDC network**

### Access and partners

- [Policy management](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/service/PolicyService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/service/PolicyService.java`
- [Policy mapping](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/mapper/PolicyMapper.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/mapper/PolicyMapper.java`
- [IRS policy response](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-models/src/main/java/policies/response/IrsPolicyResponse.java): `tx-models/src/main/java/policies/response/IrsPolicyResponse.java`
- [BPN mapping](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java`
- [BPN mapping model](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/model/BpnEdcMapping.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/model/BpnEdcMapping.java`
- [BPN request](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-models/src/main/java/bpn/request/BpnMappingRequest.java): `tx-models/src/main/java/bpn/request/BpnMappingRequest.java`

### Configuration

- [Traceability settings](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/common/properties/TraceabilityProperties.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/common/properties/TraceabilityProperties.java`
- [Order configuration](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/OrderConfiguration.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/OrderConfiguration.java`
- [Trigger configuration](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/TriggerConfiguration.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/TriggerConfiguration.java`
- [Registry orders](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java`
- [Scheduled jobs](https://github.com/eclipse-tractusx/traceability-foss/blob/main/tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java): `tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java`

### Other components

- **Company user**

## Connections

- Company user → Angular application: uses
- Angular application → Parts views: opens parts
- Parts views → HTTP API client: requests parts
- HTTP API client → Parts endpoints: calls API
- Parts endpoints → Parts service: delegates to
- Parts service → Part data models: returns details (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/service/DigitalTwinPartService.java`)
- Parts views → Parts tree: explores relations
- Parts views → Twin details: views details
- Twin details → AAS services: loads description
- Company user → Notification views: manages investigations
- Notification views → HTTP API client: requests notifications
- HTTP API client → Notification service: calls API
- Notification service → Notification model: updates state
- Notification service → Notification publisher: publishes messages
- Notification publisher → EDC network: exchanges messages
- EDC contracts → EDC network: configures contracts (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/contract/EdcNotificationContractService.java`)
- Company user → Policy management: manages access
- Policy management → Policy mapping: maps policies
- Policy mapping → IRS policy response: creates response
- BPN mapping → BPN request: accepts request (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java`)
- BPN mapping → BPN mapping model: uses mapping (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java`)
- Registry orders → Order configuration: uses settings (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java`)
- Registry orders → Trigger configuration: uses triggers (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java`)
- Scheduled jobs → Order configuration: uses settings (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java`)
- Scheduled jobs → Trigger configuration: uses triggers (evidence: `tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java`)
