# xdankit/system-design-journey architecture

> Architecture diagram of the GitHub repository xdankit/system-design-journey, 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/xdankit/system-design-journey
- Repository: https://github.com/xdankit/system-design-journey

## Overview

This repository is a system-design learning collection, not one deployable application. Its vertical-versus-horizontal-scaling topic contains four TypeScript server variants—Node, Express, Fastify, and NestJS—and a Go example. The meaningful user-to-result flow is a client request handled by one of these illustrative servers; the tree shows product areas such as users, products, carts, and wishlists, but their wiring was not sampled. The README establishes the topic and its educational purpose. Server-to-client and infrastructure connections are left unverified because the excerpts do not show them.

Main entry points: [`season-1/2.vertical-vs-horizontal-scaling/servers/01-node/src`](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/01-node/src) (Node server), [`season-1/2.vertical-vs-horizontal-scaling/servers/02-express/src`](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/02-express/src) (Express server), [`season-1/2.vertical-vs-horizontal-scaling/servers/03-fastify/src`](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/03-fastify/src) (Fastify server), [`season-1/2.vertical-vs-horizontal-scaling/servers/04-nestjs/src`](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/04-nestjs/src) (NestJS server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ts["TypeScript variants"]
  node_node["Node server<br/>[src]"]
  node_express["Express server<br/>[src]"]
  node_fastify["Fastify server<br/>[src]"]
  node_nestjs["NestJS server<br/>[src]"]
end

subgraph group_go["Go example"]
  node_goexample["Go example<br/>[main.go]"]
end

node_client(("API client"))

node_client -.->|"sends requests"| node_node
node_client -.->|"sends requests"| node_express
node_client -.->|"sends requests"| node_fastify
node_client -.->|"sends requests"| node_nestjs
node_client -.->|"sends requests"| node_goexample

click node_node "https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/01-node/src"
click node_express "https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/02-express/src"
click node_fastify "https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/03-fastify/src"
click node_nestjs "https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/04-nestjs/src"
click node_goexample "https://github.com/xdankit/system-design-journey/blob/main/season-1/2.vertical-vs-horizontal-scaling/servers/05-go/main.go"

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_node,node_express,node_fastify,node_nestjs,node_client toneBlue
class node_goexample toneAmber
```

## Components

### TypeScript variants

- [Node server](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/01-node/src): `season-1/2.vertical-vs-horizontal-scaling/servers/01-node/src`
- [Express server](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/02-express/src): `season-1/2.vertical-vs-horizontal-scaling/servers/02-express/src`
- [Fastify server](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/03-fastify/src): `season-1/2.vertical-vs-horizontal-scaling/servers/03-fastify/src`
- [NestJS server](https://github.com/xdankit/system-design-journey/tree/main/season-1/2.vertical-vs-horizontal-scaling/servers/04-nestjs/src): `season-1/2.vertical-vs-horizontal-scaling/servers/04-nestjs/src`

### Go example

- [Go example](https://github.com/xdankit/system-design-journey/blob/main/season-1/2.vertical-vs-horizontal-scaling/servers/05-go/main.go): `season-1/2.vertical-vs-horizontal-scaling/servers/05-go/main.go`

### Other components

- **API client**

## Connections

- API client → Node server: sends requests
- API client → Express server: sends requests
- API client → Fastify server: sends requests
- API client → NestJS server: sends requests
- API client → Go example: sends requests
