# michelderu/cassandra-fundamentals architecture

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

- Interactive diagram: https://gitdiagram.com/michelderu/cassandra-fundamentals
- Repository: https://github.com/michelderu/cassandra-fundamentals

## Overview

This repository is a hands-on Cassandra training course, not a Cassandra implementation. Learners study cluster architecture and operations, then practice query-first data modeling against a shared three-node Compose cluster; the README also supports starting with data modeling. The graph preserves all 14 course modules and the shared lab environment. Relationships are based on README descriptions and learning paths; no source excerpts were provided.

Main entry points: [`docker-compose.yml`](https://github.com/michelderu/cassandra-fundamentals/blob/main/docker-compose.yml) (Three-Node Cluster), [`architecture/02-lab-environment.md`](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/02-lab-environment.md) (Lab Environment), [`data-modeling/02-process-and-primary-key.md`](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/02-process-and-primary-key.md) (Process & Keys), [`architecture/03-masterless-peers-and-placement.md`](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/03-masterless-peers-and-placement.md) (Peers & Placement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_architecture["Architecture Track"]
  node_arch01["Architecture"]
  node_arch02["Lab Environment"]
  node_arch03["Peers &amp; Placement"]
  node_arch04["Consistency"]
  node_arch05["Gossip &amp; Topology"]
  node_arch06["Storage Engine"]
  node_arch07["Repair &amp; LWT"]
end

subgraph group_lab["Shared Lab"]
  node_compose["Three-Node Cluster<br/>[docker-compose.yml]"]
end

subgraph group_modeling["Data Modeling Track"]
  node_model01["Modeling Intro"]
  node_model02["Process &amp; Keys"]
  node_model03["Placement &amp; Health"]
  node_model04["Clustering"]
  node_model05["Tombstones"]
  node_model06["Anti-Patterns"]
  node_model07["Checklist &amp; Blueprint"]
end

node_learner(("Learner"))

node_learner -->|"studies first"| node_arch01
node_arch01 -->|"continues to"| node_arch02
node_arch02 -->|"continues to"| node_arch03
node_arch03 -->|"continues to"| node_arch04
node_arch04 -->|"continues to"| node_arch05
node_arch05 -->|"continues to"| node_arch06
node_arch06 -->|"continues to"| node_arch07
node_arch07 -->|"then studies"| node_model01
node_learner -->|"may start here"| node_model01
node_model01 -->|"continues to"| node_model02
node_model02 -->|"continues to"| node_model03
node_model03 -->|"continues to"| node_model04
node_model04 -->|"continues to"| node_model05
node_model05 -->|"continues to"| node_model06
node_model06 -->|"continues to"| node_model07
node_arch02 -->|"sets up"| node_compose
node_arch02 -->|"prepares schema for"| node_model02
node_compose -->|"supports labs"| node_arch03
node_compose -->|"supports labs"| node_arch04
node_compose -->|"supports labs"| node_arch05
node_compose -->|"supports labs"| node_arch06
node_compose -->|"supports labs"| node_arch07
node_compose -->|"supports labs"| node_model02
node_compose -->|"supports labs"| node_model03
node_compose -->|"supports labs"| node_model04
node_compose -->|"supports labs"| node_model05
node_compose -->|"supports labs"| node_model06
node_compose -->|"supports labs"| node_model07

click node_arch01 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/01-architecture-and-deployment.md"
click node_arch02 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/02-lab-environment.md"
click node_arch03 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/03-masterless-peers-and-placement.md"
click node_arch04 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/04-cap-and-tunable-consistency.md"
click node_arch05 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/05-gossip-and-topology.md"
click node_arch06 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/06-storage-engine-write-through-read.md"
click node_arch07 "https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/07-self-healing-lwt-and-summary.md"
click node_compose "https://github.com/michelderu/cassandra-fundamentals/blob/main/docker-compose.yml"
click node_model01 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/01-intro-and-paradigm.md"
click node_model02 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/02-process-and-primary-key.md"
click node_model03 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/03-placement-and-partition-health.md"
click node_model04 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/04-clustering-and-wide-partitions.md"
click node_model05 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/05-tombstones-and-denormalization.md"
click node_model06 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/06-anti-patterns.md"
click node_model07 "https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/07-checklist-labs-and-blueprint.md"

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_arch01,node_arch02,node_arch03,node_arch04,node_arch05,node_arch06,node_arch07 toneBlue
class node_compose toneAmber
class node_model01,node_model02,node_model03,node_model04,node_model05,node_model06,node_model07 toneMint
class node_learner toneIndigo
```

## Components

### Architecture Track

- [Architecture](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/01-architecture-and-deployment.md): `architecture/01-architecture-and-deployment.md`
- [Lab Environment](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/02-lab-environment.md): `architecture/02-lab-environment.md`
- [Peers & Placement](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/03-masterless-peers-and-placement.md): `architecture/03-masterless-peers-and-placement.md`
- [Consistency](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/04-cap-and-tunable-consistency.md): `architecture/04-cap-and-tunable-consistency.md`
- [Gossip & Topology](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/05-gossip-and-topology.md): `architecture/05-gossip-and-topology.md`
- [Storage Engine](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/06-storage-engine-write-through-read.md): `architecture/06-storage-engine-write-through-read.md`
- [Repair & LWT](https://github.com/michelderu/cassandra-fundamentals/blob/main/architecture/07-self-healing-lwt-and-summary.md): `architecture/07-self-healing-lwt-and-summary.md`

### Shared Lab

- [Three-Node Cluster](https://github.com/michelderu/cassandra-fundamentals/blob/main/docker-compose.yml): `docker-compose.yml`

### Data Modeling Track

- [Modeling Intro](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/01-intro-and-paradigm.md): `data-modeling/01-intro-and-paradigm.md`
- [Process & Keys](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/02-process-and-primary-key.md): `data-modeling/02-process-and-primary-key.md`
- [Placement & Health](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/03-placement-and-partition-health.md): `data-modeling/03-placement-and-partition-health.md`
- [Clustering](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/04-clustering-and-wide-partitions.md): `data-modeling/04-clustering-and-wide-partitions.md`
- [Tombstones](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/05-tombstones-and-denormalization.md): `data-modeling/05-tombstones-and-denormalization.md`
- [Anti-Patterns](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/06-anti-patterns.md): `data-modeling/06-anti-patterns.md`
- [Checklist & Blueprint](https://github.com/michelderu/cassandra-fundamentals/blob/main/data-modeling/07-checklist-labs-and-blueprint.md): `data-modeling/07-checklist-labs-and-blueprint.md`

### Other components

- **Learner**

## Connections

- Learner → Architecture: studies first (evidence: `README.md`)
- Architecture → Lab Environment: continues to (evidence: `README.md`)
- Lab Environment → Peers & Placement: continues to (evidence: `README.md`)
- Peers & Placement → Consistency: continues to (evidence: `README.md`)
- Consistency → Gossip & Topology: continues to (evidence: `README.md`)
- Gossip & Topology → Storage Engine: continues to (evidence: `README.md`)
- Storage Engine → Repair & LWT: continues to (evidence: `README.md`)
- Repair & LWT → Modeling Intro: then studies (evidence: `README.md`)
- Learner → Modeling Intro: may start here (evidence: `README.md`)
- Modeling Intro → Process & Keys: continues to (evidence: `README.md`)
- Process & Keys → Placement & Health: continues to (evidence: `README.md`)
- Placement & Health → Clustering: continues to (evidence: `README.md`)
- Clustering → Tombstones: continues to (evidence: `README.md`)
- Tombstones → Anti-Patterns: continues to (evidence: `README.md`)
- Anti-Patterns → Checklist & Blueprint: continues to (evidence: `README.md`)
- Lab Environment → Three-Node Cluster: sets up (evidence: `README.md`)
- Lab Environment → Process & Keys: prepares schema for (evidence: `README.md`)
- Three-Node Cluster → Peers & Placement: supports labs (evidence: `README.md`)
- Three-Node Cluster → Consistency: supports labs (evidence: `README.md`)
- Three-Node Cluster → Gossip & Topology: supports labs (evidence: `README.md`)
- Three-Node Cluster → Storage Engine: supports labs (evidence: `README.md`)
- Three-Node Cluster → Repair & LWT: supports labs (evidence: `README.md`)
- Three-Node Cluster → Process & Keys: supports labs (evidence: `README.md`)
- Three-Node Cluster → Placement & Health: supports labs (evidence: `README.md`)
- Three-Node Cluster → Clustering: supports labs (evidence: `README.md`)
- Three-Node Cluster → Tombstones: supports labs (evidence: `README.md`)
- Three-Node Cluster → Anti-Patterns: supports labs (evidence: `README.md`)
- Three-Node Cluster → Checklist & Blueprint: supports labs (evidence: `README.md`)
