How finos/waltz works
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: routes.js Waltz browser UI · Main.java Web application · ApplicationDao.java Application inventory · data Domain data access
Components 18
Browser client
- Waltz browser UI
waltz-ng/client/routes.js - Core API client
waltz-ng/client/common/services/core-api-utils.js - Flow diagrams
waltz-ng/client/flow-diagram/components/diagram-svelte/drag-handler.js - Survey pages
waltz-ng/client/survey/routes.js - Entity pages
waltz-ng/client/entity/routes.js
Domain services
- Web application
waltz-web/src/main/java/org/finos/waltz/web/Main.java - Entity search
waltz-service/src/main/java/org/finos/waltz/service/entity_search/EntitySearchService.java - Flow classification
waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java - Relationship uploads
waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java - Change history
waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java
Data and models
- Application inventory
waltz-data/src/main/java/org/finos/waltz/data/application/ApplicationDao.java - Domain data access
waltz-data/src/main/java/org/finos/waltz/data - Entity and query models
waltz-model/src/main/java/org/finos/waltz/model - Application model
waltz-model/src/main/java/org/finos/waltz/model/application/Application.java
Shared foundations
- Common utilities
waltz-common/src/main/java/org/finos/waltz/common - Input checks
waltz-common/src/main/java/org/finos/waltz/common/Checks.java
Other components
- Architecture user
- Relational database
Connections 16
- Architecture user → Waltz browser UI: uses
README.md - Waltz browser UI → Web application: sends requests
- Waltz browser UI → Core API client: uses API utilities
waltz-ng/client/routes.js - Waltz browser UI → Entity pages: routes to
waltz-ng/client/routes.js - Waltz browser UI → Survey pages: routes to
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
waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java - Flow classification → Domain data access: uses DAOs
waltz-service/src/main/java/org/finos/waltz/service/flow_classification_rule/FlowClassificationRuleService.java - Relationship uploads → Domain data access: uses data access
waltz-service/src/main/java/org/finos/waltz/service/bulk_upload/BulkUploadLegalEntityRelationshipService.java - Change history → Domain data access: reads change data
waltz-service/src/main/java/org/finos/waltz/service/changelog/ChangeLogService.java - Application inventory → Relational database: queries
- Web application → Relational database: uses JDBC/JOOQ
README.md - Application model → Entity and query models: specialises
waltz-model/src/main/java/org/finos/waltz/model/application/Application.java - Input checks → Common utilities: validates with helpers
waltz-common/src/main/java/org/finos/waltz/common/Checks.java