# dependencytrack/dependency-track architecture

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

- Interactive diagram: https://gitdiagram.com/dependencytrack/dependency-track
- Repository: https://github.com/dependencytrack/dependency-track

## Overview

Dependency-Track is a software supply-chain component analysis platform centered on SBOMs: organizations submit component inventories to identify and reduce risk. The tree shows API, persistence, analysis, vulnerability-data, policy, metrics, and integration subsystems; sampled source confirms persistence/query behavior and authentication, but does not show the main SBOM-ingestion or analysis orchestration. The graph preserves those documented product stages while marking unsampled connections as unverified rather than asserting a specific runtime sequence.

Main entry points: [`apiserver/src/main/java/org/dependencytrack/analysis`](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/analysis) (SBOM Analysis), [`apiserver/src/main/java/org/dependencytrack`](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack) (REST API), [`apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java`](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java) (Query Manager), [`apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java`](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java) (Component Queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Identity"]
  node_api["REST API"]
  node_authentication["Authentication"]
end

subgraph group_portfolio["Portfolio Data"]
  node_query["Query Manager<br/>[QueryManager.java]"]
  node_components["Components<br/>[Component.java]"]
  node_projects["Projects<br/>[Project.java]"]
  node_persistence[("Persistence Layer")]
  node_component_queries["Component Queries"]
end

subgraph group_risk["Risk Analysis"]
  node_sbom["SBOM Analysis"]
  node_vulnerabilities["Vulnerability Data"]
  node_policy["Policy Evaluation"]
  node_metrics["Risk Metrics"]
end

subgraph group_operations["Data and Integrations"]
  node_notifications["Notifications"]
  node_integrations["Finding Export"]
  node_workflows["Workflow Engine<br/>[DexEngineImpl.java]"]
  node_file_storage["File Storage<br/>[FileStorage.java]"]
  node_plugins["Plugins<br/>[PluginManager.java]"]
end

node_organization(("Organization"))
node_external_sources["External Sources"]

node_organization -.->|"submits SBOMs"| node_api
node_api -.->|"authenticates requests"| node_authentication
node_api -.->|"queries data"| node_query
node_query -->|"uses persistence"| node_persistence
node_query -->|"delegates component queries"| node_component_queries
node_component_queries -->|"maps components"| node_components
node_sbom -.->|"analyzes inventory"| node_components
node_external_sources -.->|"supplies vulnerability data"| node_vulnerabilities
node_sbom -.->|"identifies exposure"| node_vulnerabilities
node_sbom -.->|"evaluates policies"| node_policy
node_sbom -.->|"updates risk metrics"| node_metrics
node_sbom -.->|"triggers notifications"| node_notifications
node_sbom -.->|"exports findings"| node_integrations
node_workflows -.->|"schedules analysis"| node_sbom
node_api -.->|"stores files"| node_file_storage
node_plugins -.->|"extends capabilities"| node_api
node_projects -.->|"stored through"| node_persistence

click node_api "https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack"
click node_authentication "https://github.com/dependencytrack/dependency-track/tree/main/alpine/alpine-server/src/main/java/alpine/server/auth"
click node_query "https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java"
click node_components "https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/model/Component.java"
click node_projects "https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/model/Project.java"
click node_persistence "https://github.com/dependencytrack/dependency-track/blob/main/alpine/alpine-infra/src/main/java/alpine/persistence/AbstractAlpineQueryManager.java"
click node_component_queries "https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java"
click node_sbom "https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/analysis"
click node_vulnerabilities "https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/vulndatasource"
click node_policy "https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/policy/cel/CelPolicyEngine.java"
click node_metrics "https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/metrics"
click node_notifications "https://github.com/dependencytrack/dependency-track/blob/main/notification/publishing/src/main/java/org/dependencytrack/notification/publishing/webhook/WebhookNotificationPublisher.java"
click node_integrations "https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/integrations"
click node_workflows "https://github.com/dependencytrack/dependency-track/blob/main/dex/engine/src/main/java/org/dependencytrack/dex/engine/DexEngineImpl.java"
click node_file_storage "https://github.com/dependencytrack/dependency-track/blob/main/file-storage/api/src/main/java/org/dependencytrack/filestorage/api/FileStorage.java"
click node_plugins "https://github.com/dependencytrack/dependency-track/blob/main/plugin/runtime/src/main/java/org/dependencytrack/plugin/runtime/PluginManager.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_api,node_authentication toneBlue
class node_query,node_components,node_projects,node_persistence,node_component_queries toneAmber
class node_sbom,node_vulnerabilities,node_policy,node_metrics toneMint
class node_notifications,node_integrations,node_workflows,node_file_storage,node_plugins toneRose
class node_organization,node_external_sources toneIndigo
```

## Components

### API and Identity

- [REST API](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack): `apiserver/src/main/java/org/dependencytrack`
- [Authentication](https://github.com/dependencytrack/dependency-track/tree/main/alpine/alpine-server/src/main/java/alpine/server/auth): `alpine/alpine-server/src/main/java/alpine/server/auth`

### Portfolio Data

- [Query Manager](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java): `apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java`
- [Components](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/model/Component.java): `apiserver/src/main/java/org/dependencytrack/model/Component.java`
- [Projects](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/model/Project.java): `apiserver/src/main/java/org/dependencytrack/model/Project.java`
- [Persistence Layer](https://github.com/dependencytrack/dependency-track/blob/main/alpine/alpine-infra/src/main/java/alpine/persistence/AbstractAlpineQueryManager.java): `alpine/alpine-infra/src/main/java/alpine/persistence/AbstractAlpineQueryManager.java`
- [Component Queries](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java): `apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java`

### Risk Analysis

- [SBOM Analysis](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/analysis): `apiserver/src/main/java/org/dependencytrack/analysis`
- [Vulnerability Data](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/vulndatasource): `apiserver/src/main/java/org/dependencytrack/vulndatasource`
- [Policy Evaluation](https://github.com/dependencytrack/dependency-track/blob/main/apiserver/src/main/java/org/dependencytrack/policy/cel/CelPolicyEngine.java): `apiserver/src/main/java/org/dependencytrack/policy/cel/CelPolicyEngine.java`
- [Risk Metrics](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/metrics): `apiserver/src/main/java/org/dependencytrack/metrics`

### Data and Integrations

- [Notifications](https://github.com/dependencytrack/dependency-track/blob/main/notification/publishing/src/main/java/org/dependencytrack/notification/publishing/webhook/WebhookNotificationPublisher.java): `notification/publishing/src/main/java/org/dependencytrack/notification/publishing/webhook/WebhookNotificationPublisher.java`
- [Finding Export](https://github.com/dependencytrack/dependency-track/tree/main/apiserver/src/main/java/org/dependencytrack/integrations): `apiserver/src/main/java/org/dependencytrack/integrations`
- [Workflow Engine](https://github.com/dependencytrack/dependency-track/blob/main/dex/engine/src/main/java/org/dependencytrack/dex/engine/DexEngineImpl.java): `dex/engine/src/main/java/org/dependencytrack/dex/engine/DexEngineImpl.java`
- [File Storage](https://github.com/dependencytrack/dependency-track/blob/main/file-storage/api/src/main/java/org/dependencytrack/filestorage/api/FileStorage.java): `file-storage/api/src/main/java/org/dependencytrack/filestorage/api/FileStorage.java`
- [Plugins](https://github.com/dependencytrack/dependency-track/blob/main/plugin/runtime/src/main/java/org/dependencytrack/plugin/runtime/PluginManager.java): `plugin/runtime/src/main/java/org/dependencytrack/plugin/runtime/PluginManager.java`

### Other components

- **Organization**
- **External Sources**

## Connections

- Organization → REST API: submits SBOMs (evidence: `README.md`)
- REST API → Authentication: authenticates requests (evidence: `apiserver/src/main/java/org/dependencytrack/common/HttpClient.java`)
- REST API → Query Manager: queries data (evidence: `apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java`)
- Query Manager → Persistence Layer: uses persistence (evidence: `apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java`)
- Query Manager → Component Queries: delegates component queries (evidence: `apiserver/src/main/java/org/dependencytrack/persistence/QueryManager.java`)
- Component Queries → Components: maps components (evidence: `apiserver/src/main/java/org/dependencytrack/persistence/ComponentQueryManager.java`)
- SBOM Analysis → Components: analyzes inventory
- External Sources → Vulnerability Data: supplies vulnerability data
- SBOM Analysis → Vulnerability Data: identifies exposure (evidence: `README.md`)
- SBOM Analysis → Policy Evaluation: evaluates policies
- SBOM Analysis → Risk Metrics: updates risk metrics
- SBOM Analysis → Notifications: triggers notifications
- SBOM Analysis → Finding Export: exports findings
- Workflow Engine → SBOM Analysis: schedules analysis
- REST API → File Storage: stores files (evidence: `apiserver/src/main/java/org/dependencytrack/dex/DexEngineInitializer.java`)
- Plugins → REST API: extends capabilities (evidence: `plugin/runtime/src/main/java/org/dependencytrack/plugin/runtime/PluginManager.java`)
- Projects → Persistence Layer: stored through
