# vikal-3/logsci-backend architecture

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

## Overview

This is a small Express backend whose visible product workflow is user registration: an HTTP client submits account fields and avatar/cover files, the route stages uploads, the controller validates and uploads images, creates a user record, and returns an API response. Startup connects MongoDB before listening. The user schema also defines password/token behavior and a video watch-history reference, but no video-facing workflow is shown. The README describes a code series rather than additional product capabilities; the video model was not excerpted, so its behavior and relationships are omitted.

Main entry points: [`src/controllers/user.controller.js`](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/controllers/user.controller.js) (Registration controller), [`src/routes/user.routes.js`](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/routes/user.routes.js) (User routes), [`src/models/user.model.js`](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/models/user.model.js) (User model), [`src/app.js`](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/app.js) (Express app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_app["Express app<br/>[app.js]"]
  node_user_routes["User routes<br/>[user.routes.js]"]
end

subgraph group_registration["Registration"]
  node_registration_controller["Registration controller<br/>[user.controller.js]"]
  node_file_upload["File upload middleware"]
end

subgraph group_data["Data and integrations"]
  node_user_model["User model<br/>[user.model.js]"]
  node_video_model["Video model<br/>[video.model.js]"]
  node_mongo[("MongoDB")]
  node_cloudinary_helper["Cloudinary uploader<br/>[cloudinary.js]"]
  node_cloudinary_service["Cloudinary"]
  node_temp_files["Temporary uploads"]
end

subgraph group_runtime["Runtime support"]
  node_api_response["API response<br/>[ApiResponse.js]"]
  node_api_error["API errors<br/>[ApiError.js]"]
  node_async_handler["Async handler<br/>[asyncHandler.js]"]
  node_entrypoint["Server entrypoint<br/>[index.js]"]
  node_db_connection["DB connection<br/>[index.js]"]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_user_routes
node_user_routes -->|"stages files"| node_file_upload
node_user_routes -->|"dispatches registration"| node_registration_controller
node_file_upload -->|"writes uploads"| node_temp_files
node_registration_controller -->|"wraps handler"| node_async_handler
node_registration_controller -->|"creates and queries"| node_user_model
node_registration_controller -->|"uploads images"| node_cloudinary_helper
node_cloudinary_helper -->|"uploads files"| node_cloudinary_service
node_registration_controller -->|"returns response"| node_api_response
node_registration_controller -->|"throws errors"| node_api_error
node_user_model -.->|"persists user data"| node_mongo
node_user_model -->|"references watch history"| node_video_model
node_entrypoint -->|"starts listener"| node_app
node_entrypoint -->|"connects before listen"| node_db_connection
node_db_connection -->|"opens connection"| node_mongo

click node_app "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/app.js"
click node_user_routes "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/routes/user.routes.js"
click node_registration_controller "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/controllers/user.controller.js"
click node_file_upload "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/middlewares/multer.middleware.js"
click node_user_model "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/models/user.model.js"
click node_video_model "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/models/video.model.js"
click node_cloudinary_helper "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/cloudinary.js"
click node_temp_files "https://github.com/vikal-3/logsci-backend/tree/LogSci/public/temp"
click node_api_response "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/ApiResponse.js"
click node_api_error "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/ApiError.js"
click node_async_handler "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/asyncHandler.js"
click node_entrypoint "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/index.js"
click node_db_connection "https://github.com/vikal-3/logsci-backend/blob/LogSci/src/db/index.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_client toneBlue
class node_registration_controller,node_file_upload toneAmber
class node_user_model,node_video_model,node_mongo,node_cloudinary_helper,node_cloudinary_service,node_temp_files toneMint
class node_api_response,node_api_error,node_async_handler,node_entrypoint,node_db_connection toneRose
```

## Components

### HTTP API

- [Express app](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/app.js): `src/app.js`
- [User routes](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/routes/user.routes.js): `src/routes/user.routes.js`

### Registration

- [Registration controller](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/controllers/user.controller.js): `src/controllers/user.controller.js`
- [File upload middleware](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/middlewares/multer.middleware.js): `src/middlewares/multer.middleware.js`

### Data and integrations

- [User model](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/models/user.model.js): `src/models/user.model.js`
- [Video model](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/models/video.model.js): `src/models/video.model.js`
- **MongoDB**
- [Cloudinary uploader](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/cloudinary.js): `src/utils/cloudinary.js`
- **Cloudinary**
- [Temporary uploads](https://github.com/vikal-3/logsci-backend/tree/LogSci/public/temp): `public/temp`

### Runtime support

- [API response](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/ApiResponse.js): `src/utils/ApiResponse.js`
- [API errors](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/ApiError.js): `src/utils/ApiError.js`
- [Async handler](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/utils/asyncHandler.js): `src/utils/asyncHandler.js`
- [Server entrypoint](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/index.js): `src/index.js`
- [DB connection](https://github.com/vikal-3/logsci-backend/blob/LogSci/src/db/index.js): `src/db/index.js`

### 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`)
- User routes → File upload middleware: stages files (evidence: `src/routes/user.routes.js`)
- User routes → Registration controller: dispatches registration (evidence: `src/routes/user.routes.js`)
- File upload middleware → Temporary uploads: writes uploads (evidence: `src/middlewares/multer.middleware.js`)
- Registration controller → Async handler: wraps handler (evidence: `src/controllers/user.controller.js`)
- Registration controller → User model: creates and queries (evidence: `src/controllers/user.controller.js`)
- Registration controller → Cloudinary uploader: uploads images (evidence: `src/controllers/user.controller.js`)
- Cloudinary uploader → Cloudinary: uploads files (evidence: `src/utils/cloudinary.js`)
- Registration controller → API response: returns response (evidence: `src/controllers/user.controller.js`)
- Registration controller → API errors: throws errors (evidence: `src/controllers/user.controller.js`)
- User model → MongoDB: persists user data
- User model → Video model: references watch history (evidence: `src/models/user.model.js`)
- Server entrypoint → Express app: starts listener (evidence: `src/index.js`)
- Server entrypoint → DB connection: connects before listen (evidence: `src/index.js`)
- DB connection → MongoDB: opens connection (evidence: `src/db/index.js`)
