# thanushakudumula/job-portal architecture

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

- Interactive diagram: https://gitdiagram.com/thanushakudumula/job-portal
- Repository: https://github.com/thanushakudumula/job-portal

## Overview

##### Project type and purpose
- This is a full-stack web application (often called “Jobify”) built with a React frontend and a Node.js/Express backend, using MongoDB for persistence.
- Its primary purpose appears to be job management/tracking: users can register, log in, create, edit, delete, and view job postings, plus view statistics.

##### File structure
- Top-level:
- client/ – React single-page app powered by Vite
- controllers/ – Express route handlers for auth, jobs, users
- routes/ – Express routers that map URLs to controllers
- models/ – Mongoose schemas (UserModel, JobModel)
- middleware/ – auth checks, validation, file upload (multer), error handling
- utils/ – token creation, password hashing, constants, mockData
- server.js – application entry point
- populate.js – script to seed the database
- Patterns & architecture:
- MVC-inspired: routes → controllers → models
- JWT-based authentication
- Separation of concerns: validation, authentication, business logic, persistence
- Config & build:
- client/package.json, vite.config.js for front-end
- server’s package.json for back-end
- .env for environment variables (DB URI, JWT_SECRET)

##### README
- (Empty in this case – rely on file tree to infer tech stack & flow.)

