# tschwarzinger/rdf-fusion architecture

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

- Interactive diagram: https://gitdiagram.com/tschwarzinger/rdf-fusion
- Repository: https://github.com/tschwarzinger/rdf-fusion

## Overview

RDF Fusion is an experimental, embeddable SPARQL engine built on DataFusion, with CLI, HTTP, WebAssembly, and browser-playground entry points. A typical CLI workflow loads RDF into a selected storage backend, parses and plans SPARQL queries, executes them against a storage snapshot, then returns or serializes results. The graph also preserves the documented dump/optimize and Parquet-query capabilities. Several subsystem connections are dashed because the relevant implementation was not sampled; the browser worker and core query path have direct excerpt evidence.

Main entry points: [`lib/execution/src/sparql/evaluate_query.rs`](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/sparql/evaluate_query.rs) (Query evaluator), [`lib/execution/src/engine.rs`](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/engine.rs) (Engine context), [`cli/src/main.rs`](https://github.com/tschwarzinger/rdf-fusion/blob/main/cli/src/main.rs) (CLI commands), [`lib/storage/src/delta/storage.rs`](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/storage/src/delta/storage.rs) (DeltaQuads storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI commands<br/>[main.rs]"]
  node_http["SPARQL HTTP"]
  node_wasm["Wasm API<br/>[lib.rs]"]
end

subgraph group_query["SPARQL query"]
  node_parser["SPARQL parser<br/>[query.rs]"]
  node_ast["Query AST<br/>[mod.rs]"]
end

subgraph group_execution["Planning and execution"]
  node_engine["Engine context<br/>[engine.rs]"]
  node_evaluator["Query evaluator<br/>[evaluate_query.rs]"]
  node_optimizer["Query optimizer<br/>[optimizer.rs]"]
  node_logical["Logical planning"]
  node_physical["Physical planning<br/>[planner.rs]"]
  node_results["Query results<br/>[mod.rs]"]
  node_functions["SPARQL functions<br/>[registry.rs]"]
end

subgraph group_data["Data and storage"]
  node_encoding["Quad encodings"]
  node_delta[("DeltaQuads storage<br/>[storage.rs]")]
  node_parquet[("Parquet storage<br/>[storage.rs]")]
end

subgraph group_browser["Browser playground"]
  node_playground["Playground UI<br/>[main.js]"]
  node_enginejs["Engine manager<br/>[engine.js]"]
  node_proxy["Worker proxy<br/>[engineProxy.js]"]
  node_worker["Engine worker"]
  node_localdb[("Version cache<br/>[db.js]")]
end

node_user(("CLI user"))

node_user -->|"runs commands"| node_cli
node_cli -->|"loads or dumps"| node_delta
node_cli -->|"queries"| node_parquet
node_cli -->|"serves endpoint"| node_http
node_parser -->|"builds AST"| node_ast
node_engine -->|"invokes"| node_evaluator
node_engine -->|"registers functions"| node_functions
node_engine -.->|"uses storage"| node_delta
node_evaluator -->|"applies rules"| node_optimizer
node_evaluator -->|"plans execution"| node_physical
node_evaluator -->|"returns streams"| node_results
node_evaluator -.->|"uses logical plan"| node_logical
node_physical -.->|"scans snapshot"| node_delta
node_physical -.->|"scans snapshot"| node_parquet
node_delta -->|"selects encoding"| node_encoding
node_http -.->|"evaluates queries"| node_engine
node_wasm -.->|"exposes engine"| node_engine
node_playground -.->|"manages engine"| node_enginejs
node_enginejs -->|"reads and writes"| node_localdb
node_enginejs -->|"creates proxy"| node_proxy
node_proxy -->|"sends messages"| node_worker
node_worker -->|"loads and calls"| node_wasm

click node_cli "https://github.com/tschwarzinger/rdf-fusion/blob/main/cli/src/main.rs"
click node_http "https://github.com/tschwarzinger/rdf-fusion/tree/main/lib/web/src/repositories"
click node_wasm "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/wasm/src/lib.rs"
click node_parser "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/sparql-parser/src/parser/query.rs"
click node_ast "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/sparql-parser/src/ast/mod.rs"
click node_engine "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/engine.rs"
click node_evaluator "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/sparql/evaluate_query.rs"
click node_optimizer "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/sparql/optimizer.rs"
click node_logical "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/logical/src/logical_plan_builder.rs"
click node_physical "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/planner.rs"
click node_results "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/results/mod.rs"
click node_functions "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/functions/src/registry.rs"
click node_encoding "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/encoding/src/quad_storage_encoding.rs"
click node_delta "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/storage/src/delta/storage.rs"
click node_parquet "https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/storage/src/parquet/storage.rs"
click node_playground "https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/main.js"
click node_enginejs "https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engine.js"
click node_proxy "https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engineProxy.js"
click node_worker "https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engineWorkerSource.js"
click node_localdb "https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/db.js"

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_cli,node_http,node_wasm,node_user toneBlue
class node_parser,node_ast toneAmber
class node_engine,node_evaluator,node_optimizer,node_logical,node_physical,node_results,node_functions toneMint
class node_encoding,node_delta,node_parquet toneRose
class node_playground,node_enginejs,node_proxy,node_worker,node_localdb toneIndigo
```

## Components

### User interfaces

- [CLI commands](https://github.com/tschwarzinger/rdf-fusion/blob/main/cli/src/main.rs): `cli/src/main.rs`
- [SPARQL HTTP](https://github.com/tschwarzinger/rdf-fusion/tree/main/lib/web/src/repositories): `lib/web/src/repositories`
- [Wasm API](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/wasm/src/lib.rs): `lib/wasm/src/lib.rs`

### SPARQL query

- [SPARQL parser](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/sparql-parser/src/parser/query.rs): `lib/sparql-parser/src/parser/query.rs`
- [Query AST](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/sparql-parser/src/ast/mod.rs): `lib/sparql-parser/src/ast/mod.rs`

### Planning and execution

- [Engine context](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/engine.rs): `lib/execution/src/engine.rs`
- [Query evaluator](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/sparql/evaluate_query.rs): `lib/execution/src/sparql/evaluate_query.rs`
- [Query optimizer](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/sparql/optimizer.rs): `lib/execution/src/sparql/optimizer.rs`
- [Logical planning](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/logical/src/logical_plan_builder.rs): `lib/logical/src/logical_plan_builder.rs`
- [Physical planning](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/planner.rs): `lib/execution/src/planner.rs`
- [Query results](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/execution/src/results/mod.rs): `lib/execution/src/results/mod.rs`
- [SPARQL functions](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/functions/src/registry.rs): `lib/functions/src/registry.rs`

### Data and storage

- [Quad encodings](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/encoding/src/quad_storage_encoding.rs): `lib/encoding/src/quad_storage_encoding.rs`
- [DeltaQuads storage](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/storage/src/delta/storage.rs): `lib/storage/src/delta/storage.rs`
- [Parquet storage](https://github.com/tschwarzinger/rdf-fusion/blob/main/lib/storage/src/parquet/storage.rs): `lib/storage/src/parquet/storage.rs`

### Browser playground

- [Playground UI](https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/main.js): `misc/pages/svelte/playground/main.js`
- [Engine manager](https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engine.js): `misc/pages/svelte/playground/engine.js`
- [Worker proxy](https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engineProxy.js): `misc/pages/svelte/playground/engineProxy.js`
- [Engine worker](https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/engineWorkerSource.js): `misc/pages/svelte/playground/engineWorkerSource.js`
- [Version cache](https://github.com/tschwarzinger/rdf-fusion/blob/main/misc/pages/svelte/playground/db.js): `misc/pages/svelte/playground/db.js`

### Other components

- **CLI user**

## Connections

- CLI user → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → DeltaQuads storage: loads or dumps (evidence: `README.md`)
- CLI commands → Parquet storage: queries (evidence: `README.md`)
- CLI commands → SPARQL HTTP: serves endpoint (evidence: `README.md`)
- SPARQL parser → Query AST: builds AST (evidence: `lib/sparql-parser/src/parser/query.rs`)
- Engine context → Query evaluator: invokes (evidence: `lib/execution/src/engine.rs`)
- Engine context → SPARQL functions: registers functions (evidence: `lib/execution/src/engine.rs`)
- Engine context → DeltaQuads storage: uses storage
- Query evaluator → Query optimizer: applies rules (evidence: `lib/execution/src/sparql/evaluate_query.rs`)
- Query evaluator → Physical planning: plans execution (evidence: `lib/execution/src/sparql/evaluate_query.rs`)
- Query evaluator → Query results: returns streams (evidence: `lib/execution/src/sparql/evaluate_query.rs`)
- Query evaluator → Logical planning: uses logical plan
- Physical planning → DeltaQuads storage: scans snapshot
- Physical planning → Parquet storage: scans snapshot
- DeltaQuads storage → Quad encodings: selects encoding (evidence: `lib/storage/src/delta/storage.rs`)
- SPARQL HTTP → Engine context: evaluates queries
- Wasm API → Engine context: exposes engine
- Playground UI → Engine manager: manages engine
- Engine manager → Version cache: reads and writes (evidence: `misc/pages/svelte/playground/engine.js`)
- Engine manager → Worker proxy: creates proxy (evidence: `misc/pages/svelte/playground/engine.js`)
- Worker proxy → Engine worker: sends messages (evidence: `misc/pages/svelte/playground/engineProxy.js`)
- Engine worker → Wasm API: loads and calls (evidence: `misc/pages/svelte/playground/engineWorkerSource.js`)
