# subhojit0012/youtube-backend architecture

> Architecture diagram of the GitHub repository subhojit0012/youtube-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/subhojit0012/youtube-backend
- Repository: https://github.com/subhojit0012/youtube-backend

## Overview

This is a TypeScript tRPC backend for a YouTube-like sharing service. Requests enter through Express, receive a token-aware context, and are dispatched through merged user, video, playlist, and history routers to service logic or Mongoose models. The principal workflows cover authentication and account operations, video management, playlist updates, and watch history. MongoDB connection/bootstrap and JWT context are included; the README documents upload and account capabilities, though implementation details are not uniformly shown in the excerpts.

Main entry points: [`src/db/models/user.model.ts`](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/user.model.ts) (User model), [`src/router/_app.router.ts`](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/_app.router.ts) (Router registry), [`src/index.ts`](https://github.com/subhojit0012/youtube-backend/blob/main/src/index.ts) (Express bootstrap), [`src/db/models/playlist.model.ts`](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/playlist.model.ts) (Playlist model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP and tRPC"]
  node_server["Express bootstrap<br/>[index.ts]"]
  node_app_router["Router registry<br/>[_app.router.ts]"]
end

subgraph group_identity["Identity and context"]
  node_context["tRPC context and auth<br/>[context.utility.ts]"]
  node_tokens["JWT utilities<br/>[token.utility.ts]"]
end

subgraph group_features["Product workflows"]
  node_user_routes["User routes<br/>[user.route.ts]"]
  node_video_routes["Video routes<br/>[video.route.ts]"]
  node_playlist_routes["Playlist routes<br/>[playlist.route.ts]"]
  node_history_routes["History routes<br/>[history.route.ts]"]
  node_user_service["Account operations<br/>[user.service.ts]"]
  node_video_service["Video operations<br/>[video.service.ts]"]
  node_history_service["Watch history<br/>[history.service.ts]"]
  node_playlist_service["Playlist service"]
end

subgraph group_data["MongoDB persistence"]
  node_mongo_connect["MongoDB connection<br/>[connect.db.ts]"]
  node_user_model[("User model<br/>[user.model.ts]")]
  node_video_model[("Video model<br/>[video.model.ts]")]
  node_playlist_model[("Playlist model<br/>[playlist.model.ts]")]
  node_history_model[("History model<br/>[history.model.ts]")]
  node_channel_model[("Channel model<br/>[channel.model.ts]")]
  node_comment_model[("Comment model<br/>[comment.model.ts]")]
  node_subscribe_model[("Subscription model<br/>[subscribe.model.ts]")]
end

node_client(("API client"))
node_mongodb[("MongoDB")]

node_client -->|"sends requests"| node_server
node_server -->|"mounts tRPC"| node_app_router
node_server -->|"creates context"| node_context
node_server -->|"connects database"| node_mongo_connect
node_app_router -->|"merges routes"| node_user_routes
node_app_router -->|"merges routes"| node_video_routes
node_app_router -->|"merges routes"| node_playlist_routes
node_app_router -->|"merges routes"| node_history_routes
node_context -->|"decodes tokens"| node_tokens
node_user_routes -->|"calls operations"| node_user_service
node_user_routes -->|"reads profile"| node_user_model
node_video_routes -->|"calls operations"| node_video_service
node_playlist_routes -->|"reads and writes"| node_playlist_model
node_history_routes -->|"calls operations"| node_history_service
node_user_service -->|"reads and writes"| node_user_model
node_video_service -->|"reads and writes"| node_video_model
node_history_service -->|"reads and writes"| node_history_model
node_playlist_model -->|"references videos"| node_video_model
node_playlist_model -->|"references owner"| node_user_model
node_user_model -->|"references channel"| node_channel_model
node_user_model -->|"references history"| node_history_model
node_user_model -->|"references playlists"| node_playlist_model
node_user_model -->|"references videos"| node_video_model
node_user_model -->|"references subscriptions"| node_subscribe_model
node_mongo_connect -->|"opens connection"| node_mongodb

click node_server "https://github.com/subhojit0012/youtube-backend/blob/main/src/index.ts"
click node_app_router "https://github.com/subhojit0012/youtube-backend/blob/main/src/router/_app.router.ts"
click node_user_routes "https://github.com/subhojit0012/youtube-backend/blob/main/src/router/user.route.ts"
click node_video_routes "https://github.com/subhojit0012/youtube-backend/blob/main/src/router/video.route.ts"
click node_playlist_routes "https://github.com/subhojit0012/youtube-backend/blob/main/src/router/playlist.route.ts"
click node_history_routes "https://github.com/subhojit0012/youtube-backend/blob/main/src/router/history.route.ts"
click node_context "https://github.com/subhojit0012/youtube-backend/blob/main/src/utility/context.utility.ts"
click node_tokens "https://github.com/subhojit0012/youtube-backend/blob/main/src/utility/token.utility.ts"
click node_user_service "https://github.com/subhojit0012/youtube-backend/blob/main/src/service/user.service.ts"
click node_video_service "https://github.com/subhojit0012/youtube-backend/blob/main/src/service/video.service.ts"
click node_history_service "https://github.com/subhojit0012/youtube-backend/blob/main/src/service/history.service.ts"
click node_playlist_service "https://github.com/subhojit0012/youtube-backend/blob/main/src/service/playlist.service.ts"
click node_mongo_connect "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/connect.db.ts"
click node_user_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/user.model.ts"
click node_video_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/video.model.ts"
click node_playlist_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/playlist.model.ts"
click node_history_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/history.model.ts"
click node_channel_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/channel.model.ts"
click node_comment_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/comment.model.ts"
click node_subscribe_model "https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/subscribe.model.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_server,node_app_router,node_client toneBlue
class node_context,node_tokens,node_mongodb toneAmber
class node_user_routes,node_video_routes,node_playlist_routes,node_history_routes,node_user_service,node_video_service,node_history_service,node_playlist_service toneMint
class node_mongo_connect,node_user_model,node_video_model,node_playlist_model,node_history_model,node_channel_model,node_comment_model,node_subscribe_model toneRose
```

## Components

### HTTP and tRPC

- [Express bootstrap](https://github.com/subhojit0012/youtube-backend/blob/main/src/index.ts): `src/index.ts`
- [Router registry](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/_app.router.ts): `src/router/_app.router.ts`

### Identity and context

- [tRPC context and auth](https://github.com/subhojit0012/youtube-backend/blob/main/src/utility/context.utility.ts): `src/utility/context.utility.ts`
- [JWT utilities](https://github.com/subhojit0012/youtube-backend/blob/main/src/utility/token.utility.ts): `src/utility/token.utility.ts`

### Product workflows

- [User routes](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/user.route.ts): `src/router/user.route.ts`
- [Video routes](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/video.route.ts): `src/router/video.route.ts`
- [Playlist routes](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/playlist.route.ts): `src/router/playlist.route.ts`
- [History routes](https://github.com/subhojit0012/youtube-backend/blob/main/src/router/history.route.ts): `src/router/history.route.ts`
- [Account operations](https://github.com/subhojit0012/youtube-backend/blob/main/src/service/user.service.ts): `src/service/user.service.ts`
- [Video operations](https://github.com/subhojit0012/youtube-backend/blob/main/src/service/video.service.ts): `src/service/video.service.ts`
- [Watch history](https://github.com/subhojit0012/youtube-backend/blob/main/src/service/history.service.ts): `src/service/history.service.ts`
- [Playlist service](https://github.com/subhojit0012/youtube-backend/blob/main/src/service/playlist.service.ts): `src/service/playlist.service.ts`

### MongoDB persistence

- [MongoDB connection](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/connect.db.ts): `src/db/connect.db.ts`
- [User model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/user.model.ts): `src/db/models/user.model.ts`
- [Video model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/video.model.ts): `src/db/models/video.model.ts`
- [Playlist model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/playlist.model.ts): `src/db/models/playlist.model.ts`
- [History model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/history.model.ts): `src/db/models/history.model.ts`
- [Channel model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/channel.model.ts): `src/db/models/channel.model.ts`
- [Comment model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/comment.model.ts): `src/db/models/comment.model.ts`
- [Subscription model](https://github.com/subhojit0012/youtube-backend/blob/main/src/db/models/subscribe.model.ts): `src/db/models/subscribe.model.ts`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Express bootstrap: sends requests (evidence: `README.md`)
- Express bootstrap → Router registry: mounts tRPC (evidence: `src/index.ts`)
- Express bootstrap → tRPC context and auth: creates context (evidence: `src/index.ts`)
- Express bootstrap → MongoDB connection: connects database (evidence: `src/index.ts`)
- Router registry → User routes: merges routes (evidence: `src/router/_app.router.ts`)
- Router registry → Video routes: merges routes (evidence: `src/router/_app.router.ts`)
- Router registry → Playlist routes: merges routes (evidence: `src/router/_app.router.ts`)
- Router registry → History routes: merges routes (evidence: `src/router/_app.router.ts`)
- tRPC context and auth → JWT utilities: decodes tokens (evidence: `src/utility/context.utility.ts`)
- User routes → Account operations: calls operations (evidence: `src/router/user.route.ts`)
- User routes → User model: reads profile (evidence: `src/router/user.route.ts`)
- Video routes → Video operations: calls operations (evidence: `src/router/video.route.ts`)
- Playlist routes → Playlist model: reads and writes (evidence: `src/router/playlist.route.ts`)
- History routes → Watch history: calls operations (evidence: `src/router/history.route.ts`)
- Account operations → User model: reads and writes (evidence: `src/service/user.service.ts`)
- Video operations → Video model: reads and writes (evidence: `src/service/video.service.ts`)
- Watch history → History model: reads and writes (evidence: `src/service/history.service.ts`)
- Playlist model → Video model: references videos (evidence: `src/db/models/playlist.model.ts`)
- Playlist model → User model: references owner (evidence: `src/db/models/playlist.model.ts`)
- User model → Channel model: references channel (evidence: `src/db/models/user.model.ts`)
- User model → History model: references history (evidence: `src/db/models/user.model.ts`)
- User model → Playlist model: references playlists (evidence: `src/db/models/user.model.ts`)
- User model → Video model: references videos (evidence: `src/db/models/user.model.ts`)
- User model → Subscription model: references subscriptions (evidence: `src/db/models/user.model.ts`)
- MongoDB connection → MongoDB: opens connection (evidence: `src/db/connect.db.ts`)
