# amritanshraizada/jobverse architecture

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

- Interactive diagram: https://gitdiagram.com/amritanshraizada/jobverse
- Repository: https://github.com/amritanshraizada/jobverse

## Overview

##### Project Type & Purpose
– This is a full-stack MERN (MongoDB, Express, React, Node) job portal named JobVerse.
– Frontend: React + Vite + Tailwind CSS + Redux Toolkit for state.
– Backend: Node.js + Express, follows an MVC-style structure (controllers, models, routes), using Mongoose to talk to MongoDB.
– Provides user- and admin-facing features (browse/apply jobs, company/job management), JWT auth, file uploads via Multer & Cloudinary.

##### File Structure Analysis
- Top level separates “frontend” and “backend” directories.
- Backend:
– controllers/ (application.controller.js, company.controller.js, job.controller.js, user.controller.js)
– models/ (application.model.js, company.model.js, job.model.js, user.model.js)
– routes/ (one route file per resource)
– middlewares/ (isAuthenticated.js for JWT guard, multer.js for file uploads)
– utils/ (db.js for Mongo connection, cloudinary.js, datauri.js)
- Frontend:
– src/components/ (UI broken into auth, admin, shared, ui-kit, feature components)
– src/hooks/ for data–fetching hooks
– src/redux/ for state slices and store
– lib/utils.js, utils/constant.js for shared logic

##### Key README Insights
– Tech stack chart confirms React+Vite, Node+Express, MongoDB, JWT, Cloudinary, Redux.
– Live demo on Vercel (frontend) and Render/local (backend).
– Auth is role-based (Admin vs User).
– Features broken down by user type (job seeker vs recruiter).

##### Main Components
a. Frontend Layer
– Browser client running React/Vite
– Redux store + React Router + custom hooks
b. API Layer (Backend)
– Express server with route modules
– Middleware chain (CORS, JSON parser, isAuthenticated, Multer)
– Controller functions implementing business logic
c. Persistence Layer
– MongoDB Atlas or local MongoDB
– Mongoose models (User, Company, Job, Application)
d. External Services
– Cloudinary (image uploads)
– JWT issuer/validator (part of auth middleware)
– Hosting platforms: Vercel (frontend), Render (backend)

##### Relationships & Data Flows
– UI actions (e.g. “Apply to job”) → Redux action → custom hook → HTTP request → Express route → controller → model → DB → response → Redux store update → UI re-render.
– Authentication: Login/Signup request → JWT issued → stored in client (localStorage) → attached to subsequent API calls in Authorization header → protected routes check via isAuthenticated middleware.
– File uploads: client sends multipart data → Multer middleware → buffer passed to datauri util → sent to Cloudinary → Cloudinary returns URL → saved in MongoDB document.

