# vallabhpatil3078/claimdesk architecture

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

- Interactive diagram: https://gitdiagram.com/vallabhpatil3078/claimdesk
- Repository: https://github.com/vallabhpatil3078/claimdesk

## Overview

##### Main Components
a. Frontend (React + Tailwind)
b. Backend API (Node.js + Express + Passport)
c. Database (MongoDB via Mongoose)
d. Cloud Storage (Cloudinary)
e. External Auth Providers (Google, Facebook, Apple)
f. Email Service (Nodemailer, SMTP)

##### Relationships & Data Flows
- User’s Browser ←→ React App (client/ folder)
- Pages & Components fetch/send data via a centralized api.js service.
- AuthContext manages JWT tokens in localStorage.
- React App —[HTTPS REST]→ Express Server (server/server.js)
- Routes: /auth, /items, /users, /notifications
- Middleware: authMiddleware (JWT), passport (OAuth), multer (file upload), roleMiddleware (admin checks)
- Express Server —[Mongoose]→ MongoDB
- Models: User, Items, SendMails
- Express Server —[Cloudinary SDK]→ Cloudinary
- Upload/serve item images.
- Express Server —[Passport OAuth]→ External Providers
- Redirects for Google/Facebook/Apple login flows.
- Express Server —[Nodemailer/SMTP]→ User Email Inbox
- Verification emails, password resets via generateEmailToken.

##### Architectural Patterns
- MVC-style layering on backend:
- Routes → Controllers → Models → Database
- RESTful API boundary between frontend and backend
- Client-side state management using React Context
- Token-based auth (JWT) + OAuth strategies via Passport.js
- Separation of concerns: configuration (server/config), utilities (server/utils), middleware (server/middleware)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Subgraph Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["User Browser"]:::external
        ReactApp["React App"]:::ui
        Pages["Pages"]:::ui
        Components["Components"]:::ui
        AuthContext["AuthContext"]:::ui
        APIService["api.js Service"]:::ui
        Main["main.jsx"]:::ui
        App["App.jsx"]:::ui
    end

    %% Subgraph Backend Layer
    subgraph "Backend Layer"
        direction TB
        Server["server.js"]:::backend
        subgraph "Routes"
            direction TB
            RoutesAuth["auth.js"]:::backend
            RoutesItems["items.js"]:::backend
            RoutesUsers["users.js"]:::backend
            RoutesNotifs["notifications.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            AuthController["authController.js"]:::backend
            ItemController["itemController.js"]:::backend
            UserController["userController.js"]:::backend
            VerifyEmailController["verifyEmail.js"]:::backend
        end
        subgraph "Middleware"
            direction TB
            JWTMiddleware["authMiddleware.js"]:::backend
            MulterMiddleware["multer.js"]:::backend
            RoleMiddleware["roleMiddleware.js"]:::backend
        end
        subgraph "Models"
            direction TB
            UserModel["User.js"]:::backend
            ItemModel["Items.js"]:::backend
            SendMailsModel["SendMails.js"]:::backend
        end
        subgraph "Config"
            direction TB
            DBConfig["db.js"]:::backend
            CloudConfig["cloudinary.js"]:::backend
            PassportConfig["passport.js"]:::backend
            NodemailerConfig["nodemailer.js"]:::backend
        end
        Utils["generateEmailToken.js"]:::backend
    end

    %% Database
    MongoDB[(MongoDB)]:::database

    %% External Services
    subgraph "External Services"
        direction TB
        Cloudinary[(Cloudinary)]:::external
        OAuth["OAuth Providers\n(Google/Facebook/Apple)"]:::external
        SMTP["SMTP/Nodemailer"]:::external
    end

    %% Connections Frontend
    Browser -->|"loads"| ReactApp
    ReactApp -->|"renders pages/components"| Pages
    ReactApp --> Components
    ReactApp --> AuthContext
    ReactApp --> APIService
    AuthContext --> ReactApp
    APIService -->|"HTTPS REST"| Server

    %% Backend internal flows
    Server --> RoutesAuth
    Server --> RoutesItems
    Server --> RoutesUsers
    Server --> RoutesNotifs

    RoutesAuth --> AuthController
    RoutesItems --> ItemController
    RoutesUsers --> UserController
    RoutesNotifs --> VerifyEmailController

    AuthController --> UserModel
    ItemController --> ItemModel
    VerifyEmailController --> SendMailsModel
    UserController --> UserModel

    Server --> JWTMiddleware
    Server --> MulterMiddleware
    Server --> RoleMiddleware

    Server --> Utils

    %% Backend to Database
    Server -->|Mongoose| MongoDB

    %% Backend to External
    Server -->|Cloudinary SDK| Cloudinary
    Server -->|Passport OAuth| OAuth
    Server -->|SMTP| SMTP

    %% Click Events
    click ReactApp "https://github.com/vallabhpatil3078/claimdesk/tree/main/client/"
    click Pages "https://github.com/vallabhpatil3078/claimdesk/tree/main/client/pages/"
    click Components "https://github.com/vallabhpatil3078/claimdesk/tree/main/client/components/"
    click APIService "https://github.com/vallabhpatil3078/claimdesk/blob/main/client/src/api/api.js"
    click AuthContext "https://github.com/vallabhpatil3078/claimdesk/blob/main/client/src/context/AuthContext.jsx"
    click Main "https://github.com/vallabhpatil3078/claimdesk/blob/main/client/src/main.jsx"
    click App "https://github.com/vallabhpatil3078/claimdesk/blob/main/client/src/App.jsx"
    click Server "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/server.js"
    click RoutesAuth "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/routes/auth.js"
    click RoutesItems "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/routes/items.js"
    click RoutesUsers "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/routes/users.js"
    click RoutesNotifs "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/routes/notifications.js"
    click AuthController "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/controllers/authController.js"
    click ItemController "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/controllers/itemController.js"
    click UserController "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/controllers/userController.js"
    click VerifyEmailController "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/controllers/verifyEmail.js"
    click JWTMiddleware "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/middleware/authMiddleware.js"
    click MulterMiddleware "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/middleware/multer.js"
    click RoleMiddleware "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/middleware/roleMiddleware.js"
    click UserModel "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/models/User.js"
    click ItemModel "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/models/Items.js"
    click SendMailsModel "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/models/SendMails.js"
    click DBConfig "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/config/db.js"
    click CloudConfig "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/config/cloudinary.js"
    click PassportConfig "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/config/passport.js"
    click NodemailerConfig "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/config/nodemailer.js"
    click Utils "https://github.com/vallabhpatil3078/claimdesk/blob/main/server/utils/generateEmailToken.js"

    %% Styles
    classDef ui fill:#E7F5FF,stroke:#1C7ED6,color:#1C7ED6;
    classDef backend fill:#EFFAF0,stroke:#37B24D,color:#2F9E44;
    classDef database fill:#FFF4E6,stroke:#F08C00,color:#F08C00;
    classDef external fill:#F8F9FA,stroke:#868E96,color:#495057;
```
