# apollostary/donnemartin-system-design-primer architecture

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

- Interactive diagram: https://gitdiagram.com/apollostary/donnemartin-system-design-primer
- Repository: https://github.com/apollostary/donnemartin-system-design-primer

## Overview

The repository is an educational primer for learning large-scale system design and preparing for system- and object-oriented-design interviews, rather than a deployable application. Learners use the study guide and topic summaries, practice interview questions, compare sample solutions, and reinforce concepts with flashcards. The README documents these capabilities; the solution directories and decks are present in the tree. The excerpts show selected solution implementations, but not the full content or wiring of every subsystem, so relationships among individual examples are not inferred.

Main entry points: [`solutions/system_design`](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design) (System design solutions), [`solutions/object_oriented_design`](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design) (Object design solutions), [`README.md`](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md) (System interview questions), [`solutions/system_design/pastebin`](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/pastebin) (Pastebin example)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning materials"]
  node_primer["Primer topics<br/>[README.md]"]
  node_study["Study guide<br/>[README.md]"]
  node_interview["Interview approach<br/>[README.md]"]
  node_systemquestions["System interview questions<br/>[README.md]"]
  node_oodquestions["Object design questions<br/>[README.md]"]
end

subgraph group_system["System design examples"]
  node_systemexamples["System design solutions"]
  node_pastebin["Pastebin example"]
  node_mint["Mint example"]
  node_querycache["Query cache example"]
  node_salesrank["Sales rank example"]
  node_socialgraph["Social graph example"]
  node_crawler["Web crawler example"]
  node_scaling["AWS scaling example"]
end

subgraph group_ood["Object design examples"]
  node_oodexamples["Object design solutions"]
  node_callcenter["Call center example"]
  node_cards["Deck of cards example"]
  node_parking["Parking lot example"]
  node_chat["Online chat example"]
end

subgraph group_practice["Practice aids"]
  node_flashcards["Anki flashcard decks"]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_primer
node_learner -->|"uses"| node_study
node_learner -->|"learns approach"| node_interview
node_learner -->|"practices"| node_systemquestions
node_learner -->|"practices"| node_oodquestions
node_systemquestions -->|"compares solutions"| node_systemexamples
node_oodquestions -->|"compares solutions"| node_oodexamples
node_learner -->|"reviews"| node_flashcards
node_systemexamples -.->|"includes example"| node_pastebin
node_systemexamples -.->|"includes example"| node_mint
node_systemexamples -.->|"includes example"| node_querycache
node_systemexamples -.->|"includes example"| node_salesrank
node_systemexamples -.->|"includes example"| node_socialgraph
node_systemexamples -.->|"includes example"| node_crawler
node_systemexamples -.->|"includes example"| node_scaling
node_oodexamples -.->|"includes example"| node_callcenter
node_oodexamples -.->|"includes example"| node_cards
node_oodexamples -.->|"includes example"| node_parking
node_oodexamples -.->|"includes example"| node_chat

click node_primer "https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md"
click node_study "https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md"
click node_interview "https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md"
click node_systemquestions "https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md"
click node_oodquestions "https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md"
click node_systemexamples "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design"
click node_pastebin "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/pastebin"
click node_mint "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/mint"
click node_querycache "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/query_cache"
click node_salesrank "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/sales_rank"
click node_socialgraph "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/social_graph"
click node_crawler "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/web_crawler"
click node_scaling "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/scaling_aws"
click node_oodexamples "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design"
click node_callcenter "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/call_center"
click node_cards "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/deck_of_cards"
click node_parking "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/parking_lot"
click node_chat "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/online_chat"
click node_flashcards "https://github.com/apollostary/donnemartin-system-design-primer/tree/master/resources/flash_cards"

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_primer,node_study,node_interview,node_systemquestions,node_oodquestions toneBlue
class node_systemexamples,node_pastebin,node_mint,node_querycache,node_salesrank,node_socialgraph,node_crawler,node_scaling toneAmber
class node_oodexamples,node_callcenter,node_cards,node_parking,node_chat toneMint
class node_flashcards toneRose
class node_learner toneIndigo
```

## Components

### Learning materials

- [Primer topics](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md): `README.md`
- [Study guide](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md): `README.md`
- [Interview approach](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md): `README.md`
- [System interview questions](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md): `README.md`
- [Object design questions](https://github.com/apollostary/donnemartin-system-design-primer/blob/master/README.md): `README.md`

### System design examples

- [System design solutions](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design): `solutions/system_design`
- [Pastebin example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/pastebin): `solutions/system_design/pastebin`
- [Mint example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/mint): `solutions/system_design/mint`
- [Query cache example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/query_cache): `solutions/system_design/query_cache`
- [Sales rank example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/sales_rank): `solutions/system_design/sales_rank`
- [Social graph example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/social_graph): `solutions/system_design/social_graph`
- [Web crawler example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/web_crawler): `solutions/system_design/web_crawler`
- [AWS scaling example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/system_design/scaling_aws): `solutions/system_design/scaling_aws`

### Object design examples

- [Object design solutions](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design): `solutions/object_oriented_design`
- [Call center example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/call_center): `solutions/object_oriented_design/call_center`
- [Deck of cards example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/deck_of_cards): `solutions/object_oriented_design/deck_of_cards`
- [Parking lot example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/parking_lot): `solutions/object_oriented_design/parking_lot`
- [Online chat example](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/solutions/object_oriented_design/online_chat): `solutions/object_oriented_design/online_chat`

### Practice aids

- [Anki flashcard decks](https://github.com/apollostary/donnemartin-system-design-primer/tree/master/resources/flash_cards): `resources/flash_cards`

### Other components

- **Learner**

## Connections

- Learner → Primer topics: studies (evidence: `README.md`)
- Learner → Study guide: uses (evidence: `README.md`)
- Learner → Interview approach: learns approach (evidence: `README.md`)
- Learner → System interview questions: practices (evidence: `README.md`)
- Learner → Object design questions: practices (evidence: `README.md`)
- System interview questions → System design solutions: compares solutions (evidence: `README.md`)
- Object design questions → Object design solutions: compares solutions (evidence: `README.md`)
- Learner → Anki flashcard decks: reviews (evidence: `README.md`)
- System design solutions → Pastebin example: includes example
- System design solutions → Mint example: includes example
- System design solutions → Query cache example: includes example
- System design solutions → Sales rank example: includes example
- System design solutions → Social graph example: includes example
- System design solutions → Web crawler example: includes example
- System design solutions → AWS scaling example: includes example
- Object design solutions → Call center example: includes example
- Object design solutions → Deck of cards example: includes example
- Object design solutions → Parking lot example: includes example
- Object design solutions → Online chat example: includes example
