# eclipse-sw360/sw360 architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-sw360/sw360
- Repository: https://github.com/eclipse-sw360/sw360

## Overview

SW360 is a software component catalogue: users manage projects and products, their releases and components, and associated license and vulnerability metadata. The documented architecture exposes a REST API alongside Tomcat-hosted Thrift services, with CouchDB storing catalogue data. The graph follows this request path and preserves major capabilities visible in the README and tree, including SPDX, search, moderation, imports/exports, attachments, and vulnerability checking. Source excerpts confirm selected REST-to-Thrift calls; other subsystem links are omitted where wiring was not shown.

Main entry points: [`rest/resource-server`](https://github.com/eclipse-sw360/sw360/tree/main/rest/resource-server) (REST resource server), [`backend/common/src/main/java/org/eclipse/sw360/datahandler/db`](https://github.com/eclipse-sw360/sw360/tree/main/backend/common/src/main/java/org/eclipse/sw360/datahandler/db) (Database handlers), [`backend/components/src/main/java/org/eclipse/sw360/components/ComponentHandler.java`](https://github.com/eclipse-sw360/sw360/blob/main/backend/components/src/main/java/org/eclipse/sw360/components/ComponentHandler.java) (Components), [`backend/vulnerabilities/src/main/java/org/eclipse/sw360/vulnerabilities/VulnerabilityHandler.java`](https://github.com/eclipse-sw360/sw360/blob/main/backend/vulnerabilities/src/main/java/org/eclipse/sw360/vulnerabilities/VulnerabilityHandler.java) (Vulnerability checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["API access"]
  node_rest["REST resource server"]
end

subgraph group_catalogue["Catalogue services"]
  node_projects["Projects"]
  node_components["Components"]
  node_packages["Packages"]
  node_users["Users<br/>[UserHandler.java]"]
  node_search["Search<br/>[SearchHandler.java]"]
  node_attachments["Attachments"]
end

subgraph group_compliance["Compliance workflows"]
  node_licenses["License management"]
  node_licenseinfo["License information"]
  node_spdx["SPDX documents"]
  node_moderation["Moderation"]
  node_vulnerability["Vulnerability checks"]
  node_importexport["Import and export"]
  node_reports["Reports"]
end

subgraph group_persistence["Data and integrations"]
  node_dbhandlers["Database handlers"]
  node_couchdb[("CouchDB")]
  node_cveservice["CVE search service"]
  node_fossology["Fossology integration"]
end

node_client(("API consumer"))
node_cve(("CVE source"))
node_fossologyservice(("Fossology"))

node_client -->|"calls REST API"| node_rest
node_rest -->|"Thrift calls"| node_projects
node_rest -->|"Thrift calls"| node_components
node_rest -->|"searchFiltered"| node_search
node_rest -->|"user requests"| node_users
node_rest -->|"attachment requests"| node_attachments
node_rest -->|"license requests"| node_licenses
node_rest -->|"moderation requests"| node_moderation
node_rest -->|"vulnerability requests"| node_vulnerability
node_rest -->|"imports and exports"| node_importexport
node_rest -->|"report requests"| node_reports
node_rest -->|"SPDX requests"| node_spdx
node_rest -->|"license info requests"| node_licenseinfo
node_components -->|"persists catalogue"| node_dbhandlers
node_projects -->|"persists projects"| node_dbhandlers
node_packages -->|"persists packages"| node_dbhandlers
node_users -->|"persists users"| node_dbhandlers
node_licenses -->|"persists licenses"| node_dbhandlers
node_moderation -->|"stores requests"| node_dbhandlers
node_vulnerability -->|"stores ratings"| node_dbhandlers
node_attachments -->|"stores attachment metadata"| node_dbhandlers
node_search -->|"queries catalogue"| node_dbhandlers
node_dbhandlers -->|"reads and writes"| node_couchdb
node_vulnerability -->|"checks vulnerabilities"| node_cveservice
node_cveservice -.->|"queries CVE data"| node_cve
node_components -.->|"scan workflow"| node_fossology
node_fossology -.->|"calls service"| node_fossologyservice

click node_rest "https://github.com/eclipse-sw360/sw360/tree/main/rest/resource-server"
click node_projects "https://github.com/eclipse-sw360/sw360/blob/main/backend/projects/src/main/java/org/eclipse/sw360/projects/ProjectHandler.java"
click node_components "https://github.com/eclipse-sw360/sw360/blob/main/backend/components/src/main/java/org/eclipse/sw360/components/ComponentHandler.java"
click node_packages "https://github.com/eclipse-sw360/sw360/blob/main/backend/packages/src/main/java/org/eclipse/sw360/packages/PackageHandler.java"
click node_users "https://github.com/eclipse-sw360/sw360/blob/main/backend/users/src/main/java/org/eclipse/sw360/users/UserHandler.java"
click node_search "https://github.com/eclipse-sw360/sw360/blob/main/backend/search/src/main/java/org/eclipse/sw360/search/SearchHandler.java"
click node_attachments "https://github.com/eclipse-sw360/sw360/blob/main/backend/attachments/src/main/java/org/eclipse/sw360/attachments/AttachmentHandler.java"
click node_licenses "https://github.com/eclipse-sw360/sw360/blob/main/backend/licenses/src/main/java/org/eclipse/sw360/licenses/LicenseHandler.java"
click node_licenseinfo "https://github.com/eclipse-sw360/sw360/blob/main/backend/licenseinfo/src/main/java/org/eclipse/sw360/licenseinfo/LicenseInfoHandler.java"
click node_spdx "https://github.com/eclipse-sw360/sw360/blob/main/backend/spdxdocument/src/main/java/org/eclipse/sw360/spdxdocument/SPDXDocumentHandler.java"
click node_moderation "https://github.com/eclipse-sw360/sw360/blob/main/backend/moderation/src/main/java/org/eclipse/sw360/moderation/ModerationHandler.java"
click node_vulnerability "https://github.com/eclipse-sw360/sw360/blob/main/backend/vulnerabilities/src/main/java/org/eclipse/sw360/vulnerabilities/VulnerabilityHandler.java"
click node_importexport "https://github.com/eclipse-sw360/sw360/blob/main/rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/importexport/Sw360ImportExportService.java"
click node_reports "https://github.com/eclipse-sw360/sw360/blob/main/rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/report/SW360ReportService.java"
click node_dbhandlers "https://github.com/eclipse-sw360/sw360/tree/main/backend/common/src/main/java/org/eclipse/sw360/datahandler/db"
click node_cveservice "https://github.com/eclipse-sw360/sw360/blob/main/backend/cvesearch/src/main/java/org/eclipse/sw360/cvesearch/service/CveSearchHandler.java"
click node_fossology "https://github.com/eclipse-sw360/sw360/blob/main/backend/fossology/src/main/java/org/eclipse/sw360/fossology/FossologyHandler.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_rest toneBlue
class node_projects,node_components,node_packages,node_users,node_search,node_attachments toneAmber
class node_licenses,node_licenseinfo,node_spdx,node_moderation,node_vulnerability,node_importexport,node_reports,node_client toneMint
class node_dbhandlers,node_couchdb,node_cveservice,node_fossology toneRose
class node_cve,node_fossologyservice toneIndigo
```

## Components

### API access

- [REST resource server](https://github.com/eclipse-sw360/sw360/tree/main/rest/resource-server): `rest/resource-server`

### Catalogue services

- [Projects](https://github.com/eclipse-sw360/sw360/blob/main/backend/projects/src/main/java/org/eclipse/sw360/projects/ProjectHandler.java): `backend/projects/src/main/java/org/eclipse/sw360/projects/ProjectHandler.java`
- [Components](https://github.com/eclipse-sw360/sw360/blob/main/backend/components/src/main/java/org/eclipse/sw360/components/ComponentHandler.java): `backend/components/src/main/java/org/eclipse/sw360/components/ComponentHandler.java`
- [Packages](https://github.com/eclipse-sw360/sw360/blob/main/backend/packages/src/main/java/org/eclipse/sw360/packages/PackageHandler.java): `backend/packages/src/main/java/org/eclipse/sw360/packages/PackageHandler.java`
- [Users](https://github.com/eclipse-sw360/sw360/blob/main/backend/users/src/main/java/org/eclipse/sw360/users/UserHandler.java): `backend/users/src/main/java/org/eclipse/sw360/users/UserHandler.java`
- [Search](https://github.com/eclipse-sw360/sw360/blob/main/backend/search/src/main/java/org/eclipse/sw360/search/SearchHandler.java): `backend/search/src/main/java/org/eclipse/sw360/search/SearchHandler.java`
- [Attachments](https://github.com/eclipse-sw360/sw360/blob/main/backend/attachments/src/main/java/org/eclipse/sw360/attachments/AttachmentHandler.java): `backend/attachments/src/main/java/org/eclipse/sw360/attachments/AttachmentHandler.java`

### Compliance workflows

- [License management](https://github.com/eclipse-sw360/sw360/blob/main/backend/licenses/src/main/java/org/eclipse/sw360/licenses/LicenseHandler.java): `backend/licenses/src/main/java/org/eclipse/sw360/licenses/LicenseHandler.java`
- [License information](https://github.com/eclipse-sw360/sw360/blob/main/backend/licenseinfo/src/main/java/org/eclipse/sw360/licenseinfo/LicenseInfoHandler.java): `backend/licenseinfo/src/main/java/org/eclipse/sw360/licenseinfo/LicenseInfoHandler.java`
- [SPDX documents](https://github.com/eclipse-sw360/sw360/blob/main/backend/spdxdocument/src/main/java/org/eclipse/sw360/spdxdocument/SPDXDocumentHandler.java): `backend/spdxdocument/src/main/java/org/eclipse/sw360/spdxdocument/SPDXDocumentHandler.java`
- [Moderation](https://github.com/eclipse-sw360/sw360/blob/main/backend/moderation/src/main/java/org/eclipse/sw360/moderation/ModerationHandler.java): `backend/moderation/src/main/java/org/eclipse/sw360/moderation/ModerationHandler.java`
- [Vulnerability checks](https://github.com/eclipse-sw360/sw360/blob/main/backend/vulnerabilities/src/main/java/org/eclipse/sw360/vulnerabilities/VulnerabilityHandler.java): `backend/vulnerabilities/src/main/java/org/eclipse/sw360/vulnerabilities/VulnerabilityHandler.java`
- [Import and export](https://github.com/eclipse-sw360/sw360/blob/main/rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/importexport/Sw360ImportExportService.java): `rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/importexport/Sw360ImportExportService.java`
- [Reports](https://github.com/eclipse-sw360/sw360/blob/main/rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/report/SW360ReportService.java): `rest/resource-server/src/main/java/org/eclipse/sw360/rest/resourceserver/report/SW360ReportService.java`

### Data and integrations

- [Database handlers](https://github.com/eclipse-sw360/sw360/tree/main/backend/common/src/main/java/org/eclipse/sw360/datahandler/db): `backend/common/src/main/java/org/eclipse/sw360/datahandler/db`
- **CouchDB**
- [CVE search service](https://github.com/eclipse-sw360/sw360/blob/main/backend/cvesearch/src/main/java/org/eclipse/sw360/cvesearch/service/CveSearchHandler.java): `backend/cvesearch/src/main/java/org/eclipse/sw360/cvesearch/service/CveSearchHandler.java`
- [Fossology integration](https://github.com/eclipse-sw360/sw360/blob/main/backend/fossology/src/main/java/org/eclipse/sw360/fossology/FossologyHandler.java): `backend/fossology/src/main/java/org/eclipse/sw360/fossology/FossologyHandler.java`

### Other components

- **API consumer**
- **CVE source**
- **Fossology**

## Connections

- API consumer → REST resource server: calls REST API
- REST resource server → Projects: Thrift calls
- REST resource server → Components: Thrift calls
- REST resource server → Search: searchFiltered
- REST resource server → Users: user requests
- REST resource server → Attachments: attachment requests
- REST resource server → License management: license requests
- REST resource server → Moderation: moderation requests
- REST resource server → Vulnerability checks: vulnerability requests
- REST resource server → Import and export: imports and exports
- REST resource server → Reports: report requests
- REST resource server → SPDX documents: SPDX requests
- REST resource server → License information: license info requests
- Components → Database handlers: persists catalogue
- Projects → Database handlers: persists projects
- Packages → Database handlers: persists packages
- Users → Database handlers: persists users
- License management → Database handlers: persists licenses
- Moderation → Database handlers: stores requests
- Vulnerability checks → Database handlers: stores ratings
- Attachments → Database handlers: stores attachment metadata
- Search → Database handlers: queries catalogue
- Database handlers → CouchDB: reads and writes
- Vulnerability checks → CVE search service: checks vulnerabilities
- CVE search service → CVE source: queries CVE data
- Components → Fossology integration: scan workflow
- Fossology integration → Fossology: calls service
