# codernasim2023/urlify-bkend architecture

> Architecture diagram of the GitHub repository codernasim2023/urlify-bkend, 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/codernasim2023/urlify-bkend
- Repository: https://github.com/codernasim2023/urlify-bkend

## Overview

Urlify is an Express URL-shortening service. Clients create links (optionally with a custom slug, expiry, or authenticated ownership), receive a QR code, and later resolve links by redirect or API lookup; redirects check cache and storage, enforce expiry, and record analytics. Authentication and a user URL listing are additional product flows. The graph follows explicit route, call, and import evidence; several connections to unsampled modules are based only on the SOURCE INDEX, so unshown behavior is omitted.

Main entry points: [`app.js`](https://github.com/codernasim2023/urlify-bkend/blob/main/app.js) (Express app), [`src/controller/short_url.controller.js`](https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/short_url.controller.js) (Short URL controller), [`src/dao/user.dao.js`](https://github.com/codernasim2023/urlify-bkend/blob/main/src/dao/user.dao.js) (User DAO), [`src/controller/auth.controller.js`](https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/auth.controller.js) (Auth controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["Express app<br/>[app.js]"]
  node_short_routes["Short URL routes<br/>[short_url.route.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_user_routes["User routes<br/>[user.routes.js]"]
  node_auth_middleware["Auth middleware<br/>[auth.middleware.js]"]
end

subgraph group_domain["Product workflows"]
  node_short_controller["Short URL controller"]
  node_auth_controller["Auth controller<br/>[auth.controller.js]"]
  node_user_controller["User controller<br/>[user.controller.js]"]
  node_short_service["Short URL service"]
  node_auth_service["Auth service<br/>[auth.service.js]"]
  node_analytics["Click analytics<br/>[analytics.model.js]"]
end

subgraph group_persistence["Persistence"]
  node_short_dao["Short URL DAO<br/>[short_url.js]"]
  node_user_dao["User DAO<br/>[user.dao.js]"]
  node_short_model["Short URL model<br/>[short_url.model.js]"]
  node_user_model["User model<br/>[user.model.js]"]
  node_mongo_config["Mongo config<br/>[monogo.config.js]"]
  node_redis_config["Redis config<br/>[redis.config.js]"]
  node_redis[("Redis cache")]
end

subgraph group_platform["Runtime support"]
  node_attach_user["Attach user<br/>[attachUser.js]"]
  node_config["App config<br/>[config.js]"]
  node_helper["Token helpers<br/>[helper.js]"]
  node_errors["Error handling<br/>[errorHandler.js]"]
  node_logger["Logger<br/>[logger.js]"]
  node_async_wrapper["Async wrapper<br/>[tryCatchWrapper.js]"]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_short_routes
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_user_routes
node_app -->|"redirects via"| node_short_controller
node_app -->|"attaches user"| node_attach_user
node_app -->|"connects database"| node_mongo_config
node_app -->|"initializes cache"| node_redis_config
node_app -->|"handles errors"| node_errors
node_app -->|"logs runtime errors"| node_logger
node_short_routes -->|"dispatches requests"| node_short_controller
node_auth_routes -->|"dispatches requests"| node_auth_controller
node_auth_routes -->|"guards profile"| node_auth_middleware
node_user_routes -->|"dispatches requests"| node_user_controller
node_user_routes -->|"guards URL listing"| node_auth_middleware
node_short_controller -->|"creates links"| node_short_service
node_short_controller -->|"looks up links"| node_short_dao
node_short_controller -->|"reads and caches"| node_redis_config
node_short_controller -->|"records click data"| node_analytics
node_short_controller -->|"wraps handlers"| node_async_wrapper
node_auth_controller -->|"authenticates users"| node_auth_service
node_auth_controller -->|"uses cookie options"| node_config
node_auth_controller -->|"wraps handlers"| node_async_wrapper
node_user_controller -->|"loads user URLs"| node_user_dao
node_user_controller -->|"wraps handlers"| node_async_wrapper
node_short_service -->|"saves short links"| node_short_dao
node_short_service -->|"uses URL model"| node_short_model
node_short_service -->|"generates IDs"| node_helper
node_auth_service -->|"loads and creates users"| node_user_dao
node_auth_service -->|"signs tokens"| node_helper
node_auth_service -->|"raises auth errors"| node_errors
node_auth_middleware -->|"loads token user"| node_user_dao
node_auth_middleware -->|"verifies token"| node_helper
node_short_dao -->|"reads and writes"| node_short_model
node_short_dao -->|"raises conflicts"| node_errors
node_user_dao -->|"reads and writes"| node_user_model
node_user_dao -->|"loads owned URLs"| node_short_model
node_redis_config -.->|"configures connection"| node_redis

click node_app "https://github.com/codernasim2023/urlify-bkend/blob/main/app.js"
click node_short_routes "https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/short_url.route.js"
click node_auth_routes "https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/auth.routes.js"
click node_user_routes "https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/user.routes.js"
click node_short_controller "https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/short_url.controller.js"
click node_auth_controller "https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/auth.controller.js"
click node_user_controller "https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/user.controller.js"
click node_short_service "https://github.com/codernasim2023/urlify-bkend/blob/main/src/services/short_url.service.js"
click node_auth_service "https://github.com/codernasim2023/urlify-bkend/blob/main/src/services/auth.service.js"
click node_auth_middleware "https://github.com/codernasim2023/urlify-bkend/blob/main/src/middleware/auth.middleware.js"
click node_analytics "https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/analytics.model.js"
click node_short_dao "https://github.com/codernasim2023/urlify-bkend/blob/main/src/dao/short_url.js"
click node_user_dao "https://github.com/codernasim2023/urlify-bkend/blob/main/src/dao/user.dao.js"
click node_short_model "https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/short_url.model.js"
click node_user_model "https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/user.model.js"
click node_mongo_config "https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/monogo.config.js"
click node_redis_config "https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/redis.config.js"
click node_attach_user "https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/attachUser.js"
click node_config "https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/config.js"
click node_helper "https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/helper.js"
click node_errors "https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/errorHandler.js"
click node_logger "https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/logger.js"
click node_async_wrapper "https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/tryCatchWrapper.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_app,node_short_routes,node_auth_routes,node_user_routes,node_auth_middleware,node_client toneBlue
class node_short_controller,node_auth_controller,node_user_controller,node_short_service,node_auth_service,node_analytics toneAmber
class node_short_dao,node_user_dao,node_short_model,node_user_model,node_mongo_config,node_redis_config,node_redis toneMint
class node_attach_user,node_config,node_helper,node_errors,node_logger,node_async_wrapper toneRose
```

## Components

### HTTP API

- [Express app](https://github.com/codernasim2023/urlify-bkend/blob/main/app.js): `app.js`
- [Short URL routes](https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/short_url.route.js): `src/routes/short_url.route.js`
- [Auth routes](https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [User routes](https://github.com/codernasim2023/urlify-bkend/blob/main/src/routes/user.routes.js): `src/routes/user.routes.js`
- [Auth middleware](https://github.com/codernasim2023/urlify-bkend/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`

### Product workflows

- [Short URL controller](https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/short_url.controller.js): `src/controller/short_url.controller.js`
- [Auth controller](https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/auth.controller.js): `src/controller/auth.controller.js`
- [User controller](https://github.com/codernasim2023/urlify-bkend/blob/main/src/controller/user.controller.js): `src/controller/user.controller.js`
- [Short URL service](https://github.com/codernasim2023/urlify-bkend/blob/main/src/services/short_url.service.js): `src/services/short_url.service.js`
- [Auth service](https://github.com/codernasim2023/urlify-bkend/blob/main/src/services/auth.service.js): `src/services/auth.service.js`
- [Click analytics](https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/analytics.model.js): `src/models/analytics.model.js`

### Persistence

- [Short URL DAO](https://github.com/codernasim2023/urlify-bkend/blob/main/src/dao/short_url.js): `src/dao/short_url.js`
- [User DAO](https://github.com/codernasim2023/urlify-bkend/blob/main/src/dao/user.dao.js): `src/dao/user.dao.js`
- [Short URL model](https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/short_url.model.js): `src/models/short_url.model.js`
- [User model](https://github.com/codernasim2023/urlify-bkend/blob/main/src/models/user.model.js): `src/models/user.model.js`
- [Mongo config](https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/monogo.config.js): `src/config/monogo.config.js`
- [Redis config](https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/redis.config.js): `src/config/redis.config.js`
- **Redis cache**

### Runtime support

- [Attach user](https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/attachUser.js): `src/utils/attachUser.js`
- [App config](https://github.com/codernasim2023/urlify-bkend/blob/main/src/config/config.js): `src/config/config.js`
- [Token helpers](https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/helper.js): `src/utils/helper.js`
- [Error handling](https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/errorHandler.js): `src/utils/errorHandler.js`
- [Logger](https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/logger.js): `src/utils/logger.js`
- [Async wrapper](https://github.com/codernasim2023/urlify-bkend/blob/main/src/utils/tryCatchWrapper.js): `src/utils/tryCatchWrapper.js`

### Other components

- **HTTP client**

## Connections

- HTTP client → Express app: sends requests (evidence: `app.js`)
- Express app → Short URL routes: mounts routes (evidence: `app.js`)
- Express app → Auth routes: mounts routes (evidence: `app.js`)
- Express app → User routes: mounts routes (evidence: `app.js`)
- Express app → Short URL controller: redirects via (evidence: `app.js`)
- Express app → Attach user: attaches user (evidence: `app.js`)
- Express app → Mongo config: connects database (evidence: `app.js`)
- Express app → Redis config: initializes cache (evidence: `app.js`)
- Express app → Error handling: handles errors (evidence: `app.js`)
- Express app → Logger: logs runtime errors (evidence: `app.js`)
- Short URL routes → Short URL controller: dispatches requests (evidence: `src/routes/short_url.route.js`)
- Auth routes → Auth controller: dispatches requests (evidence: `src/routes/auth.routes.js`)
- Auth routes → Auth middleware: guards profile (evidence: `src/routes/auth.routes.js`)
- User routes → User controller: dispatches requests (evidence: `src/routes/user.routes.js`)
- User routes → Auth middleware: guards URL listing (evidence: `src/routes/user.routes.js`)
- Short URL controller → Short URL service: creates links (evidence: `src/controller/short_url.controller.js`)
- Short URL controller → Short URL DAO: looks up links (evidence: `src/controller/short_url.controller.js`)
- Short URL controller → Redis config: reads and caches (evidence: `src/controller/short_url.controller.js`)
- Short URL controller → Click analytics: records click data (evidence: `src/controller/short_url.controller.js`)
- Short URL controller → Async wrapper: wraps handlers (evidence: `src/controller/short_url.controller.js`)
- Auth controller → Auth service: authenticates users (evidence: `src/controller/auth.controller.js`)
- Auth controller → App config: uses cookie options (evidence: `src/controller/auth.controller.js`)
- Auth controller → Async wrapper: wraps handlers (evidence: `src/controller/auth.controller.js`)
- User controller → User DAO: loads user URLs (evidence: `src/controller/user.controller.js`)
- User controller → Async wrapper: wraps handlers (evidence: `src/controller/user.controller.js`)
- Short URL service → Short URL DAO: saves short links (evidence: `src/services/short_url.service.js`)
- Short URL service → Short URL model: uses URL model (evidence: `src/services/short_url.service.js`)
- Short URL service → Token helpers: generates IDs (evidence: `src/services/short_url.service.js`)
- Auth service → User DAO: loads and creates users (evidence: `src/services/auth.service.js`)
- Auth service → Token helpers: signs tokens (evidence: `src/services/auth.service.js`)
- Auth service → Error handling: raises auth errors (evidence: `src/services/auth.service.js`)
- Auth middleware → User DAO: loads token user (evidence: `src/middleware/auth.middleware.js`)
- Auth middleware → Token helpers: verifies token (evidence: `src/middleware/auth.middleware.js`)
- Short URL DAO → Short URL model: reads and writes (evidence: `src/dao/short_url.js`)
- Short URL DAO → Error handling: raises conflicts (evidence: `src/dao/short_url.js`)
- User DAO → User model: reads and writes (evidence: `src/dao/user.dao.js`)
- User DAO → Short URL model: loads owned URLs (evidence: `src/dao/user.dao.js`)
- Redis config → Redis cache: configures connection
