# azaank-dev/echoplay-backend architecture

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

- Interactive diagram: https://gitdiagram.com/azaank-dev/echoplay-backend
- Repository: https://github.com/azaank-dev/echoplay-backend

## Overview

This is a learning-oriented video-sharing backend, exposing REST APIs for accounts, video publishing and discovery, comments, likes, subscriptions, playlists, tweets, and dashboard data. A request enters through Express route registration, passes route-specific authentication or ID validation where configured, and reaches a domain controller that reads or changes model data and returns an API response. The excerpts show account and video uploads using a Cloudinary helper. The README gives no further product detail; database and external-service wiring is not mapped where the supplied evidence does not establish it.

Main entry points: [`src/app.js`](https://github.com/azaank-dev/echoplay-backend/blob/main/src/app.js) (Express app), [`src/middlewares/auth.middleware.js`](https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/auth.middleware.js) (JWT authentication), [`src/middlewares/validateObjectId.middleware.js`](https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/validateObjectId.middleware.js) (ID validation), [`src/controllers/user.controller.js`](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/user.controller.js) (Account controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_express_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_comment_routes["Comment routes<br/>[comment.routes.js]"]
  node_dashboard_routes["Dashboard routes"]
  node_like_routes["Like routes<br/>[like.routes.js]"]
  node_playlist_routes["Playlist routes<br/>[playlist.routes.js]"]
  node_subscription_routes["Subscription routes"]
  node_tweet_routes["Tweet routes<br/>[tweet.routes.js]"]
  node_health_routes["Health routes"]
end

subgraph group_identity["Accounts"]
  node_user_controller["Account controller<br/>[user.controller.js]"]
  node_user_model["User model<br/>[user.model.js]"]
  node_auth["JWT authentication<br/>[auth.middleware.js]"]
end

subgraph group_media["Video library"]
  node_video_controller["Video controller"]
  node_video_model["Video model<br/>[video.model.js]"]
  node_playlist_controller["Playlist controller"]
  node_playlist_model["Playlist model<br/>[playlist.model.js]"]
end

subgraph group_community["Community features"]
  node_community_controllers["Community controllers"]
  node_community_models["Community models"]
  node_dashboard_controller["Dashboard controller"]
end

subgraph group_shared["Shared runtime"]
  node_health_controller["Health controller"]
  node_upload_helper["Cloudinary helper<br/>[cloudinary.js]"]
  node_response_helper["API response<br/>[ApiResponse.js]"]
  node_async_helper["Async handler<br/>[asyncHandler.js]"]
  node_id_validation["ID validation"]
  node_file_upload["File upload"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_express_app
node_express_app -->|"mounts routes"| node_user_routes
node_express_app -->|"mounts routes"| node_video_routes
node_express_app -->|"mounts routes"| node_comment_routes
node_express_app -->|"mounts routes"| node_dashboard_routes
node_express_app -->|"mounts routes"| node_like_routes
node_express_app -->|"mounts routes"| node_playlist_routes
node_express_app -->|"mounts routes"| node_subscription_routes
node_express_app -->|"mounts routes"| node_tweet_routes
node_express_app -->|"mounts routes"| node_health_routes
node_user_routes -->|"dispatches to"| node_user_controller
node_user_routes -->|"protects routes"| node_auth
node_user_routes -->|"uploads files"| node_file_upload
node_video_routes -->|"dispatches to"| node_video_controller
node_video_routes -->|"protects routes"| node_auth
node_video_routes -->|"uploads files"| node_file_upload
node_comment_routes -->|"dispatches to"| node_community_controllers
node_comment_routes -->|"protects routes"| node_auth
node_comment_routes -->|"validates IDs"| node_id_validation
node_dashboard_routes -->|"dispatches to"| node_dashboard_controller
node_dashboard_routes -->|"protects routes"| node_auth
node_dashboard_routes -->|"validates IDs"| node_id_validation
node_like_routes -->|"dispatches to"| node_community_controllers
node_like_routes -->|"protects routes"| node_auth
node_like_routes -->|"validates IDs"| node_id_validation
node_playlist_routes -->|"dispatches to"| node_playlist_controller
node_playlist_routes -->|"protects routes"| node_auth
node_playlist_routes -->|"validates IDs"| node_id_validation
node_subscription_routes -->|"dispatches to"| node_community_controllers
node_subscription_routes -->|"protects routes"| node_auth
node_subscription_routes -->|"validates IDs"| node_id_validation
node_tweet_routes -->|"dispatches to"| node_community_controllers
node_tweet_routes -->|"protects routes"| node_auth
node_tweet_routes -->|"validates IDs"| node_id_validation
node_health_routes -->|"dispatches to"| node_health_controller
node_user_controller -->|"reads and writes"| node_user_model
node_user_controller -->|"uploads media"| node_upload_helper
node_user_controller -->|"formats response"| node_response_helper
node_user_controller -->|"wraps handlers"| node_async_helper
node_auth -->|"loads account"| node_user_model
node_auth -->|"wraps handler"| node_async_helper
node_video_controller -->|"reads and writes"| node_video_model
node_video_controller -->|"uploads media"| node_upload_helper
node_video_controller -->|"formats response"| node_response_helper
node_playlist_controller -->|"reads and writes"| node_playlist_model
node_playlist_controller -->|"checks video"| node_video_model
node_playlist_controller -->|"formats response"| node_response_helper
node_community_controllers -->|"uses domain models"| node_community_models

click node_express_app "https://github.com/azaank-dev/echoplay-backend/blob/main/src/app.js"
click node_user_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/user.routes.js"
click node_video_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/video.routes.js"
click node_comment_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/comment.routes.js"
click node_dashboard_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/dashboard.routes.js"
click node_like_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/like.routes.js"
click node_playlist_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/playlist.routes.js"
click node_subscription_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/subscription.routes.js"
click node_tweet_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/tweet.routes.js"
click node_health_routes "https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/healthcheck.routes.js"
click node_user_controller "https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/user.controller.js"
click node_user_model "https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/user.model.js"
click node_auth "https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/auth.middleware.js"
click node_video_controller "https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/video.controller.js"
click node_video_model "https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/video.model.js"
click node_playlist_controller "https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/playlist.controller.js"
click node_playlist_model "https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/playlist.model.js"
click node_community_controllers "https://github.com/azaank-dev/echoplay-backend/tree/main/src/controllers"
click node_community_models "https://github.com/azaank-dev/echoplay-backend/tree/main/src/models"
click node_dashboard_controller "https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/dashboard.controller.js"
click node_health_controller "https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/healthcheck.controller.js"
click node_upload_helper "https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/cloudinary.js"
click node_response_helper "https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/ApiResponse.js"
click node_async_helper "https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/asyncHandler.js"
click node_id_validation "https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/validateObjectId.middleware.js"
click node_file_upload "https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/multer.middleware.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_express_app,node_user_routes,node_video_routes,node_comment_routes,node_dashboard_routes,node_like_routes,node_playlist_routes,node_subscription_routes,node_tweet_routes,node_health_routes,node_client toneBlue
class node_user_controller,node_user_model,node_auth toneAmber
class node_video_controller,node_video_model,node_playlist_controller,node_playlist_model toneMint
class node_community_controllers,node_community_models,node_dashboard_controller toneRose
class node_health_controller,node_upload_helper,node_response_helper,node_async_helper,node_id_validation,node_file_upload toneIndigo
```

## Components

### API entry

- [Express app](https://github.com/azaank-dev/echoplay-backend/blob/main/src/app.js): `src/app.js`
- [User routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/user.routes.js): `src/routes/user.routes.js`
- [Video routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/video.routes.js): `src/routes/video.routes.js`
- [Comment routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/comment.routes.js): `src/routes/comment.routes.js`
- [Dashboard routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/dashboard.routes.js): `src/routes/dashboard.routes.js`
- [Like routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/like.routes.js): `src/routes/like.routes.js`
- [Playlist routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/playlist.routes.js): `src/routes/playlist.routes.js`
- [Subscription routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/subscription.routes.js): `src/routes/subscription.routes.js`
- [Tweet routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/tweet.routes.js): `src/routes/tweet.routes.js`
- [Health routes](https://github.com/azaank-dev/echoplay-backend/blob/main/src/routes/healthcheck.routes.js): `src/routes/healthcheck.routes.js`

### Accounts

- [Account controller](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/user.controller.js): `src/controllers/user.controller.js`
- [User model](https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/user.model.js): `src/models/user.model.js`
- [JWT authentication](https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`

### Video library

- [Video controller](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/video.controller.js): `src/controllers/video.controller.js`
- [Video model](https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/video.model.js): `src/models/video.model.js`
- [Playlist controller](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/playlist.controller.js): `src/controllers/playlist.controller.js`
- [Playlist model](https://github.com/azaank-dev/echoplay-backend/blob/main/src/models/playlist.model.js): `src/models/playlist.model.js`

### Community features

- [Community controllers](https://github.com/azaank-dev/echoplay-backend/tree/main/src/controllers): `src/controllers`
- [Community models](https://github.com/azaank-dev/echoplay-backend/tree/main/src/models): `src/models`
- [Dashboard controller](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/dashboard.controller.js): `src/controllers/dashboard.controller.js`

### Shared runtime

- [Health controller](https://github.com/azaank-dev/echoplay-backend/blob/main/src/controllers/healthcheck.controller.js): `src/controllers/healthcheck.controller.js`
- [Cloudinary helper](https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/cloudinary.js): `src/utils/cloudinary.js`
- [API response](https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/ApiResponse.js): `src/utils/ApiResponse.js`
- [Async handler](https://github.com/azaank-dev/echoplay-backend/blob/main/src/utils/asyncHandler.js): `src/utils/asyncHandler.js`
- [ID validation](https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/validateObjectId.middleware.js): `src/middlewares/validateObjectId.middleware.js`
- [File upload](https://github.com/azaank-dev/echoplay-backend/blob/main/src/middlewares/multer.middleware.js): `src/middlewares/multer.middleware.js`

### Other components

- **API client**

## Connections

- API 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 → Comment routes: mounts routes (evidence: `src/app.js`)
- Express app → Dashboard routes: mounts routes (evidence: `src/app.js`)
- Express app → Like routes: mounts routes (evidence: `src/app.js`)
- Express app → Playlist routes: mounts routes (evidence: `src/app.js`)
- Express app → Subscription routes: mounts routes (evidence: `src/app.js`)
- Express app → Tweet routes: mounts routes (evidence: `src/app.js`)
- Express app → Health routes: mounts routes (evidence: `src/app.js`)
- User routes → Account controller: dispatches to (evidence: `src/routes/user.routes.js`)
- User routes → JWT authentication: protects routes (evidence: `src/routes/user.routes.js`)
- User routes → File upload: uploads files (evidence: `src/routes/user.routes.js`)
- Video routes → Video controller: dispatches to (evidence: `src/routes/video.routes.js`)
- Video routes → JWT authentication: protects routes (evidence: `src/routes/video.routes.js`)
- Video routes → File upload: uploads files (evidence: `src/routes/video.routes.js`)
- Comment routes → Community controllers: dispatches to (evidence: `src/routes/comment.routes.js`)
- Comment routes → JWT authentication: protects routes (evidence: `src/routes/comment.routes.js`)
- Comment routes → ID validation: validates IDs (evidence: `src/routes/comment.routes.js`)
- Dashboard routes → Dashboard controller: dispatches to (evidence: `src/routes/dashboard.routes.js`)
- Dashboard routes → JWT authentication: protects routes (evidence: `src/routes/dashboard.routes.js`)
- Dashboard routes → ID validation: validates IDs (evidence: `src/routes/dashboard.routes.js`)
- Like routes → Community controllers: dispatches to (evidence: `src/routes/like.routes.js`)
- Like routes → JWT authentication: protects routes (evidence: `src/routes/like.routes.js`)
- Like routes → ID validation: validates IDs (evidence: `src/routes/like.routes.js`)
- Playlist routes → Playlist controller: dispatches to (evidence: `src/routes/playlist.routes.js`)
- Playlist routes → JWT authentication: protects routes (evidence: `src/routes/playlist.routes.js`)
- Playlist routes → ID validation: validates IDs (evidence: `src/routes/playlist.routes.js`)
- Subscription routes → Community controllers: dispatches to (evidence: `src/routes/subscription.routes.js`)
- Subscription routes → JWT authentication: protects routes (evidence: `src/routes/subscription.routes.js`)
- Subscription routes → ID validation: validates IDs (evidence: `src/routes/subscription.routes.js`)
- Tweet routes → Community controllers: dispatches to (evidence: `src/routes/tweet.routes.js`)
- Tweet routes → JWT authentication: protects routes (evidence: `src/routes/tweet.routes.js`)
- Tweet routes → ID validation: validates IDs (evidence: `src/routes/tweet.routes.js`)
- Health routes → Health controller: dispatches to (evidence: `src/routes/healthcheck.routes.js`)
- Account controller → User model: reads and writes (evidence: `src/controllers/user.controller.js`)
- Account controller → Cloudinary helper: uploads media (evidence: `src/controllers/user.controller.js`)
- Account controller → API response: formats response (evidence: `src/controllers/user.controller.js`)
- Account controller → Async handler: wraps handlers (evidence: `src/controllers/user.controller.js`)
- JWT authentication → User model: loads account (evidence: `src/middlewares/auth.middleware.js`)
- JWT authentication → Async handler: wraps handler (evidence: `src/middlewares/auth.middleware.js`)
- Video controller → Video model: reads and writes (evidence: `src/controllers/video.controller.js`)
- Video controller → Cloudinary helper: uploads media (evidence: `src/controllers/video.controller.js`)
- Video controller → API response: formats response (evidence: `src/controllers/video.controller.js`)
- Playlist controller → Playlist model: reads and writes (evidence: `src/controllers/playlist.controller.js`)
- Playlist controller → Video model: checks video (evidence: `src/controllers/playlist.controller.js`)
- Playlist controller → API response: formats response (evidence: `src/controllers/playlist.controller.js`)
- Community controllers → Community models: uses domain models (evidence: `src/controllers/comment.controller.js`)
