# sanjana741/learnverse---lms-website architecture

> Architecture diagram of the GitHub repository sanjana741/learnverse---lms-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanjana741/learnverse---lms-website
- Repository: https://github.com/sanjana741/learnverse---lms-website

## Overview

##### Project type and purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) Learning Management System (LMS) with TypeScript.
- Frontend: React + Redux Toolkit (RTK Query) + Shadcn UI.
- Backend: Node.js + Express + MongoDB (Mongoose), JWT authentication, Stripe payments, Cloudinary media storage, Multer uploads.

##### File structure
- Top‐level directories:
- Frontend/ – React app, organized into src/{app,components,features,pages,assets,…}
- backend/ – Express server, organized into src/{controllers,models,routes,middleware,utils,database} plus an uploads folder.
- Frontend patterns:
- “app” (Redux store + rootReducer)
- “features/api” (RTK-query endpoints)
- “components” (UI primitives + pages + layout)
- “pages” (student vs admin sub-folders)
- Backend patterns:
- MVC style controllers/models/routes
- Middleware folder for auth
- Utils for cloudinary, multer, token generation
- Uploads folder for persisted files

##### Key insights from README
- RESTful API endpoints grouped by domain (auth, users, courses, progress, purchases, media).
- Third-party services: Stripe (checkout + webhooks), Cloudinary (media), Multer (file parsing).
- JWT for auth.
- React Router for client-side navigation and protected routes.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend"
        direction TB
        BrowserSPA["Browser SPA<br>(React + RTK Query)"]:::frontend
        Store["Redux Store & Root Reducer"]:::frontend
        RTKQuery["RTK Query Endpoints"]:::frontend
        Router["React Router & Protected Routes"]:::frontend
        UI["UI Components & Shadcn Primitives"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend"
        direction TB
        APIGateway["Express API Gateway Entry Point"]:::backend
        AuthMW["Auth Middleware<br>(JWT validation)"]:::backend
        subgraph "Auth Service"
            AuthController["Auth Controller & Routes"]:::backend
        end
        subgraph "Course Service"
            CourseCtrl["Course Controller"]:::backend
            CourseModel["Course Model"]:::backend
        end
        subgraph "Progress Service"
            ProgressCtrl["Progress Controller"]:::backend
            ProgressModel["Progress Model"]:::backend
        end
        subgraph "Purchase Service"
            PurchaseCtrl["Purchase Controller"]:::backend
            PurchaseModel["Purchase Model"]:::backend
        end
        subgraph "Media Service"
            MediaRoute["Media Routes"]:::backend
            MulterUtil["Multer Utility"]:::backend
            CloudinaryUtil["Cloudinary Utility"]:::backend
        end
        DBConnect["Database Connection"]:::backend
        Uploads["Uploaded Files Storage"]:::backend
    end

    %% Database
    MongoDB["MongoDB"]:::db

    %% External Services
    subgraph "External"
        direction TB
        Stripe["Stripe"]:::external
        Cloudinary["Cloudinary"]:::external
    end

    %% Frontend flows
    BrowserSPA --> UI
    BrowserSPA --> Store
    Store --> RTKQuery
    BrowserSPA --> Router
    Router -->|API Calls| APIGateway
    RTKQuery -->|HTTP Requests| APIGateway
    APIGateway -->|Response| BrowserSPA

    %% Backend flows
    APIGateway --> AuthMW
    AuthMW --> AuthController
    AuthController --> DBConnect
    AuthMW --> CourseCtrl
    CourseCtrl --> CourseModel
    CourseModel --> DBConnect
    AuthMW --> ProgressCtrl
    ProgressCtrl --> ProgressModel
    ProgressModel --> DBConnect
    AuthMW --> PurchaseCtrl
    PurchaseCtrl --> PurchaseModel
    PurchaseModel --> DBConnect
    AuthMW --> MediaRoute
    MediaRoute --> MulterUtil
    MulterUtil --> CloudinaryUtil
    CloudinaryUtil --> Cloudinary
    MediaRoute -->|Store URL| DBConnect
    PurchaseCtrl -->|Create Checkout| Stripe
    Stripe -->|Webhook Callback| APIGateway
    APIGateway --> PurchaseCtrl
    PurchaseCtrl --> PurchaseModel
    PurchaseModel --> DBConnect

    DBConnect --> MongoDB

    %% Styles
    classDef frontend fill:#D0E4FD,stroke:#333,stroke-width:1px
    classDef backend fill:#D1F7C4,stroke:#333,stroke-width:1px
    classDef db fill:#FEE0B4,stroke:#333,stroke-width:1px
    classDef external fill:#E0E0E0,stroke:#333,stroke-width:1px

    %% Click Events
    click BrowserSPA "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/App.tsx"
    click Store "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/app/store.ts"
    click Store "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/app/rootReducer.ts"
    click RTKQuery "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/features/api/authApi.ts"
    click RTKQuery "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/features/api/courseApi.ts"
    click RTKQuery "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/features/api/courseProgressApi.ts"
    click RTKQuery "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/features/api/purchaseApi.ts"
    click Router "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/components/ProtectedRoutes.tsx"
    click Router "https://github.com/sanjana741/learnverse---lms-website/blob/master/Frontend/src/components/PurchaseCourseProtectedRoute.tsx"
    click UI "https://github.com/sanjana741/learnverse---lms-website/tree/master/Frontend/src/components/ui/"
    click AuthController "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/controllers/user.controller.ts"
    click AuthController "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/routes/user.route.ts"
    click AuthMW "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/middleware/isAuthenticated.ts"
    click CourseCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/controllers/course.controller.ts"
    click CourseModel "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/models/course.model.ts"
    click CourseCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/routes/course.route.ts"
    click ProgressCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/controllers/courseProgress.controller.ts"
    click ProgressModel "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/models/courseProgress.ts"
    click ProgressCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/routes/courseProgress.route.ts"
    click PurchaseCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/controllers/coursePurchase.controller.ts"
    click PurchaseModel "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/models/coursePurchase.mode.ts"
    click PurchaseCtrl "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/routes/purchaseCourse.route.ts"
    click MediaRoute "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/routes/media.route.ts"
    click MulterUtil "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/utils/multer.ts"
    click CloudinaryUtil "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/utils/cloudinary.ts"
    click DBConnect "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/database/dbConnect.ts"
    click APIGateway "https://github.com/sanjana741/learnverse---lms-website/blob/master/backend/src/index.ts"
    click Uploads "https://github.com/sanjana741/learnverse---lms-website/tree/master/backend/uploads/"
```
