# hiteshchoudhary/chai-backend architecture

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

- Interactive diagram: https://gitdiagram.com/hiteshchoudhary/chai-backend
- Repository: https://github.com/hiteshchoudhary/chai-backend

## Overview

This is a Node/Express and MongoDB backend for a YouTube-like video hosting service. Its request flow is HTTP routing through authentication and upload middleware into domain controllers, which manipulate MongoDB models and return API responses. The README also identifies accounts, video publishing, likes, comments and replies, subscriptions, and related features. Several controllers are explicitly unfinished TODOs; those branches are preserved as documented capabilities, not presented as implemented workflows. Relationships are limited to wiring shown in excerpts or the source index.

Main entry points: [`src/routes`](https://github.com/hiteshchoudhary/chai-backend/tree/main/src/routes) (Domain routes), [`src/controllers/video.controller.js`](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/video.controller.js) (Video workflows), [`src/models/user.model.js`](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/user.model.js) (User model), [`src/app.js`](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/app.js) (Express app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["API and access"]
  node_app["Express app<br/>[app.js]"]
  node_user_routes["User routes<br/>[user.routes.js]"]
  node_video_routes["Video routes<br/>[video.routes.js]"]
  node_domain_routes["Domain routes"]
  node_auth["JWT auth<br/>[auth.middleware.js]"]
  node_uploads["Upload middleware"]
  node_response["API response helpers<br/>[ApiResponse.js]"]
end

subgraph group_accounts["Accounts"]
  node_users["Account workflows<br/>[user.controller.js]"]
end

subgraph group_media["Video and playlists"]
  node_videos["Video workflows"]
  node_playlists["Playlist workflows"]
end

subgraph group_engagement["Community features"]
  node_engagement["Comments, likes, tweets"]
  node_subscriptions["Subscription workflows"]
  node_dashboard["Dashboard workflows"]
end

subgraph group_data["Persistence and services"]
  node_user_model[("User model<br/>[user.model.js]")]
  node_video_model[("Video model<br/>[video.model.js]")]
  node_playlist_model[("Playlist model<br/>[playlist.model.js]")]
  node_engagement_models[("Engagement models")]
  node_subscription_model[("Subscription model")]
  node_cloudinary["Cloudinary upload<br/>[cloudinary.js]"]
  node_mongodb[("MongoDB")]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_user_routes
node_app -->|"mounts routes"| node_video_routes
node_app -->|"mounts routes"| node_domain_routes
node_user_routes -->|"guards routes"| node_auth
node_video_routes -->|"guards routes"| node_auth
node_user_routes -->|"accepts files"| node_uploads
node_video_routes -->|"accepts files"| node_uploads
node_user_routes -->|"dispatches"| node_users
node_video_routes -->|"dispatches"| node_videos
node_domain_routes -->|"dispatches"| node_engagement
node_domain_routes -->|"dispatches"| node_subscriptions
node_domain_routes -->|"dispatches"| node_playlists
node_domain_routes -->|"dispatches"| node_dashboard
node_auth -->|"loads user"| node_user_model
node_users -->|"reads and writes"| node_user_model
node_users -->|"uploads images"| node_cloudinary
node_videos -->|"uses model"| node_video_model
node_videos -->|"uses model"| node_user_model
node_videos -->|"uploads media"| node_cloudinary
node_playlists -->|"uses model"| node_playlist_model
node_subscriptions -->|"uses model"| node_subscription_model
node_subscriptions -->|"uses model"| node_user_model
node_engagement -->|"uses models"| node_engagement_models
node_dashboard -->|"queries model"| node_video_model
node_dashboard -->|"queries model"| node_subscription_model
node_dashboard -->|"queries model"| node_engagement_models
node_user_model -.->|"persists records"| node_mongodb
node_video_model -.->|"persists records"| node_mongodb
node_playlist_model -.->|"persists records"| node_mongodb
node_engagement_models -.->|"persists records"| node_mongodb
node_subscription_model -.->|"persists records"| node_mongodb
node_users -->|"returns JSON"| node_response
node_videos -->|"returns JSON"| node_response

click node_app "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/app.js"
click node_user_routes "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/routes/user.routes.js"
click node_video_routes "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/routes/video.routes.js"
click node_domain_routes "https://github.com/hiteshchoudhary/chai-backend/tree/main/src/routes"
click node_auth "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/middlewares/auth.middleware.js"
click node_uploads "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/middlewares/multer.middleware.js"
click node_users "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/user.controller.js"
click node_user_model "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/user.model.js"
click node_videos "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/video.controller.js"
click node_video_model "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/video.model.js"
click node_playlists "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/playlist.controller.js"
click node_playlist_model "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/playlist.model.js"
click node_engagement "https://github.com/hiteshchoudhary/chai-backend/tree/main/src/controllers"
click node_engagement_models "https://github.com/hiteshchoudhary/chai-backend/tree/main/src/models"
click node_subscriptions "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/subscription.controller.js"
click node_subscription_model "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/subscription.model.js"
click node_dashboard "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/dashboard.controller.js"
click node_cloudinary "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/utils/cloudinary.js"
click node_response "https://github.com/hiteshchoudhary/chai-backend/blob/main/src/utils/ApiResponse.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_user_routes,node_video_routes,node_domain_routes,node_auth,node_uploads,node_response,node_client toneBlue
class node_users toneAmber
class node_videos,node_playlists toneMint
class node_engagement,node_subscriptions,node_dashboard toneRose
class node_user_model,node_video_model,node_playlist_model,node_engagement_models,node_subscription_model,node_cloudinary,node_mongodb toneIndigo
```

## Components

### API and access

- [Express app](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/app.js): `src/app.js`
- [User routes](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/routes/user.routes.js): `src/routes/user.routes.js`
- [Video routes](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/routes/video.routes.js): `src/routes/video.routes.js`
- [Domain routes](https://github.com/hiteshchoudhary/chai-backend/tree/main/src/routes): `src/routes`
- [JWT auth](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [Upload middleware](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/middlewares/multer.middleware.js): `src/middlewares/multer.middleware.js`
- [API response helpers](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/utils/ApiResponse.js): `src/utils/ApiResponse.js`

### Accounts

- [Account workflows](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/user.controller.js): `src/controllers/user.controller.js`

### Video and playlists

- [Video workflows](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/video.controller.js): `src/controllers/video.controller.js`
- [Playlist workflows](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/playlist.controller.js): `src/controllers/playlist.controller.js`

### Community features

- [Comments, likes, tweets](https://github.com/hiteshchoudhary/chai-backend/tree/main/src/controllers): `src/controllers`
- [Subscription workflows](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/subscription.controller.js): `src/controllers/subscription.controller.js`
- [Dashboard workflows](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/controllers/dashboard.controller.js): `src/controllers/dashboard.controller.js`

### Persistence and services

- [User model](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/user.model.js): `src/models/user.model.js`
- [Video model](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/video.model.js): `src/models/video.model.js`
- [Playlist model](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/playlist.model.js): `src/models/playlist.model.js`
- [Engagement models](https://github.com/hiteshchoudhary/chai-backend/tree/main/src/models): `src/models`
- [Subscription model](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/models/subscription.model.js): `src/models/subscription.model.js`
- [Cloudinary upload](https://github.com/hiteshchoudhary/chai-backend/blob/main/src/utils/cloudinary.js): `src/utils/cloudinary.js`
- **MongoDB**

### Other components

- **HTTP client**

## Connections

- HTTP client → Express app: sends requests (evidence: `src/app.js`)
- Express app → User routes: mounts routes (evidence: `src/app.js`)
- Express app → Video routes: mounts routes (evidence: `src/app.js`)
- Express app → Domain routes: mounts routes (evidence: `src/app.js`)
- User routes → JWT auth: guards routes (evidence: `src/routes/user.routes.js`)
- Video routes → JWT auth: guards routes (evidence: `src/routes/video.routes.js`)
- User routes → Upload middleware: accepts files (evidence: `src/routes/user.routes.js`)
- Video routes → Upload middleware: accepts files (evidence: `src/routes/video.routes.js`)
- User routes → Account workflows: dispatches (evidence: `src/routes/user.routes.js`)
- Video routes → Video workflows: dispatches (evidence: `src/routes/video.routes.js`)
- Domain routes → Comments, likes, tweets: dispatches (evidence: `src/routes/comment.routes.js`)
- Domain routes → Subscription workflows: dispatches (evidence: `src/routes/subscription.routes.js`)
- Domain routes → Playlist workflows: dispatches (evidence: `src/routes/playlist.routes.js`)
- Domain routes → Dashboard workflows: dispatches (evidence: `src/routes/dashboard.routes.js`)
- JWT auth → User model: loads user (evidence: `src/middlewares/auth.middleware.js`)
- Account workflows → User model: reads and writes (evidence: `src/controllers/user.controller.js`)
- Account workflows → Cloudinary upload: uploads images (evidence: `src/controllers/user.controller.js`)
- Video workflows → Video model: uses model (evidence: `src/controllers/video.controller.js`)
- Video workflows → User model: uses model (evidence: `src/controllers/video.controller.js`)
- Video workflows → Cloudinary upload: uploads media (evidence: `src/controllers/video.controller.js`)
- Playlist workflows → Playlist model: uses model (evidence: `src/controllers/playlist.controller.js`)
- Subscription workflows → Subscription model: uses model (evidence: `src/controllers/subscription.controller.js`)
- Subscription workflows → User model: uses model (evidence: `src/controllers/subscription.controller.js`)
- Comments, likes, tweets → Engagement models: uses models (evidence: `src/controllers/comment.controller.js`)
- Dashboard workflows → Video model: queries model (evidence: `src/controllers/dashboard.controller.js`)
- Dashboard workflows → Subscription model: queries model (evidence: `src/controllers/dashboard.controller.js`)
- Dashboard workflows → Engagement models: queries model (evidence: `src/controllers/dashboard.controller.js`)
- User model → MongoDB: persists records
- Video model → MongoDB: persists records
- Playlist model → MongoDB: persists records
- Engagement models → MongoDB: persists records
- Subscription model → MongoDB: persists records
- Account workflows → API response helpers: returns JSON (evidence: `src/controllers/user.controller.js`)
- Video workflows → API response helpers: returns JSON (evidence: `src/controllers/video.controller.js`)
