# arcadedata/arcadedb architecture

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

- Interactive diagram: https://gitdiagram.com/arcadedata/arcadedb
- Repository: https://github.com/arcadedata/arcadedb

## Overview

ArcadeDB is a transactional multi-model database. A typical user submits a query through a server interface or compatible client; the server selects a language engine, executes against database records, and returns results. The graph also preserves documented model and query-language capabilities, time-series querying, and Raft high availability. The excerpts establish engine registration, several engine behaviors, HTTP result handling, and Raft peer requests; links not demonstrated by those excerpts or the README are omitted or marked unverified.

Main entry points: [`engine/src/main/java/com/arcadedb/database/Database.java`](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/database/Database.java) (Records and transactions), [`engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/QueryEngineManager.java) (Engine registry), [`server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java`](https://github.com/arcadedata/arcadedb/blob/main/server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java) (HTTP query handler), [`engine/src/main/java/com/arcadedb/query/sql/SQLQueryEngine.java`](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/sql/SQLQueryEngine.java) (SQL engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Client interfaces"]
  node_http["HTTP query handler"]
  node_bolt["Bolt protocol"]
  node_python["Python binding<br/>[core.py]"]
  node_postgres["PostgreSQL interface"]
end

subgraph group_query["Query languages"]
  node_engine_manager["Engine registry"]
  node_sql["SQL engine"]
  node_cypher["OpenCypher engine"]
  node_gremlin["Gremlin engine"]
  node_graphql["GraphQL engine"]
  node_mongo["Mongo query engine"]
  node_redis["Redis query engine"]
end

subgraph group_models["Data models"]
  node_graph["Graph model<br/>[GraphEngine.java]"]
  node_timeseries["Time-series engine"]
  node_vector[("Vector index")]
end

subgraph group_core["Database core"]
  node_records["Records and transactions<br/>[Database.java]"]
  node_storage[("Storage engine<br/>[Bucket.java]")]
end

subgraph group_operations["Operations"]
  node_raft["Raft clustering"]
end

node_client(("Database client"))
node_peer(("Cluster peer"))

node_client -.->|"submits query"| node_http
node_http -->|"selects engine"| node_engine_manager
node_engine_manager -->|"creates engine"| node_sql
node_engine_manager -->|"registers engine"| node_cypher
node_engine_manager -->|"registers engine"| node_gremlin
node_engine_manager -->|"registers engine"| node_graphql
node_engine_manager -->|"registers engine"| node_mongo
node_engine_manager -->|"registers engine"| node_redis
node_sql -.->|"operates on"| node_records
node_cypher -->|"plans against"| node_records
node_gremlin -.->|"executes commands"| node_records
node_mongo -->|"delegates queries"| node_records
node_redis -->|"executes commands"| node_records
node_records -.->|"persists records"| node_storage
node_records -.->|"supports graph data"| node_graph
node_records -.->|"supports time series"| node_timeseries
node_records -.->|"supports embeddings"| node_vector
node_client -.->|"connects via Bolt"| node_bolt
node_client -.->|"uses embedded API"| node_python
node_client -.->|"connects via PostgreSQL"| node_postgres
node_raft -->|"requests peer state"| node_peer

click node_http "https://github.com/arcadedata/arcadedb/blob/main/server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java"
click node_bolt "https://github.com/arcadedata/arcadedb/blob/main/bolt/src/main/java/com/arcadedb/bolt/BoltProtocolPlugin.java"
click node_python "https://github.com/arcadedata/arcadedb/blob/main/bindings/python/src/arcadedb_embedded/core.py"
click node_engine_manager "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/QueryEngineManager.java"
click node_sql "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/sql/SQLQueryEngine.java"
click node_cypher "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/opencypher/query/OpenCypherQueryEngine.java"
click node_gremlin "https://github.com/arcadedata/arcadedb/blob/main/gremlin/src/main/java/com/arcadedb/gremlin/query/GremlinQueryEngine.java"
click node_graphql "https://github.com/arcadedata/arcadedb/blob/main/graphql/src/main/java/com/arcadedb/graphql/query/GraphQLQueryEngine.java"
click node_mongo "https://github.com/arcadedata/arcadedb/blob/main/mongodbw/src/main/java/com/arcadedb/mongo/query/MongoQueryEngine.java"
click node_redis "https://github.com/arcadedata/arcadedb/blob/main/redisw/src/main/java/com/arcadedb/redis/query/RedisQueryEngine.java"
click node_records "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/database/Database.java"
click node_storage "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/engine/Bucket.java"
click node_graph "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/graph/GraphEngine.java"
click node_timeseries "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/engine/timeseries/TimeSeriesEngine.java"
click node_vector "https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/index/sparsevector/PaginatedSparseVectorEngine.java"
click node_postgres "https://github.com/arcadedata/arcadedb/blob/main/postgresw/src/main/java/com/arcadedb/postgres/PostgresSystemQuery.java"
click node_raft "https://github.com/arcadedata/arcadedb/blob/main/ha-raft/src/main/java/com/arcadedb/server/ha/raft/RaftClusterManager.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_http,node_bolt,node_python,node_postgres toneBlue
class node_engine_manager,node_sql,node_cypher,node_gremlin,node_graphql,node_mongo,node_redis,node_client toneAmber
class node_graph,node_timeseries,node_vector toneMint
class node_records,node_storage toneRose
class node_raft,node_peer toneIndigo
```

## Components

### Client interfaces

- [HTTP query handler](https://github.com/arcadedata/arcadedb/blob/main/server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java): `server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java`
- [Bolt protocol](https://github.com/arcadedata/arcadedb/blob/main/bolt/src/main/java/com/arcadedb/bolt/BoltProtocolPlugin.java): `bolt/src/main/java/com/arcadedb/bolt/BoltProtocolPlugin.java`
- [Python binding](https://github.com/arcadedata/arcadedb/blob/main/bindings/python/src/arcadedb_embedded/core.py): `bindings/python/src/arcadedb_embedded/core.py`
- [PostgreSQL interface](https://github.com/arcadedata/arcadedb/blob/main/postgresw/src/main/java/com/arcadedb/postgres/PostgresSystemQuery.java): `postgresw/src/main/java/com/arcadedb/postgres/PostgresSystemQuery.java`

### Query languages

- [Engine registry](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/QueryEngineManager.java): `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`
- [SQL engine](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/sql/SQLQueryEngine.java): `engine/src/main/java/com/arcadedb/query/sql/SQLQueryEngine.java`
- [OpenCypher engine](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/query/opencypher/query/OpenCypherQueryEngine.java): `engine/src/main/java/com/arcadedb/query/opencypher/query/OpenCypherQueryEngine.java`
- [Gremlin engine](https://github.com/arcadedata/arcadedb/blob/main/gremlin/src/main/java/com/arcadedb/gremlin/query/GremlinQueryEngine.java): `gremlin/src/main/java/com/arcadedb/gremlin/query/GremlinQueryEngine.java`
- [GraphQL engine](https://github.com/arcadedata/arcadedb/blob/main/graphql/src/main/java/com/arcadedb/graphql/query/GraphQLQueryEngine.java): `graphql/src/main/java/com/arcadedb/graphql/query/GraphQLQueryEngine.java`
- [Mongo query engine](https://github.com/arcadedata/arcadedb/blob/main/mongodbw/src/main/java/com/arcadedb/mongo/query/MongoQueryEngine.java): `mongodbw/src/main/java/com/arcadedb/mongo/query/MongoQueryEngine.java`
- [Redis query engine](https://github.com/arcadedata/arcadedb/blob/main/redisw/src/main/java/com/arcadedb/redis/query/RedisQueryEngine.java): `redisw/src/main/java/com/arcadedb/redis/query/RedisQueryEngine.java`

### Data models

- [Graph model](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/graph/GraphEngine.java): `engine/src/main/java/com/arcadedb/graph/GraphEngine.java`
- [Time-series engine](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/engine/timeseries/TimeSeriesEngine.java): `engine/src/main/java/com/arcadedb/engine/timeseries/TimeSeriesEngine.java`
- [Vector index](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/index/sparsevector/PaginatedSparseVectorEngine.java): `engine/src/main/java/com/arcadedb/index/sparsevector/PaginatedSparseVectorEngine.java`

### Database core

- [Records and transactions](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/database/Database.java): `engine/src/main/java/com/arcadedb/database/Database.java`
- [Storage engine](https://github.com/arcadedata/arcadedb/blob/main/engine/src/main/java/com/arcadedb/engine/Bucket.java): `engine/src/main/java/com/arcadedb/engine/Bucket.java`

### Operations

- [Raft clustering](https://github.com/arcadedata/arcadedb/blob/main/ha-raft/src/main/java/com/arcadedb/server/ha/raft/RaftClusterManager.java): `ha-raft/src/main/java/com/arcadedb/server/ha/raft/RaftClusterManager.java`

### Other components

- **Database client**
- **Cluster peer**

## Connections

- Database client → HTTP query handler: submits query (evidence: `README.md`)
- HTTP query handler → Engine registry: selects engine (evidence: `server/src/main/java/com/arcadedb/server/http/handler/AbstractQueryHandler.java`)
- Engine registry → SQL engine: creates engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- Engine registry → OpenCypher engine: registers engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- Engine registry → Gremlin engine: registers engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- Engine registry → GraphQL engine: registers engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- Engine registry → Mongo query engine: registers engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- Engine registry → Redis query engine: registers engine (evidence: `engine/src/main/java/com/arcadedb/query/QueryEngineManager.java`)
- SQL engine → Records and transactions: operates on
- OpenCypher engine → Records and transactions: plans against (evidence: `engine/src/main/java/com/arcadedb/query/opencypher/query/OpenCypherQueryEngine.java`)
- Gremlin engine → Records and transactions: executes commands
- Mongo query engine → Records and transactions: delegates queries (evidence: `mongodbw/src/main/java/com/arcadedb/mongo/query/MongoQueryEngine.java`)
- Redis query engine → Records and transactions: executes commands (evidence: `redisw/src/main/java/com/arcadedb/redis/query/RedisQueryEngine.java`)
- Records and transactions → Storage engine: persists records
- Records and transactions → Graph model: supports graph data (evidence: `README.md`)
- Records and transactions → Time-series engine: supports time series (evidence: `README.md`)
- Records and transactions → Vector index: supports embeddings (evidence: `README.md`)
- Database client → Bolt protocol: connects via Bolt (evidence: `README.md`)
- Database client → Python binding: uses embedded API (evidence: `README.md`)
- Database client → PostgreSQL interface: connects via PostgreSQL (evidence: `README.md`)
- Raft clustering → Cluster peer: requests peer state
