# voitau/system-design-primer architecture

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

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

## Overview

The System Design Primer is a learning and interview-preparation repository, not a running application. Its principal workflow is for a learner to study system-design concepts, practice interview questions, and compare their work with sample discussions, code, and diagrams. It also offers object-oriented design practice and Anki flashcards. The README documents these capabilities; the graph shows those learning paths and the sampled solution examples, without implying calls between independent examples. Source excerpts are illustrative and do not establish wiring among them.

Main entry points: [`README.md`](https://github.com/voitau/system-design-primer/blob/master/README.md) (System Questions), [`solutions/system_design/mint`](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/mint) (Mint Design), [`solutions/system_design/pastebin`](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/pastebin) (Pastebin Design), [`solutions/system_design/query_cache`](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/query_cache) (Query Cache Design)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning Material"]
  node_primer["Concept Guide<br/>[README.md]"]
  node_system_questions["System Questions<br/>[README.md]"]
  node_ood_questions["Object Design Questions<br/>[README.md]"]
end

subgraph group_system["System Design Examples"]
  node_mint["Mint Design"]
  node_mint_mapreduce["Spending Aggregation<br/>[mint_mapreduce.py]"]
  node_pastebin["Pastebin Design"]
  node_pastebin_code["Hit Counts<br/>[pastebin.py]"]
  node_query_cache["Query Cache Design"]
  node_query_cache_code["Query Cache Snippets"]
  node_sales_rank["Sales Rank Design"]
  node_sales_rank_code["Sales Ranking"]
  node_social_graph["Social Graph Design"]
  node_social_graph_code["Graph Search"]
  node_web_crawler["Crawler Design"]
  node_crawler_code["Crawler Snippets"]
end

subgraph group_ood["Object Design Examples"]
  node_call_center["Call Center<br/>[call_center.py]"]
  node_deck["Deck of Cards<br/>[deck_of_cards.py]"]
  node_hash_table["Hash Table<br/>[hash_map.py]"]
  node_lru_cache["LRU Cache<br/>[lru_cache.py]"]
  node_online_chat["Online Chat<br/>[online_chat.py]"]
  node_parking_lot["Parking Lot<br/>[parking_lot.py]"]
end

subgraph group_aids["Study Aids"]
  node_flashcards["Anki Decks"]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_primer
node_learner -->|"practices"| node_system_questions
node_learner -->|"practices"| node_ood_questions
node_learner -->|"reviews"| node_flashcards
node_system_questions -->|"compares solutions"| node_mint
node_system_questions -->|"compares solutions"| node_pastebin
node_system_questions -->|"compares solutions"| node_query_cache
node_system_questions -->|"compares solutions"| node_sales_rank
node_system_questions -->|"compares solutions"| node_social_graph
node_system_questions -->|"compares solutions"| node_web_crawler
node_ood_questions -->|"compares solutions"| node_call_center
node_ood_questions -->|"compares solutions"| node_deck
node_ood_questions -->|"compares solutions"| node_hash_table
node_ood_questions -->|"compares solutions"| node_lru_cache
node_ood_questions -->|"compares solutions"| node_online_chat
node_ood_questions -->|"compares solutions"| node_parking_lot

click node_primer "https://github.com/voitau/system-design-primer/blob/master/README.md"
click node_system_questions "https://github.com/voitau/system-design-primer/blob/master/README.md"
click node_ood_questions "https://github.com/voitau/system-design-primer/blob/master/README.md"
click node_mint "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/mint"
click node_mint_mapreduce "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/mint/mint_mapreduce.py"
click node_pastebin "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/pastebin"
click node_pastebin_code "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/pastebin/pastebin.py"
click node_query_cache "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/query_cache"
click node_query_cache_code "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/query_cache/query_cache_snippets.py"
click node_sales_rank "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/sales_rank"
click node_sales_rank_code "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/sales_rank/sales_rank_mapreduce.py"
click node_social_graph "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/social_graph"
click node_social_graph_code "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/social_graph/social_graph_snippets.py"
click node_web_crawler "https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/web_crawler"
click node_crawler_code "https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/web_crawler/web_crawler_snippets.py"
click node_call_center "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/call_center/call_center.py"
click node_deck "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/deck_of_cards/deck_of_cards.py"
click node_hash_table "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/hash_table/hash_map.py"
click node_lru_cache "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/lru_cache/lru_cache.py"
click node_online_chat "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/online_chat/online_chat.py"
click node_parking_lot "https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/parking_lot/parking_lot.py"
click node_flashcards "https://github.com/voitau/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_system_questions,node_ood_questions toneBlue
class node_mint,node_mint_mapreduce,node_pastebin,node_pastebin_code,node_query_cache,node_query_cache_code,node_sales_rank,node_sales_rank_code,node_social_graph,node_social_graph_code,node_web_crawler,node_crawler_code toneAmber
class node_call_center,node_deck,node_hash_table,node_lru_cache,node_online_chat,node_parking_lot toneMint
class node_flashcards toneRose
class node_learner toneIndigo
```

## Components

### Learning Material

- [Concept Guide](https://github.com/voitau/system-design-primer/blob/master/README.md): `README.md`
- [System Questions](https://github.com/voitau/system-design-primer/blob/master/README.md): `README.md`
- [Object Design Questions](https://github.com/voitau/system-design-primer/blob/master/README.md): `README.md`

### System Design Examples

- [Mint Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/mint): `solutions/system_design/mint`
- [Spending Aggregation](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/mint/mint_mapreduce.py): `solutions/system_design/mint/mint_mapreduce.py`
- [Pastebin Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/pastebin): `solutions/system_design/pastebin`
- [Hit Counts](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/pastebin/pastebin.py): `solutions/system_design/pastebin/pastebin.py`
- [Query Cache Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/query_cache): `solutions/system_design/query_cache`
- [Query Cache Snippets](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/query_cache/query_cache_snippets.py): `solutions/system_design/query_cache/query_cache_snippets.py`
- [Sales Rank Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/sales_rank): `solutions/system_design/sales_rank`
- [Sales Ranking](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/sales_rank/sales_rank_mapreduce.py): `solutions/system_design/sales_rank/sales_rank_mapreduce.py`
- [Social Graph Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/social_graph): `solutions/system_design/social_graph`
- [Graph Search](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/social_graph/social_graph_snippets.py): `solutions/system_design/social_graph/social_graph_snippets.py`
- [Crawler Design](https://github.com/voitau/system-design-primer/tree/master/solutions/system_design/web_crawler): `solutions/system_design/web_crawler`
- [Crawler Snippets](https://github.com/voitau/system-design-primer/blob/master/solutions/system_design/web_crawler/web_crawler_snippets.py): `solutions/system_design/web_crawler/web_crawler_snippets.py`

### Object Design Examples

- [Call Center](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/call_center/call_center.py): `solutions/object_oriented_design/call_center/call_center.py`
- [Deck of Cards](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/deck_of_cards/deck_of_cards.py): `solutions/object_oriented_design/deck_of_cards/deck_of_cards.py`
- [Hash Table](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/hash_table/hash_map.py): `solutions/object_oriented_design/hash_table/hash_map.py`
- [LRU Cache](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/lru_cache/lru_cache.py): `solutions/object_oriented_design/lru_cache/lru_cache.py`
- [Online Chat](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/online_chat/online_chat.py): `solutions/object_oriented_design/online_chat/online_chat.py`
- [Parking Lot](https://github.com/voitau/system-design-primer/blob/master/solutions/object_oriented_design/parking_lot/parking_lot.py): `solutions/object_oriented_design/parking_lot/parking_lot.py`

### Study Aids

- [Anki Decks](https://github.com/voitau/system-design-primer/tree/master/resources/flash_cards): `resources/flash_cards`

### Other components

- **Learner**

## Connections

- Learner → Concept Guide: studies (evidence: `README.md`)
- Learner → System Questions: practices (evidence: `README.md`)
- Learner → Object Design Questions: practices (evidence: `README.md`)
- Learner → Anki Decks: reviews (evidence: `README.md`)
- System Questions → Mint Design: compares solutions (evidence: `README.md`)
- System Questions → Pastebin Design: compares solutions (evidence: `README.md`)
- System Questions → Query Cache Design: compares solutions (evidence: `README.md`)
- System Questions → Sales Rank Design: compares solutions (evidence: `README.md`)
- System Questions → Social Graph Design: compares solutions (evidence: `README.md`)
- System Questions → Crawler Design: compares solutions (evidence: `README.md`)
- Object Design Questions → Call Center: compares solutions (evidence: `README.md`)
- Object Design Questions → Deck of Cards: compares solutions (evidence: `README.md`)
- Object Design Questions → Hash Table: compares solutions (evidence: `README.md`)
- Object Design Questions → LRU Cache: compares solutions (evidence: `README.md`)
- Object Design Questions → Online Chat: compares solutions (evidence: `README.md`)
- Object Design Questions → Parking Lot: compares solutions (evidence: `README.md`)
