# dataease/dataease architecture

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

- Interactive diagram: https://gitdiagram.com/dataease/dataease
- Repository: https://github.com/dataease/dataease

## Overview

DataEase is an open-source business intelligence application. Its main workflow is to connect a data source, organize or query data, build charts through a visual interface, and share the resulting analysis. The repository also includes spreadsheet functionality, templates, exports, and datasource-engine management. The README documents the product-level capabilities; the sampled source confirms engine configuration and chart-filter handling, but does not expose enough call sites to trace most runtime interactions, so those links are documented at the product level.

Main entry points: [`core/core-frontend/src`](https://github.com/dataease/dataease/tree/dev-v3/core/core-frontend/src) (BI interface), [`core/core-backend/src/main/java/io/dataease/chart/manage/ChartDataManage.java`](https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/chart/manage/ChartDataManage.java) (Chart data service), [`core/core-backend/src/main/java/io/dataease/visualization`](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/visualization) (Dashboards), [`core/core-backend/src/main/java/io/dataease/datasource`](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/datasource) (Datasource management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["BI interface"]
  node_spreadsheet["Spreadsheet"]
end

subgraph group_data["Data preparation"]
  node_datasource["Datasource management"]
  node_dataset["Dataset management"]
  node_sql_engine["Query engine"]
end

subgraph group_analysis["Visualization"]
  node_chart_data["Chart data service"]
  node_chart_handlers["Chart handlers"]
  node_visualization["Dashboards"]
  node_sharing["Visualization sharing"]
end

subgraph group_platform["Platform services"]
  node_templates["Template center"]
  node_exports["Export center"]
  node_engine_settings["Engine settings<br/>[EngineServer.java]"]
end

node_analyst(("Analyst"))
node_source_system[("External data sources")]

node_analyst -->|"uses"| node_frontend
node_frontend -->|"connects sources"| node_datasource
node_datasource -->|"queries data"| node_source_system
node_frontend -->|"analyzes data"| node_dataset
node_dataset -.->|"builds queries"| node_sql_engine
node_frontend -.->|"requests chart data"| node_chart_data
node_chart_data -.->|"executes queries"| node_sql_engine
node_chart_data -.->|"formats results"| node_chart_handlers
node_frontend -->|"creates dashboards"| node_visualization
node_visualization -->|"shares analysis"| node_sharing
node_analyst -.->|"uses spreadsheets"| node_spreadsheet
node_frontend -->|"uses templates"| node_templates
node_visualization -.->|"exports analysis"| node_exports
node_analyst -.->|"configures engine"| node_engine_settings

click node_frontend "https://github.com/dataease/dataease/tree/dev-v3/core/core-frontend/src"
click node_spreadsheet "https://github.com/dataease/dataease/tree/dev-v3/core/core-frontend/src/views/menu/spreadsheet"
click node_datasource "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/datasource"
click node_dataset "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/dataset"
click node_sql_engine "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/engine"
click node_chart_data "https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/chart/manage/ChartDataManage.java"
click node_chart_handlers "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/chart/charts/impl"
click node_visualization "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/visualization"
click node_sharing "https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/visualization/server/VisualizationOuterParamsService.java"
click node_templates "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/template"
click node_exports "https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/exportCenter"
click node_engine_settings "https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/datasource/server/EngineServer.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_frontend,node_spreadsheet toneBlue
class node_datasource,node_dataset,node_sql_engine,node_source_system toneAmber
class node_chart_data,node_chart_handlers,node_visualization,node_sharing toneMint
class node_templates,node_exports,node_engine_settings toneRose
class node_analyst toneIndigo
```

## Components

### User experience

- [BI interface](https://github.com/dataease/dataease/tree/dev-v3/core/core-frontend/src): `core/core-frontend/src`
- [Spreadsheet](https://github.com/dataease/dataease/tree/dev-v3/core/core-frontend/src/views/menu/spreadsheet): `core/core-frontend/src/views/menu/spreadsheet`

### Data preparation

- [Datasource management](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/datasource): `core/core-backend/src/main/java/io/dataease/datasource`
- [Dataset management](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/dataset): `core/core-backend/src/main/java/io/dataease/dataset`
- [Query engine](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/engine): `core/core-backend/src/main/java/io/dataease/engine`

### Visualization

- [Chart data service](https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/chart/manage/ChartDataManage.java): `core/core-backend/src/main/java/io/dataease/chart/manage/ChartDataManage.java`
- [Chart handlers](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/chart/charts/impl): `core/core-backend/src/main/java/io/dataease/chart/charts/impl`
- [Dashboards](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/visualization): `core/core-backend/src/main/java/io/dataease/visualization`
- [Visualization sharing](https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/visualization/server/VisualizationOuterParamsService.java): `core/core-backend/src/main/java/io/dataease/visualization/server/VisualizationOuterParamsService.java`

### Platform services

- [Template center](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/template): `core/core-backend/src/main/java/io/dataease/template`
- [Export center](https://github.com/dataease/dataease/tree/dev-v3/core/core-backend/src/main/java/io/dataease/exportCenter): `core/core-backend/src/main/java/io/dataease/exportCenter`
- [Engine settings](https://github.com/dataease/dataease/blob/dev-v3/core/core-backend/src/main/java/io/dataease/datasource/server/EngineServer.java): `core/core-backend/src/main/java/io/dataease/datasource/server/EngineServer.java`

### Other components

- **Analyst**
- **External data sources**

## Connections

- Analyst → BI interface: uses (evidence: `README.md`)
- BI interface → Datasource management: connects sources (evidence: `README.md`)
- Datasource management → External data sources: queries data (evidence: `README.md`)
- BI interface → Dataset management: analyzes data (evidence: `README.md`)
- Dataset management → Query engine: builds queries
- BI interface → Chart data service: requests chart data
- Chart data service → Query engine: executes queries
- Chart data service → Chart handlers: formats results
- BI interface → Dashboards: creates dashboards (evidence: `README.md`)
- Dashboards → Visualization sharing: shares analysis (evidence: `README.md`)
- Analyst → Spreadsheet: uses spreadsheets
- BI interface → Template center: uses templates (evidence: `README.md`)
- Dashboards → Export center: exports analysis
- Analyst → Engine settings: configures engine
