How eclipse-tractusx/traceability-foss works
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: parts.component.ts Parts views · api.service.ts HTTP API client · NotificationService.java Notification service · BpnService.java BPN mapping
Components 28
User application
- Angular application
frontend/src/app/modules/core/app/app.component.ts - Parts views
frontend/src/app/modules/page/parts/presentation/parts.component.ts - Parts tree
frontend/src/app/modules/shared/modules/relations/presentation/tree.component.ts - Twin details
frontend/src/app/modules/page/digital-twin-part/detail/digital-twin-part-detail.component.ts - Notification views
frontend/src/app/modules/page/notifications/presentation/notifications.component.ts - HTTP API client
frontend/src/app/modules/core/api/api.service.ts - Authentication
frontend/src/app/modules/core/auth/auth.service.ts
Parts traceability
- Parts service
tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/service/DigitalTwinPartService.java - Parts endpoints
tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/application/rest/DigitalTwinPartController.java - AAS services
tx-backend/src/main/java/org/eclipse/tractusx/traceability/aas/application/service/AASService.java - Part data models
tx-backend/src/main/java/org/eclipse/tractusx/traceability/digitaltwinpart/domain/model
Quality exchange
- Notification service
tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/application/notification/service/NotificationService.java - Notification model
tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/model/Notification.java - Notification publisher
tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/base/service/NotificationPublisherService.java - EDC contracts
tx-backend/src/main/java/org/eclipse/tractusx/traceability/notification/domain/contract/EdcNotificationContractService.java - EDC network
Access and partners
- Policy management
tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/service/PolicyService.java - Policy mapping
tx-backend/src/main/java/org/eclipse/tractusx/traceability/policies/application/mapper/PolicyMapper.java - IRS policy response
tx-models/src/main/java/policies/response/IrsPolicyResponse.java - BPN mapping
tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java - BPN mapping model
tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/model/BpnEdcMapping.java - BPN request
tx-models/src/main/java/bpn/request/BpnMappingRequest.java
Configuration
- Traceability settings
tx-backend/src/main/java/org/eclipse/tractusx/traceability/common/properties/TraceabilityProperties.java - Order configuration
tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/OrderConfiguration.java - Trigger configuration
tx-backend/src/main/java/org/eclipse/tractusx/traceability/configuration/domain/model/TriggerConfiguration.java - Registry orders
tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java - Scheduled jobs
tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java
Other components
- Company user
Connections 25
- 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
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
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
tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java - BPN mapping → BPN mapping model: uses mapping
tx-backend/src/main/java/org/eclipse/tractusx/traceability/bpn/domain/service/BpnService.java - Registry orders → Order configuration: uses settings
tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java - Registry orders → Trigger configuration: uses triggers
tx-backend/src/main/java/org/eclipse/tractusx/traceability/shelldescriptor/application/DecentralRegistryService.java - Scheduled jobs → Order configuration: uses settings
tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java - Scheduled jobs → Trigger configuration: uses triggers
tx-backend/src/main/java/org/eclipse/tractusx/traceability/cron/application/CronJobRegistrationService.java