# kishanwebdev/youtube-backend architecture

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

- Interactive diagram: https://gitdiagram.com/kishanwebdev/youtube-backend
- Repository: https://github.com/kishanwebdev/youtube-backend

## Overview

##### Project type and purpose
- This is a standalone backend service (RESTful API) implementing YouTube-style video features plus Twitter-style tweeting.
- Built with Node.js/Express, MongoDB for persistence, and Cloudinary for media storage.

##### File structure
- Entry points:
- src/index.js – spins up the Express app, connects to MongoDB.
- src/app.js – registers middleware, routes, global error handlers.
- Layers:
- routes/ – maps URL paths to controller functions.
- controllers/ – contains business logic for each domain (user, video, tweet, comment, like, playlist, subscription, dashboard, healthcheck).
- models/ – Mongoose schemas for each domain object.
- middlewares/ – authentication (JWT), file uploads (multer).
- utils/ – common helpers (ApiResponse, apiError, asyncHandler, cloudinary integration).
- Public/temp – placeholder for temporary uploads.
- Config files: .env.sample, vercel.json, package.json, etc.

##### Additional insights from README
- Core features: user management, video CRUD, tweet CRUD, subscriptions, playlists, likes, comments, dashboard stats, healthcheck.
- Tech stack: Node.js, Express.js, MongoDB, Cloudinary.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Clients<br/>Web/Mobile"]:::external

    subgraph "API Layer"
        direction TB
        Index["src/index.js<br/>(Entry Point)"]:::api
        App["src/app.js<br/>(Express App)"]:::api
        Index --> App

        DBConn["src/db/dbConnect.js"]:::api
        App --> DBConn

        subgraph "Middleware"
            direction TB
            Auth["Auth Middleware"]:::middleware
            Multer["Multer Middleware"]:::middleware
        end
        App --> Auth
        App --> Multer

        subgraph "Routing"
            direction TB
            UserRoutes["User Routes"]:::api
            VideoRoutes["Video Routes"]:::api
            TweetRoutes["Tweet Routes"]:::api
            CommentRoutes["Comment Routes"]:::api
            LikeRoutes["Like Routes"]:::api
            PlaylistRoutes["Playlist Routes"]:::api
            SubRoutes["Subscription Routes"]:::api
            DashRoutes["Dashboard Routes"]:::api
            HealthRoutes["Healthcheck Routes"]:::api
        end
        Auth --> UserRoutes
        Auth --> VideoRoutes
        Auth --> TweetRoutes
        Auth --> CommentRoutes
        Auth --> LikeRoutes
        Auth --> PlaylistRoutes
        Auth --> SubRoutes
        Auth --> DashRoutes
        Auth --> HealthRoutes

        subgraph "Controllers"
            direction TB
            UserCtrl["User Controller"]:::api
            VideoCtrl["Video Controller"]:::api
            TweetCtrl["Tweet Controller"]:::api
            CommentCtrl["Comment Controller"]:::api
            LikeCtrl["Like Controller"]:::api
            PlaylistCtrl["Playlist Controller"]:::api
            SubCtrl["Subscription Controller"]:::api
            DashCtrl["Dashboard Controller"]:::api
            HealthCtrl["Healthcheck Controller"]:::api
        end
        UserRoutes --> UserCtrl
        VideoRoutes --> VideoCtrl
        TweetRoutes --> TweetCtrl
        CommentRoutes --> CommentCtrl
        LikeRoutes --> LikeCtrl
        PlaylistRoutes --> PlaylistCtrl
        SubRoutes --> SubCtrl
        DashRoutes --> DashCtrl
        HealthRoutes --> HealthCtrl

        subgraph "Data Access"
            direction TB
            UserModel["User Model"]:::data
            VideoModel["Video Model"]:::data
            TweetModel["Tweet Model"]:::data
            CommentModel["Comment Model"]:::data
            LikeModel["Like Model"]:::data
            PlaylistModel["Playlist Model"]:::data
            SubModel["Subscription Model"]:::data
        end
        UserCtrl --> UserModel
        VideoCtrl --> VideoModel
        TweetCtrl --> TweetModel
        CommentCtrl --> CommentModel
        LikeCtrl --> LikeModel
        PlaylistCtrl --> PlaylistModel
        SubCtrl --> SubModel
        DashCtrl --> UserModel
        DashCtrl --> VideoModel
        HealthCtrl --> UserModel

    end

    DB["MongoDB"]:::data
    subgraph "External Media Storage"
        Cloudinary["Cloudinary"]:::external
    end

    Client -->|"HTTP requests"| Index
    DBConn --> DB

    VideoCtrl -->|"uploader.upload() / download"| Cloudinary
    TweetCtrl -->|"uploader.upload() / download"| Cloudinary

    UserModel --> DB
    VideoModel --> DB
    TweetModel --> DB
    CommentModel --> DB
    LikeModel --> DB
    PlaylistModel --> DB
    SubModel --> DB

    subgraph "Utilities"
        direction TB
        ApiResp["ApiResponse"]:::util
        ApiErr["apiError"]:::util
        AsyncH["asyncHandler"]:::util
        CloudUtil["cloudinary.js"]:::util
    end
    VideoCtrl --> CloudUtil
    TweetCtrl --> CloudUtil

    subgraph "Config & Env"
        direction TB
        Env[".env.sample"]:::external
        Vercel["vercel.json"]:::external
        Pjson["package.json"]:::external
    end

    PublicTemp["public/temp/.gitkeep"]:::external

    click Index "https://github.com/kishanwebdev/youtube-backend/blob/main/src/index.js"
    click App "https://github.com/kishanwebdev/youtube-backend/blob/main/src/app.js"
    click DBConn "https://github.com/kishanwebdev/youtube-backend/blob/main/src/db/dbConnect.js"
    click Auth "https://github.com/kishanwebdev/youtube-backend/blob/main/src/middlewares/auth.middleware.js"
    click Multer "https://github.com/kishanwebdev/youtube-backend/blob/main/src/middlewares/multer.middleware.js"
    click UserRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/user.routes.js"
    click VideoRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/video.routes.js"
    click TweetRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/tweet.routes.js"
    click CommentRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/comment.routes.js"
    click LikeRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/like.routes.js"
    click PlaylistRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/playlist.routes.js"
    click SubRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/subscription.routes.js"
    click DashRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/dashboard.routes.js"
    click HealthRoutes "https://github.com/kishanwebdev/youtube-backend/blob/main/src/routes/healthcheck.routes.js"
    click UserCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/user.controller.js"
    click VideoCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/video.controller.js"
    click TweetCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/tweet.controller.js"
    click CommentCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/comment.controller.js"
    click LikeCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/like.controller.js"
    click PlaylistCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/playlist.controller.js"
    click SubCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/subscription.controller.js"
    click DashCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/dashboard.controller.js"
    click HealthCtrl "https://github.com/kishanwebdev/youtube-backend/blob/main/src/controllers/healthcheck.controller.js"
    click UserModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/user.model.js"
    click VideoModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/video.model.js"
    click TweetModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/tweet.model.js"
    click CommentModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/comment.model.js"
    click LikeModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/like.model.js"
    click PlaylistModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/playlist.model.js"
    click SubModel "https://github.com/kishanwebdev/youtube-backend/blob/main/src/models/subscription.model.js"
    click ApiResp "https://github.com/kishanwebdev/youtube-backend/blob/main/src/utils/ApiResponse.js"
    click ApiErr "https://github.com/kishanwebdev/youtube-backend/blob/main/src/utils/apiError.js"
    click AsyncH "https://github.com/kishanwebdev/youtube-backend/blob/main/src/utils/asyncHandler.js"
    click CloudUtil "https://github.com/kishanwebdev/youtube-backend/blob/main/src/utils/cloudinary.js"
    click PublicTemp "https://github.com/kishanwebdev/youtube-backend/blob/main/public/temp/.gitkeep"
    click Env "https://github.com/kishanwebdev/youtube-backend/blob/main/.env.sample"
    click Vercel "https://github.com/kishanwebdev/youtube-backend/blob/main/vercel.json"
    click Pjson "https://github.com/kishanwebdev/youtube-backend/blob/main/package.json"

    classDef api fill:#cce5ff,stroke:#339,stroke-width:1px;
    classDef middleware fill:#e0e0e0,stroke:#999,stroke-width:1px;
    classDef data fill:#d4edda,stroke:#28a745,stroke-width:1px;
    classDef external fill:#ffe5b4,stroke:#e69500,stroke-width:1px;
    classDef util fill:#f0d0ff,stroke:#a64ca6,stroke-width:1px;
```
