# eclipse-capella/capella-for-syson architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-capella/capella-for-syson
- Repository: https://github.com/eclipse-capella/capella-for-syson

## Overview

Capella for SysON is a web-based Capella/Arcadia modeling extension built on SysON, Sirius Web, and SysML v2. Users work with engineering models through the web application: browse and select model elements, inspect their semantic context, and create or edit model representations such as diagrams and forms. The backend supplies Arcadia-aware queries and view services across the engineering lifecycle. The README documents the SysON extension and frontend integration; sampled source confirms selected query-service dependencies, but does not expose the full runtime wiring, so those links are omitted.

Main entry points: [`backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java`](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java) (Common model queries), [`backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java`](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java) (Semantic browser), [`backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java`](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java) (Operational analysis), [`backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java`](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java) (System analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application integration"]
  node_webapp["SysON web app"]
  node_frontend["Capella frontend<br/>[index.tsx]"]
  node_configuration["Capella configuration"]
  node_templates["Project templates"]
  node_libraries["Arcadia libraries"]
end

subgraph group_browse["Model navigation"]
  node_explorer["Model explorer"]
  node_selection["Explorer selection"]
  node_semantic["Semantic browser"]
  node_traceability["Traceability labels"]
end

subgraph group_model["Arcadia model services"]
  node_common["Common model queries"]
  node_types["Type queries"]
  node_perspectives["Arcadia perspectives"]
  node_oa["Operational analysis"]
  node_sa["System analysis"]
  node_la["Logical architecture"]
  node_ddv["Functional context"]
end

subgraph group_views["Model representations"]
  node_diagram["Diagram services"]
  node_diagramcustom["Diagram customization"]
  node_forms["Model forms"]
end

node_engineer(("Model engineer"))

node_engineer -->|"uses"| node_webapp
node_webapp -->|"displays"| node_frontend
node_webapp -->|"loads extension"| node_configuration
node_explorer -->|"queries model"| node_common
node_semantic -->|"queries model"| node_common
node_semantic -->|"gets labels"| node_traceability
node_oa -->|"queries model"| node_common
node_sa -->|"queries model"| node_common
node_la -->|"queries model"| node_common
node_ddv -->|"queries model"| node_common
node_common -->|"uses type queries"| node_types
node_oa -->|"filters by perspective"| node_perspectives
node_sa -->|"checks perspective"| node_perspectives
node_forms -->|"queries model"| node_common
node_diagramcustom -.->|"resolves representation labels"| node_webapp
node_engineer -.->|"starts project from"| node_templates
node_engineer -.->|"publishes library"| node_libraries

click node_frontend "https://github.com/eclipse-capella/capella-for-syson/blob/master/frontend/capella-for-syson/src/index.tsx"
click node_configuration "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/CapellaForSysONAutoConfiguration.java"
click node_explorer "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/services/CapellaExplorerService.java"
click node_selection "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/selection/CapellaSelectionTreeService.java"
click node_semantic "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java"
click node_traceability "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/services/ArcadiaTraceabilityLabelService.java"
click node_common "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java"
click node_types "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/TypeQueryService.java"
click node_perspectives "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/ArcadiaEngineeringPerspective.java"
click node_oa "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java"
click node_sa "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java"
click node_la "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/logical/architecture/LAQueryService.java"
click node_ddv "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/functional/context/DDVQueryService.java"
click node_diagram "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-diagram-ocb-view/src/main/java/org/eclipse/capella/diagram/ocb/view/services/OCBDiagramService.java"
click node_diagramcustom "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-diagram-customization/src/main/java/org/eclipse/capella/diagram/customization/services/RepresentationDescriptionLabelSearchService.java"
click node_forms "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-form-view/src/main/java/org/eclipse/capella/form/view/util/CapellaViewFormService.java"
click node_templates "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/template/CapellaProjectTemplateProvider.java"
click node_libraries "https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/arcadia/services/ArcadiaLibraryPublisher.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_webapp,node_frontend,node_configuration,node_templates,node_libraries toneBlue
class node_explorer,node_selection,node_semantic,node_traceability toneAmber
class node_common,node_types,node_perspectives,node_oa,node_sa,node_la,node_ddv toneMint
class node_diagram,node_diagramcustom,node_forms toneRose
class node_engineer toneIndigo
```

## Components

### Application integration

- **SysON web app**
- [Capella frontend](https://github.com/eclipse-capella/capella-for-syson/blob/master/frontend/capella-for-syson/src/index.tsx): `frontend/capella-for-syson/src/index.tsx`
- [Capella configuration](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/CapellaForSysONAutoConfiguration.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/CapellaForSysONAutoConfiguration.java`
- [Project templates](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/template/CapellaProjectTemplateProvider.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/template/CapellaProjectTemplateProvider.java`
- [Arcadia libraries](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/arcadia/services/ArcadiaLibraryPublisher.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/arcadia/services/ArcadiaLibraryPublisher.java`

### Model navigation

- [Model explorer](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/services/CapellaExplorerService.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/services/CapellaExplorerService.java`
- [Explorer selection](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/selection/CapellaSelectionTreeService.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/selection/CapellaSelectionTreeService.java`
- [Semantic browser](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java`
- [Traceability labels](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/services/ArcadiaTraceabilityLabelService.java): `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/services/ArcadiaTraceabilityLabelService.java`

### Arcadia model services

- [Common model queries](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java): `backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java`
- [Type queries](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/TypeQueryService.java): `backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/TypeQueryService.java`
- [Arcadia perspectives](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/ArcadiaEngineeringPerspective.java): `backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/ArcadiaEngineeringPerspective.java`
- [Operational analysis](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java): `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java`
- [System analysis](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java): `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java`
- [Logical architecture](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/logical/architecture/LAQueryService.java): `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/logical/architecture/LAQueryService.java`
- [Functional context](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/functional/context/DDVQueryService.java): `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/functional/context/DDVQueryService.java`

### Model representations

- [Diagram services](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-diagram-ocb-view/src/main/java/org/eclipse/capella/diagram/ocb/view/services/OCBDiagramService.java): `backend/views/capella-diagram-ocb-view/src/main/java/org/eclipse/capella/diagram/ocb/view/services/OCBDiagramService.java`
- [Diagram customization](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-diagram-customization/src/main/java/org/eclipse/capella/diagram/customization/services/RepresentationDescriptionLabelSearchService.java): `backend/views/capella-diagram-customization/src/main/java/org/eclipse/capella/diagram/customization/services/RepresentationDescriptionLabelSearchService.java`
- [Model forms](https://github.com/eclipse-capella/capella-for-syson/blob/master/backend/views/capella-form-view/src/main/java/org/eclipse/capella/form/view/util/CapellaViewFormService.java): `backend/views/capella-form-view/src/main/java/org/eclipse/capella/form/view/util/CapellaViewFormService.java`

### Other components

- **Model engineer**

## Connections

- Model engineer → SysON web app: uses (evidence: `README.md`)
- SysON web app → Capella frontend: displays (evidence: `README.md`)
- SysON web app → Capella configuration: loads extension (evidence: `README.md`)
- Model explorer → Common model queries: queries model (evidence: `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/explorer/services/CapellaExplorerService.java`)
- Semantic browser → Common model queries: queries model (evidence: `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java`)
- Semantic browser → Traceability labels: gets labels (evidence: `backend/application/capella-application-configuration/src/main/java/org/eclipse/capella/application/configuration/details/view/semanticbrowser/SemanticBrowserService.java`)
- Operational analysis → Common model queries: queries model (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java`)
- System analysis → Common model queries: queries model (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java`)
- Logical architecture → Common model queries: queries model (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/logical/architecture/LAQueryService.java`)
- Functional context → Common model queries: queries model (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/functional/context/DDVQueryService.java`)
- Common model queries → Type queries: uses type queries (evidence: `backend/model/capella-model-transverse-services/src/main/java/org/eclipse/capella/model/transverse/services/CommonQueryService.java`)
- Operational analysis → Arcadia perspectives: filters by perspective (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/operational/analysis/OAQueryService.java`)
- System analysis → Arcadia perspectives: checks perspective (evidence: `backend/model/capella-model-services/src/main/java/org/eclipse/capella/model/services/system/analysis/SAQueryService.java`)
- Model forms → Common model queries: queries model (evidence: `backend/views/capella-form-view/src/main/java/org/eclipse/capella/form/view/util/CapellaViewFormService.java`)
- Diagram customization → SysON web app: resolves representation labels
- Model engineer → Project templates: starts project from
- Model engineer → Arcadia libraries: publishes library
