# finos/waltz architecture

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

- Interactive diagram: https://gitdiagram.com/finos/waltz
- Repository: https://github.com/finos/waltz

## Overview

Waltz is an enterprise-architecture landscape tool: users browse and maintain structured information about organisational technology. The documented client is browser-based and the server uses Java, Spark and JDBC/JOOQ. The tree also exposes distinct capabilities for application inventory, flow diagrams, surveys, and classification rules, backed by service and data modules. The excerpts do not show web routing or most capability implementations, so those connections are omitted or marked unverified rather than inferred from names alone.

Main entry points: [`waltz-ng/client/routes.js`](https://github.com/finos/waltz/blob/master/waltz-ng/client/routes.js) (Waltz browser UI), [`waltz-web/src/main/java/org/finos/waltz/web/Main.java`](https://github.com/finos/waltz/blob/master/waltz-web/src/main/java/org/finos/waltz/web/Main.java) (Web application), [`waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java`](https://github.com/finos/waltz/blob/master/waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java) (Application inventory), [`waltz-data/src/main/java/org/finos/waltz/data`](https://github.com/finos/waltz/tree/master/waltz-data/src/main/java/org/finos/waltz/data) (Domain data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_browser["Waltz browser UI<br/>[routes.js]"]
  node_api_client["Core API client<br/>[core-api-utils.js]"]
  node_flow_ui["Flow diagrams<br/>[drag-handler.js]"]
  node_survey_ui["Survey pages<br/>[routes.js]"]
  node_entity_ui["Entity pages<br/>[routes.js]"]
end

subgraph group_domain["Domain services"]
  node_web["Web application<br/>[Main.java]"]
  node_entity_search["Entity search"]
  node_flow_rules["Flow classification"]
  node_bulk_upload["Relationship uploads"]
  node_change_log["Change history"]
end

subgraph group_data["Data and models"]
  node_application_data["Application inventory"]
  node_data_access["Domain data access"]
  node_domain_models["Entity and query models"]
  node_application_model["Application model<br/>[Application.java]"]
end

subgraph group_shared["Shared foundations"]
  node_common_utilities["Common utilities"]
  node_checks["Input checks<br/>[Checks.java]"]
end

node_user(("Architecture user"))
node_database[("Relational database")]

node_user -->|"uses"| node_browser
node_browser -.->|"sends requests"| node_web
node_browser -->|"uses API utilities"| node_api_client
node_browser -->|"routes to"| node_entity_ui
node_browser -->|"routes to"| node_survey_ui
node_user -.->|"views landscape"| node_flow_ui
node_web -.->|"dispatches requests"| node_entity_search
node_entity_search -.->|"searches applications"| node_application_data
node_flow_rules -->|"reads applications"| node_application_data
node_flow_rules -->|"uses DAOs"| node_data_access
node_bulk_upload -->|"uses data access"| node_data_access
node_change_log -->|"reads change data"| node_data_access
node_application_data -.->|"queries"| node_database
node_web -->|"uses JDBC/JOOQ"| node_database
node_application_model -->|"specialises"| node_domain_models
node_checks -->|"validates with helpers"| node_common_utilities

click node_browser "https://github.com/finos/waltz/blob/master/waltz-ng/client/routes.js"
click node_api_client "https://github.com/finos/waltz/blob/master/waltz-ng/client/common/services/core-api-utils.js"
click node_flow_ui "https://github.com/finos/waltz/blob/master/waltz-ng/client/flow-diagram/components/diagram-svelte/drag-handler.js"
click node_survey_ui "https://github.com/finos/waltz/blob/master/waltz-ng/client/survey/routes.js"
click node_entity_ui "https://github.com/finos/waltz/blob/master/waltz-ng/client/entity/routes.js"
click node_web "https://github.com/finos/waltz/blob/master/waltz-web/src/main/java/org/finos/waltz/web/Main.java"
click node_entity_search "https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/entity_search/EntitySearchService.java"
click node_flow_rules "https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java"
click node_bulk_upload "https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java"
click node_change_log "https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java"
click node_application_data "https://github.com/finos/waltz/blob/master/waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java"
click node_data_access "https://github.com/finos/waltz/tree/master/waltz-data/src/main/java/org/finos/waltz/data"
click node_domain_models "https://github.com/finos/waltz/tree/master/waltz-model/src/main/java/org/finos/waltz/model"
click node_application_model "https://github.com/finos/waltz/blob/master/waltz-model/src/main/java/org/finos/waltz/model/application/Application.java"
click node_common_utilities "https://github.com/finos/waltz/tree/master/waltz-common/src/main/java/org/finos/waltz/common"
click node_checks "https://github.com/finos/waltz/blob/master/waltz-common/src/main/java/org/finos/waltz/common/Checks.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_browser,node_api_client,node_flow_ui,node_survey_ui,node_entity_ui,node_user toneBlue
class node_web,node_entity_search,node_flow_rules,node_bulk_upload,node_change_log,node_database toneAmber
class node_application_data,node_data_access,node_domain_models,node_application_model toneMint
class node_common_utilities,node_checks toneRose
```

## Components

### Browser client

- [Waltz browser UI](https://github.com/finos/waltz/blob/master/waltz-ng/client/routes.js): `waltz-ng/client/routes.js`
- [Core API client](https://github.com/finos/waltz/blob/master/waltz-ng/client/common/services/core-api-utils.js): `waltz-ng/client/common/services/core-api-utils.js`
- [Flow diagrams](https://github.com/finos/waltz/blob/master/waltz-ng/client/flow-diagram/components/diagram-svelte/drag-handler.js): `waltz-ng/client/flow-diagram/components/diagram-svelte/drag-handler.js`
- [Survey pages](https://github.com/finos/waltz/blob/master/waltz-ng/client/survey/routes.js): `waltz-ng/client/survey/routes.js`
- [Entity pages](https://github.com/finos/waltz/blob/master/waltz-ng/client/entity/routes.js): `waltz-ng/client/entity/routes.js`

### Domain services

- [Web application](https://github.com/finos/waltz/blob/master/waltz-web/src/main/java/org/finos/waltz/web/Main.java): `waltz-web/src/main/java/org/finos/waltz/web/Main.java`
- [Entity search](https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/entity_search/EntitySearchService.java): `waltz-service/src/main/java/org/finos/waltz/service/entity_search/EntitySearchService.java`
- [Flow classification](https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java): `waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java`
- [Relationship uploads](https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java): `waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java`
- [Change history](https://github.com/finos/waltz/blob/master/waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java): `waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java`

### Data and models

- [Application inventory](https://github.com/finos/waltz/blob/master/waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java): `waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java`
- [Domain data access](https://github.com/finos/waltz/tree/master/waltz-data/src/main/java/org/finos/waltz/data): `waltz-data/src/main/java/org/finos/waltz/data`
- [Entity and query models](https://github.com/finos/waltz/tree/master/waltz-model/src/main/java/org/finos/waltz/model): `waltz-model/src/main/java/org/finos/waltz/model`
- [Application model](https://github.com/finos/waltz/blob/master/waltz-model/src/main/java/org/finos/waltz/model/application/Application.java): `waltz-model/src/main/java/org/finos/waltz/model/application/Application.java`

### Shared foundations

- [Common utilities](https://github.com/finos/waltz/tree/master/waltz-common/src/main/java/org/finos/waltz/common): `waltz-common/src/main/java/org/finos/waltz/common`
- [Input checks](https://github.com/finos/waltz/blob/master/waltz-common/src/main/java/org/finos/waltz/common/Checks.java): `waltz-common/src/main/java/org/finos/waltz/common/Checks.java`

### Other components

- **Architecture user**
- **Relational database**

## Connections

- Architecture user → Waltz browser UI: uses (evidence: `README.md`)
- Waltz browser UI → Web application: sends requests
- Waltz browser UI → Core API client: uses API utilities (evidence: `waltz-ng/client/routes.js`)
- Waltz browser UI → Entity pages: routes to (evidence: `waltz-ng/client/routes.js`)
- Waltz browser UI → Survey pages: routes to (evidence: `waltz-ng/client/survey/routes.js`)
- Architecture user → Flow diagrams: views landscape
- Web application → Entity search: dispatches requests
- Entity search → Application inventory: searches applications
- Flow classification → Application inventory: reads applications (evidence: `waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java`)
- Flow classification → Domain data access: uses DAOs (evidence: `waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java`)
- Relationship uploads → Domain data access: uses data access (evidence: `waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java`)
- Change history → Domain data access: reads change data (evidence: `waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java`)
- Application inventory → Relational database: queries
- Web application → Relational database: uses JDBC/JOOQ (evidence: `README.md`)
- Application model → Entity and query models: specialises (evidence: `waltz-model/src/main/java/org/finos/waltz/model/application/Application.java`)
- Input checks → Common utilities: validates with helpers (evidence: `waltz-common/src/main/java/org/finos/waltz/common/Checks.java`)
