# toodlejoodles/redis-clone architecture

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

- Interactive diagram: https://gitdiagram.com/toodlejoodles/redis-clone
- Repository: https://github.com/toodlejoodles/redis-clone

## Overview

This is a Redis-compatible, single-process C++ server. A client sends RESP commands over a socket; the server’s event-loop callbacks parse and dispatch them, then return serialized responses. Dispatch reaches distinct storage, sorted-set, Pub/Sub, transaction, and persistence capabilities. The README documents the broader command and persistence features; several internal links are shown only where excerpts or the source index establish them, so unsampled wiring is omitted or marked unverified.

Main entry points: [`src/server.cpp`](https://github.com/toodlejoodles/redis-clone/blob/main/src/server.cpp) (Server coordinator), [`src/storage_engine.cpp`](https://github.com/toodlejoodles/redis-clone/blob/main/src/storage_engine.cpp) (Key-value and TTL store), [`src/event_loop.cpp`](https://github.com/toodlejoodles/redis-clone/blob/main/src/event_loop.cpp) (Event loop), [`src/aof.cpp`](https://github.com/toodlejoodles/redis-clone/blob/main/src/aof.cpp) (AOF persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network["Networking and protocol"]
  node_entry["Server entrypoint<br/>[main.cpp]"]
  node_loop["Event loop<br/>[event_loop.cpp]"]
  node_net["Socket compatibility<br/>[net_compat.hpp]"]
  node_resp["RESP parser and serializer<br/>[resp_parser.cpp]"]
end

subgraph group_commands["Command coordination"]
  node_server["Server coordinator<br/>[server.cpp]"]
end

subgraph group_data["Data structures"]
  node_storage[("Key-value and TTL store<br/>[storage_engine.cpp]")]
  node_sorted["Sorted-set index<br/>[skip_list.cpp]"]
end

subgraph group_messaging["Messaging and transactions"]
  node_pubsub["Pub/Sub manager<br/>[pubsub.cpp]"]
  node_transactions["Transaction manager<br/>[transaction.cpp]"]
end

subgraph group_persistence["Persistence"]
  node_aof["AOF persistence<br/>[aof.cpp]"]
  node_rdb["RDB snapshots<br/>[rdb.cpp]"]
end

node_client(("Redis client"))

node_client -->|"sends commands"| node_server
node_entry -->|"starts"| node_server
node_server -->|"registers callbacks"| node_loop
node_loop -->|"polls sockets"| node_net
node_server -->|"parses and serializes"| node_resp
node_server -->|"dispatches commands"| node_storage
node_storage -->|"uses skip list"| node_sorted
node_server -->|"manages subscriptions"| node_pubsub
node_server -->|"executes transactions"| node_transactions
node_server -->|"saves snapshots"| node_rdb
node_server -.->|"logs mutations"| node_aof
node_aof -->|"replays commands"| node_storage
node_rdb -->|"loads and saves"| node_storage

click node_entry "https://github.com/toodlejoodles/redis-clone/blob/main/src/main.cpp"
click node_server "https://github.com/toodlejoodles/redis-clone/blob/main/src/server.cpp"
click node_loop "https://github.com/toodlejoodles/redis-clone/blob/main/src/event_loop.cpp"
click node_net "https://github.com/toodlejoodles/redis-clone/blob/main/include/net_compat.hpp"
click node_resp "https://github.com/toodlejoodles/redis-clone/blob/main/src/resp_parser.cpp"
click node_storage "https://github.com/toodlejoodles/redis-clone/blob/main/src/storage_engine.cpp"
click node_sorted "https://github.com/toodlejoodles/redis-clone/blob/main/src/skip_list.cpp"
click node_pubsub "https://github.com/toodlejoodles/redis-clone/blob/main/src/pubsub.cpp"
click node_transactions "https://github.com/toodlejoodles/redis-clone/blob/main/src/transaction.cpp"
click node_aof "https://github.com/toodlejoodles/redis-clone/blob/main/src/aof.cpp"
click node_rdb "https://github.com/toodlejoodles/redis-clone/blob/main/src/rdb.cpp"

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_entry,node_loop,node_net,node_resp toneBlue
class node_server,node_client toneAmber
class node_storage,node_sorted toneMint
class node_pubsub,node_transactions toneRose
class node_aof,node_rdb toneIndigo
```

## Components

### Networking and protocol

- [Server entrypoint](https://github.com/toodlejoodles/redis-clone/blob/main/src/main.cpp): `src/main.cpp`
- [Event loop](https://github.com/toodlejoodles/redis-clone/blob/main/src/event_loop.cpp): `src/event_loop.cpp`
- [Socket compatibility](https://github.com/toodlejoodles/redis-clone/blob/main/include/net_compat.hpp): `include/net_compat.hpp`
- [RESP parser and serializer](https://github.com/toodlejoodles/redis-clone/blob/main/src/resp_parser.cpp): `src/resp_parser.cpp`

### Command coordination

- [Server coordinator](https://github.com/toodlejoodles/redis-clone/blob/main/src/server.cpp): `src/server.cpp`

### Data structures

- [Key-value and TTL store](https://github.com/toodlejoodles/redis-clone/blob/main/src/storage_engine.cpp): `src/storage_engine.cpp`
- [Sorted-set index](https://github.com/toodlejoodles/redis-clone/blob/main/src/skip_list.cpp): `src/skip_list.cpp`

### Messaging and transactions

- [Pub/Sub manager](https://github.com/toodlejoodles/redis-clone/blob/main/src/pubsub.cpp): `src/pubsub.cpp`
- [Transaction manager](https://github.com/toodlejoodles/redis-clone/blob/main/src/transaction.cpp): `src/transaction.cpp`

### Persistence

- [AOF persistence](https://github.com/toodlejoodles/redis-clone/blob/main/src/aof.cpp): `src/aof.cpp`
- [RDB snapshots](https://github.com/toodlejoodles/redis-clone/blob/main/src/rdb.cpp): `src/rdb.cpp`

### Other components

- **Redis client**

## Connections

- Redis client → Server coordinator: sends commands (evidence: `README.md`)
- Server entrypoint → Server coordinator: starts (evidence: `src/main.cpp`)
- Server coordinator → Event loop: registers callbacks (evidence: `src/server.cpp`)
- Event loop → Socket compatibility: polls sockets
- Server coordinator → RESP parser and serializer: parses and serializes (evidence: `src/server.cpp`)
- Server coordinator → Key-value and TTL store: dispatches commands (evidence: `src/server.cpp`)
- Key-value and TTL store → Sorted-set index: uses skip list (evidence: `src/storage_engine.cpp`)
- Server coordinator → Pub/Sub manager: manages subscriptions (evidence: `src/server.cpp`)
- Server coordinator → Transaction manager: executes transactions (evidence: `src/server.cpp`)
- Server coordinator → RDB snapshots: saves snapshots (evidence: `src/server.cpp`)
- Server coordinator → AOF persistence: logs mutations
- AOF persistence → Key-value and TTL store: replays commands
- RDB snapshots → Key-value and TTL store: loads and saves
