# vedanttttt05/media-service-backend architecture

> Architecture diagram of the GitHub repository vedanttttt05/media-service-backend, 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/vedanttttt05/media-service-backend
- Repository: https://github.com/vedanttttt05/media-service-backend

## Overview

Media Service is a video-sharing application with a React client and an Express/MongoDB API. The principal workflow is authenticated browsing and viewing, with video publishing and account management alongside comments, likes, playlists, subscriptions, and watch history. The client routes users through those experiences and sends API requests; the backend routes requests to domain controllers, which operate on MongoDB models and use Cloudinary for media uploads. Some frontend-to-API calls and unsampled feature internals are not visible in the excerpts, so those links are marked unverified.

Main entry points: [`src/controllers/video.controller.ts`](https://github.com/vedanttttt05/media-service-backend/blob/main/src/controllers/video.controller.ts) (Video operations), [`frontend/src/main.tsx`](https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/main.tsx) (Client router), [`src/app.ts`](https://github.com/vedanttttt05/media-service-backend/blob/main/src/app.ts) (Express app), [`src/routes/user.routes.ts`](https://github.com/vedanttttt05/media-service-backend/blob/main/src/routes/user.routes.ts) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["Client router<br/>[main.tsx]"]
  node_authui["Auth pages<br/>[AuthPages.tsx]"]
  node_clientauth["Session state<br/>[AuthContext.tsx]"]
  node_clientapi["API client<br/>[client.ts]"]
  node_clientfeatures["Media screens"]
end

subgraph group_api["API and identity"]
  node_express["Express app<br/>[app.ts]"]
  node_userroute["User routes<br/>[user.routes.ts]"]
  node_videoroute["Video routes<br/>[video.routes.ts]"]
  node_socialroutes["Social routes"]
  node_userctrl["Account operations<br/>[user.controller.ts]"]
  node_authmw["JWT verification<br/>[auth.middleware.ts]"]
  node_uploadmw["Multipart uploads"]
end

subgraph group_content["Media and social"]
  node_videoctrl["Video operations"]
  node_socialctrl["Social operations"]
end

subgraph group_persistence["Persistence and media"]
  node_users[("User records<br/>[user.model.ts]")]
  node_videos[("Video records<br/>[video.model.ts]")]
  node_socialmodels[("Social records")]
  node_cloudinary["Media storage<br/>[cloudinary.ts]"]
end

node_viewer(("Viewer"))
node_mongodb[("MongoDB")]
node_cloudinaryservice["Cloudinary"]

node_viewer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_authui
node_webapp -->|"routes to"| node_clientfeatures
node_webapp -->|"provides session"| node_clientauth
node_authui -->|"submits requests"| node_clientapi
node_clientauth -->|"uses"| node_clientapi
node_clientfeatures -.->|"requests data"| node_clientapi
node_clientapi -.->|"calls API"| node_express
node_express -->|"mounts"| node_userroute
node_express -->|"mounts"| node_videoroute
node_express -->|"mounts"| node_socialroutes
node_userroute -->|"dispatches"| node_userctrl
node_videoroute -->|"dispatches"| node_videoctrl
node_userroute -->|"guards routes"| node_authmw
node_videoroute -->|"guards routes"| node_authmw
node_userroute -->|"handles uploads"| node_uploadmw
node_videoroute -->|"handles uploads"| node_uploadmw
node_socialroutes -->|"dispatches"| node_socialctrl
node_authmw -->|"loads user"| node_users
node_userctrl -->|"reads and writes"| node_users
node_videoctrl -->|"reads and writes"| node_videos
node_videoctrl -->|"updates history"| node_users
node_videoctrl -->|"checks likes"| node_socialmodels
node_socialctrl -->|"uses models"| node_socialmodels
node_userctrl -->|"uploads images"| node_cloudinary
node_videoctrl -->|"uploads media"| node_cloudinary
node_cloudinary -->|"stores media"| node_cloudinaryservice
node_users -->|"persists in"| node_mongodb
node_videos -->|"persists in"| node_mongodb
node_socialmodels -->|"persists in"| node_mongodb

click node_webapp "https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/main.tsx"
click node_authui "https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/pages/AuthPages.tsx"
click node_clientauth "https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/auth/AuthContext.tsx"
click node_clientapi "https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/api/client.ts"
click node_clientfeatures "https://github.com/vedanttttt05/media-service-backend/tree/main/frontend/src/pages"
click node_express "https://github.com/vedanttttt05/media-service-backend/blob/main/src/app.ts"
click node_userroute "https://github.com/vedanttttt05/media-service-backend/blob/main/src/routes/user.routes.ts"
click node_videoroute "https://github.com/vedanttttt05/media-service-backend/blob/main/src/routes/video.routes.ts"
click node_socialroutes "https://github.com/vedanttttt05/media-service-backend/tree/main/src/routes"
click node_userctrl "https://github.com/vedanttttt05/media-service-backend/blob/main/src/controllers/user.controller.ts"
click node_videoctrl "https://github.com/vedanttttt05/media-service-backend/blob/main/src/controllers/video.controller.ts"
click node_socialctrl "https://github.com/vedanttttt05/media-service-backend/tree/main/src/controllers"
click node_authmw "https://github.com/vedanttttt05/media-service-backend/blob/main/src/middlewares/auth.middleware.ts"
click node_uploadmw "https://github.com/vedanttttt05/media-service-backend/blob/main/src/middlewares/multer.middleware.ts"
click node_users "https://github.com/vedanttttt05/media-service-backend/blob/main/src/models/user.model.ts"
click node_videos "https://github.com/vedanttttt05/media-service-backend/blob/main/src/models/video.model.ts"
click node_socialmodels "https://github.com/vedanttttt05/media-service-backend/tree/main/src/models"
click node_cloudinary "https://github.com/vedanttttt05/media-service-backend/blob/main/src/utils/cloudinary.ts"

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_webapp,node_authui,node_clientauth,node_clientapi,node_clientfeatures,node_viewer toneBlue
class node_express,node_userroute,node_videoroute,node_socialroutes,node_userctrl,node_authmw,node_uploadmw,node_mongodb toneAmber
class node_videoctrl,node_socialctrl toneMint
class node_users,node_videos,node_socialmodels,node_cloudinary toneRose
class node_cloudinaryservice toneIndigo
```

## Components

### Web client

- [Client router](https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Auth pages](https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/pages/AuthPages.tsx): `frontend/src/pages/AuthPages.tsx`
- [Session state](https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/auth/AuthContext.tsx): `frontend/src/auth/AuthContext.tsx`
- [API client](https://github.com/vedanttttt05/media-service-backend/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Media screens](https://github.com/vedanttttt05/media-service-backend/tree/main/frontend/src/pages): `frontend/src/pages`

### API and identity

- [Express app](https://github.com/vedanttttt05/media-service-backend/blob/main/src/app.ts): `src/app.ts`
- [User routes](https://github.com/vedanttttt05/media-service-backend/blob/main/src/routes/user.routes.ts): `src/routes/user.routes.ts`
- [Video routes](https://github.com/vedanttttt05/media-service-backend/blob/main/src/routes/video.routes.ts): `src/routes/video.routes.ts`
- [Social routes](https://github.com/vedanttttt05/media-service-backend/tree/main/src/routes): `src/routes`
- [Account operations](https://github.com/vedanttttt05/media-service-backend/blob/main/src/controllers/user.controller.ts): `src/controllers/user.controller.ts`
- [JWT verification](https://github.com/vedanttttt05/media-service-backend/blob/main/src/middlewares/auth.middleware.ts): `src/middlewares/auth.middleware.ts`
- [Multipart uploads](https://github.com/vedanttttt05/media-service-backend/blob/main/src/middlewares/multer.middleware.ts): `src/middlewares/multer.middleware.ts`

### Media and social

- [Video operations](https://github.com/vedanttttt05/media-service-backend/blob/main/src/controllers/video.controller.ts): `src/controllers/video.controller.ts`
- [Social operations](https://github.com/vedanttttt05/media-service-backend/tree/main/src/controllers): `src/controllers`

### Persistence and media

- [User records](https://github.com/vedanttttt05/media-service-backend/blob/main/src/models/user.model.ts): `src/models/user.model.ts`
- [Video records](https://github.com/vedanttttt05/media-service-backend/blob/main/src/models/video.model.ts): `src/models/video.model.ts`
- [Social records](https://github.com/vedanttttt05/media-service-backend/tree/main/src/models): `src/models`
- [Media storage](https://github.com/vedanttttt05/media-service-backend/blob/main/src/utils/cloudinary.ts): `src/utils/cloudinary.ts`

### Other components

- **Viewer**
- **MongoDB**
- **Cloudinary**

## Connections

- Viewer → Client router: uses (evidence: `frontend/src/main.tsx`)
- Client router → Auth pages: routes to (evidence: `frontend/src/main.tsx`)
- Client router → Media screens: routes to (evidence: `frontend/src/main.tsx`)
- Client router → Session state: provides session (evidence: `frontend/src/main.tsx`)
- Auth pages → API client: submits requests (evidence: `frontend/src/pages/AuthPages.tsx`)
- Session state → API client: uses (evidence: `frontend/src/auth/AuthContext.tsx`)
- Media screens → API client: requests data (evidence: `frontend/src/pages/AuthPages.tsx`)
- API client → Express app: calls API
- Express app → User routes: mounts (evidence: `src/app.ts`)
- Express app → Video routes: mounts (evidence: `src/app.ts`)
- Express app → Social routes: mounts (evidence: `src/app.ts`)
- User routes → Account operations: dispatches (evidence: `src/routes/user.routes.ts`)
- Video routes → Video operations: dispatches (evidence: `src/routes/video.routes.ts`)
- User routes → JWT verification: guards routes (evidence: `src/routes/user.routes.ts`)
- Video routes → JWT verification: guards routes (evidence: `src/routes/video.routes.ts`)
- User routes → Multipart uploads: handles uploads (evidence: `src/routes/user.routes.ts`)
- Video routes → Multipart uploads: handles uploads (evidence: `src/routes/video.routes.ts`)
- Social routes → Social operations: dispatches (evidence: `src/routes/user.routes.ts`)
- JWT verification → User records: loads user (evidence: `src/middlewares/auth.middleware.ts`)
- Account operations → User records: reads and writes (evidence: `src/controllers/user.controller.ts`)
- Video operations → Video records: reads and writes (evidence: `src/controllers/video.controller.ts`)
- Video operations → User records: updates history (evidence: `src/controllers/video.controller.ts`)
- Video operations → Social records: checks likes (evidence: `src/controllers/video.controller.ts`)
- Social operations → Social records: uses models (evidence: `src/controllers/comment.controller.ts`)
- Account operations → Media storage: uploads images (evidence: `src/controllers/user.controller.ts`)
- Video operations → Media storage: uploads media (evidence: `src/controllers/video.controller.ts`)
- Media storage → Cloudinary: stores media
- User records → MongoDB: persists in
- Video records → MongoDB: persists in
- Social records → MongoDB: persists in