a. Main components
- Client (React SPA)
- API Server (Express)
- Database (MongoDB)
- External services (e.g., file storage if used by multer, or any email/notification services)
b. Relationships & interactions
- User’s browser ↔ HTTP/HTTPS ↔ React front-end
- React front-end ↔ Axios/fetch ↔ Express API endpoints
- Express middleware chain (authMiddleware, validationMiddleware) → controllers → models
- Mongoose models ↔ MongoDB
- populate.js → MongoDB (one-time seed)
c. Architectural patterns
- Layered (Presentation, Business Logic, Data Access layers)
- RESTful API design
- JWT authentication flow with tokenUtils and authMiddleware
d. Key technologies/frameworks
- Front-end: React, Vite, CSS modules (assets/css), customFetch utility
- Back-end: Node.js, Express, Mongoose (MongoDB), Multer (file upload), JSON Web Tokens

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (Client)" 
        direction TB
        Browser["User Browser"]:::frontend
        ReactApp["React SPA"]:::frontend
        Pages["Pages Layer"]:::frontend
        Components["Components Layer"]:::frontend
        Wrappers["Wrappers (layout/styling)"]:::frontend
        CSS["CSS Assets"]:::frontend
        CustomFetch["customFetch Utility"]:::frontend
        ViteConfig["Vite Config"]:::frontend

        Browser -->|"renders"| ReactApp
        ReactApp -->|"uses"| Pages
        ReactApp -->|"uses"| Components
        ReactApp -->|"loads styles"| Wrappers
        ReactApp -->|"loads styles"| CSS
        ReactApp -->|"calls API via"| CustomFetch
        ReactApp -->|"dev/build by"| ViteConfig
    end

    %% Backend Layer
    subgraph "Backend (Express API Server)"
        direction TB
        Server["Express Server (server.js)"]:::backend

        subgraph "Middleware Layer"
            direction TB
            AuthMiddleware["Auth Middleware"]:::middleware
            ValidationMiddleware["Validation Middleware"]:::middleware
            MulterMiddleware["Multer Middleware"]:::middleware
            ErrorHandler["Error Handler Middleware"]:::middleware
        end

        subgraph "Routing Layer"
            direction TB
            AuthRouter["Auth Routes"]:::backend
            JobRouter["Job Routes"]:::backend
            UserRouter["User Routes"]:::backend
        end

        subgraph "Controller Layer"
            direction TB
            AuthController["Auth Controller"]:::backend
            JobController["Job Controller"]:::backend
            UserController["User Controller"]:::backend
        end

        subgraph "Data Model Layer"
            direction TB
            UserModel["UserModel"]:::database
            JobModel["JobModel"]:::database
        end

        subgraph "Utilities"
            direction TB
            TokenUtils["Token Utilities"]:::service
            PasswordUtils["Password Utilities"]:::service
            Constants["Application Constants"]:::service
            MockData["Mock Data"]:::service
        end

        subgraph "Scripts"
            direction TB
            SeedDB["Database Seeding Script"]:::service
        end

        Server --> AuthMiddleware
        Server --> ValidationMiddleware
        Server --> MulterMiddleware
        Server --> ErrorHandler

        AuthMiddleware --> AuthRouter
        ValidationMiddleware --> JobRouter
        ValidationMiddleware --> UserRouter
        MulterMiddleware --> JobRouter

        AuthRouter --> AuthController
        JobRouter --> JobController
        UserRouter --> UserController

        AuthController --> UserModel
        JobController --> JobModel
        UserController --> UserModel

        AuthController --> TokenUtils
        AuthController --> PasswordUtils
        AuthController --> Constants

        SeedDB --> MockData
        SeedDB --> UserModel
        SeedDB --> JobModel
    end

    %% Database
    Database["MongoDB"]:::database

    JobModel --> Database
    UserModel --> Database

    ReactApp -->|"API Requests"| Server

    %% Click Events
    click Browser "https://github.com/thanushakudumula/job-portal/tree/main/client/"
    click ReactApp "https://github.com/thanushakudumula/job-portal/tree/main/client/"
    click Pages "https://github.com/thanushakudumula/job-portal/tree/main/client/src/pages/"
    click Components "https://github.com/thanushakudumula/job-portal/tree/main/client/src/components/"
    click Wrappers "https://github.com/thanushakudumula/job-portal/tree/main/client/src/assets/wrappers/"
    click CSS "https://github.com/thanushakudumula/job-portal/blob/main/client/src/assets/css/index.css"
    click CustomFetch "https://github.com/thanushakudumula/job-portal/blob/main/client/src/utils/customFetch.js"
    click ViteConfig "https://github.com/thanushakudumula/job-portal/blob/main/client/vite.config.js"
    click Server "https://github.com/thanushakudumula/job-portal/blob/main/server.js"
    click AuthController "https://github.com/thanushakudumula/job-portal/blob/main/controllers/authController.js"
    click JobController "https://github.com/thanushakudumula/job-portal/blob/main/controllers/jobController.js"
    click UserController "https://github.com/thanushakudumula/job-portal/blob/main/controllers/userController.js"
    click AuthRouter "https://github.com/thanushakudumula/job-portal/blob/main/routes/authRouter.js"
    click JobRouter "https://github.com/thanushakudumula/job-portal/blob/main/routes/jobRouter.js"
    click UserRouter "https://github.com/thanushakudumula/job-portal/blob/main/routes/userRouter.js"
    click UserModel "https://github.com/thanushakudumula/job-portal/blob/main/models/UserModel.js"
    click JobModel "https://github.com/thanushakudumula/job-portal/blob/main/models/JobModel.js"
    click AuthMiddleware "https://github.com/thanushakudumula/job-portal/blob/main/middleware/authMiddleware.js"
    click ValidationMiddleware "https://github.com/thanushakudumula/job-portal/blob/main/middleware/validationMiddleware.js"
    click MulterMiddleware "https://github.com/thanushakudumula/job-portal/blob/main/middleware/multerMiddleware.js"
    click ErrorHandler "https://github.com/thanushakudumula/job-portal/blob/main/middleware/errorHandlerMiddleware.js"
    click TokenUtils "https://github.com/thanushakudumula/job-portal/blob/main/utils/tokenUtils.js"
    click PasswordUtils "https://github.com/thanushakudumula/job-portal/blob/main/utils/passwordUtils.js"
    click Constants "https://github.com/thanushakudumula/job-portal/blob/main/utils/constants.js"
    click MockData "https://github.com/thanushakudumula/job-portal/blob/main/utils/mockData.json"
    click SeedDB "https://github.com/thanushakudumula/job-portal/blob/main/populate.js"

    %% Styles
    classDef frontend fill:#f9f,stroke:#333,stroke-width:1px
    classDef backend fill:#bbf,stroke:#333,stroke-width:1px
    classDef database fill:#bfb,stroke:#333,stroke-width:1px
    classDef middleware fill:#fbf,stroke:#333,stroke-width:1px
    classDef service fill:#ffb,stroke:#333,stroke-width:1px
```
