# developerdiary/nodejs-lld-url-shortener architecture

> Architecture diagram of the GitHub repository developerdiary/nodejs-lld-url-shortener, 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/developerdiary/nodejs-lld-url-shortener
- Repository: https://github.com/developerdiary/nodejs-lld-url-shortener

## Overview

This is a layered URL-shortener API. A client submits a long URL or requests a short code; Express routes dispatch to a controller, which delegates shortening or resolution to the service. The service generates codes through an injected strategy, stores URL records and click counts through the repository, and uses Redis as a cache. MongoDB provides persistence. The README documents both Base62 and MD5 strategies and click tracking; the route wiring shown selects MD5. Edges reflect shown calls and wiring, with the documented database persistence link marked unverified.

Main entry points: [`src/routes/url.routes.js`](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/routes/url.routes.js) (URL routes), [`src/services/url.service.js`](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/services/url.service.js) (URL service), [`src/app.js`](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/app.js) (Express app), [`src/config/redis.js`](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/config/redis.js) (Redis client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP entry"]
  node_server["Server entry<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_routes["URL routes<br/>[url.routes.js]"]
  node_controller["URL controller<br/>[url.controller.js]"]
end

subgraph group_logic["Shortening logic"]
  node_service["URL service<br/>[url.service.js]"]
  node_md5["MD5 strategy<br/>[md5.strategy.js]"]
  node_base62["Base62 strategy<br/>[base62.strategy.js]"]
  node_strategy_contract["Strategy contract"]
end

subgraph group_data["Storage and cache"]
  node_repository["URL repository<br/>[url.repository.js]"]
  node_model["URL model<br/>[url.model.js]"]
  node_mongo_config["Mongo connection<br/>[mongo.js]"]
  node_mongodb[("MongoDB")]
  node_redis_config["Redis client<br/>[redis.js]"]
  node_redis[("Redis cache")]
end

node_client(("API client"))

node_server -->|"starts"| node_app
node_app -->|"mounts"| node_routes
node_client -->|"sends requests"| node_routes
node_routes -->|"dispatches"| node_controller
node_routes -->|"constructs"| node_service
node_routes -->|"selects"| node_md5
node_routes -.->|"offers alternative"| node_base62
node_controller -->|"delegates"| node_service
node_service -->|"uses injected strategy"| node_strategy_contract
node_md5 -->|"extends"| node_strategy_contract
node_base62 -->|"extends"| node_strategy_contract
node_service -->|"reads and writes"| node_repository
node_service -->|"gets and sets cache"| node_redis_config
node_repository -->|"queries"| node_model
node_model -.->|"persists records"| node_mongodb
node_app -->|"connects"| node_mongo_config
node_app -->|"connects"| node_redis_config
node_mongo_config -->|"opens connection"| node_mongodb
node_redis_config -->|"opens connection"| node_redis

click node_server "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/server.js"
click node_app "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/app.js"
click node_routes "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/routes/url.routes.js"
click node_controller "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/controllers/url.controller.js"
click node_service "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/services/url.service.js"
click node_md5 "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/md5.strategy.js"
click node_base62 "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/base62.strategy.js"
click node_strategy_contract "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/shortCode.strategy.js"
click node_repository "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/repositories/url.repository.js"
click node_model "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/models/url.model.js"
click node_mongo_config "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/config/mongo.js"
click node_redis_config "https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/config/redis.js"

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_server,node_app,node_routes,node_controller,node_client toneBlue
class node_service,node_md5,node_base62,node_strategy_contract toneAmber
class node_repository,node_model,node_mongo_config,node_mongodb,node_redis_config,node_redis toneMint
```

## Components

### HTTP entry

- [Server entry](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/server.js): `src/server.js`
- [Express app](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/app.js): `src/app.js`
- [URL routes](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/routes/url.routes.js): `src/routes/url.routes.js`
- [URL controller](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/controllers/url.controller.js): `src/controllers/url.controller.js`

### Shortening logic

- [URL service](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/services/url.service.js): `src/services/url.service.js`
- [MD5 strategy](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/md5.strategy.js): `src/strategies/md5.strategy.js`
- [Base62 strategy](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/base62.strategy.js): `src/strategies/base62.strategy.js`
- [Strategy contract](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/strategies/shortCode.strategy.js): `src/strategies/shortCode.strategy.js`

### Storage and cache

- [URL repository](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/repositories/url.repository.js): `src/repositories/url.repository.js`
- [URL model](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/models/url.model.js): `src/models/url.model.js`
- [Mongo connection](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/config/mongo.js): `src/config/mongo.js`
- **MongoDB**
- [Redis client](https://github.com/developerdiary/nodejs-lld-url-shortener/blob/main/src/config/redis.js): `src/config/redis.js`
- **Redis cache**

### Other components

- **API client**

## Connections

- Server entry → Express app: starts (evidence: `src/server.js`)
- Express app → URL routes: mounts (evidence: `src/app.js`)
- API client → URL routes: sends requests (evidence: `README.md`)
- URL routes → URL controller: dispatches (evidence: `src/routes/url.routes.js`)
- URL routes → URL service: constructs (evidence: `src/routes/url.routes.js`)
- URL routes → MD5 strategy: selects (evidence: `src/routes/url.routes.js`)
- URL routes → Base62 strategy: offers alternative (evidence: `src/routes/url.routes.js`)
- URL controller → URL service: delegates (evidence: `src/controllers/url.controller.js`)
- URL service → Strategy contract: uses injected strategy (evidence: `README.md`)
- MD5 strategy → Strategy contract: extends (evidence: `src/strategies/md5.strategy.js`)
- Base62 strategy → Strategy contract: extends (evidence: `src/strategies/base62.strategy.js`)
- URL service → URL repository: reads and writes (evidence: `src/services/url.service.js`)
- URL service → Redis client: gets and sets cache (evidence: `src/services/url.service.js`)
- URL repository → URL model: queries (evidence: `src/repositories/url.repository.js`)
- URL model → MongoDB: persists records (evidence: `README.md`)
- Express app → Mongo connection: connects (evidence: `src/app.js`)
- Express app → Redis client: connects (evidence: `src/app.js`)
- Mongo connection → MongoDB: opens connection (evidence: `src/config/mongo.js`)
- Redis client → Redis cache: opens connection (evidence: `src/config/redis.js`)