##### Architectural Patterns & Principles
– Backend: MVC-style separation (models, controllers, routes).
– Frontend: Component-based UI + container/presentational pattern, hooks for data layer, Redux Toolkit for global state.
– Single-Page App served by Vite dev server (or static build on Vercel).
– RESTful API with clear resource separation (users, companies, jobs, applications).
– Layered security: JWT auth + role-based access in routes/controllers.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        Browser["Browser Client & Vite"]:::client
        HTML["HTML Template"]:::client
        AppShell["App Shell & React Router"]:::client
        ReduxStore["Redux Store"]:::client

        subgraph "Redux Slices"
            direction TB
            AuthSlice["authSlice.js"]:::client
            CompanySlice["companySlice.js"]:::client
            JobSlice["jobSlice.js"]:::client
            ApplicationSlice["applicationSlice.js"]:::client
        end

        Hooks["Data-Fetching Hooks"]:::client
        subgraph "UI Components"
            direction TB
            AuthUI["Login.jsx / Signup.jsx"]:::client
            AdminUI["ProtectedRoute.jsx"]:::client
            UIKit["UI-Kit Components"]:::client
            Shared["Shared/Layout Components"]:::client
        end
        Const["constant.js"]:::client
        Utils["utils.js"]:::client
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        Server["Express Server"]:::api
        Middleware["Middleware Chain (CORS, JSON, Auth, Multer)"]:::api

        subgraph "Routes"
            direction TB
            UserRoute["user.route.js"]:::api
            CompanyRoute["company.route.js"]:::api
            JobRoute["job.route.js"]:::api
            ApplicationRoute["application.route.js"]:::api
        end

        subgraph "Controllers"
            direction TB
            UserCtrl["user.controller.js"]:::api
            CompanyCtrl["company.controller.js"]:::api
            JobCtrl["job.controller.js"]:::api
            ApplicationCtrl["application.controller.js"]:::api
        end

        subgraph "Models"
            direction TB
            UserModel["user.model.js"]:::api
            CompanyModel["company.model.js"]:::api
            JobModel["job.model.js"]:::api
            ApplicationModel["application.model.js"]:::api
        end

        subgraph "Utils/Middleware"
            direction TB
            AuthMW["isAuthenticated.js"]:::api
            MulterMW["multer.js"]:::api
            DBUtil["db.js"]:::api
            CloudUtil["cloudinary.js"]:::api
            DataURI["datauri.js"]:::api
        end
    end

    %% Persistence & External Services
    subgraph "Persistence & External Services"
        direction TB
        MongoDB["MongoDB"]:::db
        Cloudinary["Cloudinary Service"]:::db
        JWTService["JWT Issuer/Validator"]:::db
    end

    %% Connections: Client to API
    AppShell -->|renders UI| AuthUI
    AppShell -->|renders UI| AdminUI
    AuthUI -->|dispatch actions| ReduxStore
    AdminUI -->|dispatch actions| ReduxStore
    ReduxStore -->|uses slices| AuthSlice
    ReduxStore --> CompanySlice
    ReduxStore --> JobSlice
    ReduxStore --> ApplicationSlice
    AuthUI -->|calls hooks| Hooks
    AdminUI --> Hooks

    Hooks -->|HTTP request| Server
    Browser -->|load| HTML
    Browser -->|run| AppShell

    %% API Internal Flow
    Server --> Middleware
    Middleware -->|route match| UserRoute
    Server -->|route match| CompanyRoute
    Server --> JobRoute
    Server --> ApplicationRoute

    UserRoute --> UserCtrl
    CompanyRoute --> CompanyCtrl
    JobRoute --> JobCtrl
    ApplicationRoute --> ApplicationCtrl

    UserCtrl --> UserModel
    CompanyCtrl --> CompanyModel
    JobCtrl --> JobModel
    ApplicationCtrl --> ApplicationModel

    UserModel --> MongoDB
    CompanyModel --> MongoDB
    JobModel --> MongoDB
    ApplicationModel --> MongoDB

    MulterMW --> DataURI
    DataURI --> CloudUtil
    CloudUtil --> Cloudinary

    AuthMW --> JWTService

    %% Styling
    classDef client fill:#E0F7FA,stroke:#0288D1,color:#01579B
    classDef api fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    classDef db fill:#FFF3E0,stroke:#FB8C00,color:#E65100

    %% Click Events - Client
    click Browser "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/main.jsx"
    click HTML "https://github.com/amritanshraizada/jobverse/blob/main/frontend/index.html"
    click AppShell "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/App.jsx"
    click ReduxStore "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/redux/store.js"
    click AuthSlice "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/redux/authSlice.js"
    click CompanySlice "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/redux/companySlice.js"
    click JobSlice "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/redux/jobSlice.js"
    click ApplicationSlice "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/redux/applicationSlice.js"
    click Hooks "https://github.com/amritanshraizada/jobverse/tree/main/frontend/src/hooks/"
    click AuthUI "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/components/auth/Login.jsx"
    click AdminUI "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/components/admin/ProtectedRoute.jsx"
    click UIKit "https://github.com/amritanshraizada/jobverse/tree/main/frontend/src/components/ui/"
    click Shared "https://github.com/amritanshraizada/jobverse/tree/main/frontend/src/components/shared/"
    click Const "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/utils/constant.js"
    click Utils "https://github.com/amritanshraizada/jobverse/blob/main/frontend/src/lib/utils.js"

    %% Click Events - API
    click Server "https://github.com/amritanshraizada/jobverse/blob/main/backend/index.js"
    click UserRoute "https://github.com/amritanshraizada/jobverse/blob/main/backend/routes/user.route.js"
    click CompanyRoute "https://github.com/amritanshraizada/jobverse/blob/main/backend/routes/company.route.js"
    click JobRoute "https://github.com/amritanshraizada/jobverse/blob/main/backend/routes/job.route.js"
    click ApplicationRoute "https://github.com/amritanshraizada/jobverse/blob/main/backend/routes/application.route.js"
    click UserCtrl "https://github.com/amritanshraizada/jobverse/blob/main/backend/controllers/user.controller.js"
    click CompanyCtrl "https://github.com/amritanshraizada/jobverse/blob/main/backend/controllers/company.controller.js"
    click JobCtrl "https://github.com/amritanshraizada/jobverse/blob/main/backend/controllers/job.controller.js"
    click ApplicationCtrl "https://github.com/amritanshraizada/jobverse/blob/main/backend/controllers/application.controller.js"
    click UserModel "https://github.com/amritanshraizada/jobverse/blob/main/backend/models/user.model.js"
    click CompanyModel "https://github.com/amritanshraizada/jobverse/blob/main/backend/models/company.model.js"
    click JobModel "https://github.com/amritanshraizada/jobverse/blob/main/backend/models/job.model.js"
    click ApplicationModel "https://github.com/amritanshraizada/jobverse/blob/main/backend/models/application.model.js"
    click AuthMW "https://github.com/amritanshraizada/jobverse/blob/main/backend/middlewares/isAuthenticated.js"
    click MulterMW "https://github.com/amritanshraizada/jobverse/blob/main/backend/middlewares/multer.js"
    click DBUtil "https://github.com/amritanshraizada/jobverse/blob/main/backend/utils/db.js"
    click CloudUtil "https://github.com/amritanshraizada/jobverse/blob/main/backend/utils/cloudinary.js"
    click DataURI "https://github.com/amritanshraizada/jobverse/blob/main/backend/utils/datauri.js"
```
