# b30wulffz/job-portal architecture

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

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

## Overview

##### Project type and purpose
- This is a full‑stack MERN (MongoDB, Express, React, Node.js) web application called “Job Portal.”
- Purpose: Allow two user roles (applicant and recruiter) to manage job postings and applications via a persistent, JWT‑protected RESTful backend and a React SPA frontend.

##### File structure
- Top‑level directories:
- backend/ – Node.js + Express server, data models, authentication, file‐upload & download routes
- frontend/ – Create React App, UI components, utility libs, static public assets
- dummyData/ – seed or mock JSON data for local testing (not a runtime dependency)
- backend/ folders:
- db/ – Mongoose schemas (User, Recruiter, Job, Application, Rating)
- lib/ – JWT & Passport configuration, auth key storage
- routes/ – REST endpoints organized by concern (auth, APIs, file upload/download)
- server.js – Express app entrypoint (middleware, route registration, MongoDB connection)
- frontend/ folders:
- public/ – static index.html, manifest, robots.txt
- src/component/ – page components (Login, Signup, Home, Profile, plus recruiter sub‑folder)
- src/lib/ – UI helper components (inputs, popups) and auth/API utilities
- App.js & index.js – bootstraps React SPA and routing
- Key configuration files: package.json (backend & frontend), .gitignore, README.md

##### Extract architecture insights from the README
- Backend runs on port 4444, frontend on port 3000.
- MongoDB is the primary data store; file uploads (profile pictures, resumes) saved in backend/public subfolders.
- Authentication: persistent sessions (express‑session + connect‑mongo) and JWT for protected REST routes.

##### Main components and their relationships
a. Frontend (React SPA)
- UI Components → communicate via Axios/Fetch to Backend REST API
- Routes managed by React Router (inside App.js)
b. Backend (Express)
- HTTP middleware: CORS, body‑parser, session management, Passport JWT strategy
- REST API controllers (apiRoutes.js) handle CRUD for jobs, applications, users
- Auth endpoints (authRoutes.js) for signup/login; issue JWT tokens
- Upload/download endpoints (uploadRoutes.js, downloadRoutes.js) using Multer
- Data Access Layer: Mongoose models under backend/db/
- File Storage: local folders under backend/public/profile and backend/public/resume
c. Database (MongoDB)
- Collections: users, recruiters, jobs, applications, ratings
d. External/internal services
- Mail/notification (if any—currently not present)
- Local file system for profile/resume storage

##### Architectural patterns & design principles
- Layered architecture:
- Presentation (React) → API (Express Routes) → Business Logic (controllers in routes, lib/auth) → Data Access (Mongoose models) → Data Store (MongoDB + file system)
- RESTful design: standard HTTP verbs for CRUD
- JWT + session hybrid: protects API endpoints
- MVC‑like separation: models (db/), controllers (routes/), views (React)
- Single‑page application on the client; stateless interactions via JWT

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (React SPA)"
      direction TB
      Browser["Browser / React SPA<br>Create React App, Material-UI"]:::frontend
      Index["Entry Point (index.js)"]:::frontend
      App["App.js (Routing)"]:::frontend
      Components["UI Components<br>(frontend/src/component)"]:::frontend
      Utils["Utilities (API, Auth, UI libs)"]:::frontend
      Axios["HTTP Client (axios)"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Express Server)"
      direction TB
      Server["server.js<br>Node.js, Express, body-parser, cors, multer"]:::backend
      Middleware["Middleware & Auth Layer<br>jsonwebtoken, passport, passport-jwt, bcrypt, express-session"]:::backend
      AuthRoutes["Auth Routes<br>authRoutes.js"]:::backend
      APIRoutes["API Routes<br>apiRoutes.js"]:::backend
      UploadRoutes["Upload Routes<br>uploadRoutes.js"]:::backend
      DownloadRoutes["Download Routes<br>downloadRoutes.js"]:::backend
      Models["Mongoose Models<br>backend/db"]:::data
      FileStorage["File Storage<br>backend/public/profile & resume"]:::storage
    end

    %% Data Store
    subgraph "Data Store"
      direction TB
      MongoDB["MongoDB<br>Collections: users, recruiters, jobs, applications, ratings"]:::data
      FileStorage
    end

    %% Connections
    Browser -->|loads SPA| Index
    Index -->|initializes| App
    App -->|renders| Components
    Components -->|uses| Axios

    Axios -->|POST /login→JWT| AuthRoutes
    Axios -->|CRUD /api| APIRoutes
    Axios -->|POST /upload| UploadRoutes
    Axios -->|GET /download| DownloadRoutes

    Server --> Middleware
    Middleware --> AuthRoutes
    Middleware --> APIRoutes
    Server --> APIRoutes
    Server --> UploadRoutes
    Server --> DownloadRoutes

    AuthRoutes -->|CRUD| Models
    APIRoutes -->|CRUD| Models
    UploadRoutes -->|write files| FileStorage
    DownloadRoutes -->|read files| FileStorage

    Models -->|Mongoose CRUD| MongoDB

    %% Click Events
    click Index "https://github.com/b30wulffz/job-portal/blob/main/frontend/src/index.js"
    click App "https://github.com/b30wulffz/job-portal/blob/main/frontend/src/App.js"
    click Components "https://github.com/b30wulffz/job-portal/tree/main/frontend/src/component"
    click Utils "https://github.com/b30wulffz/job-portal/tree/main/frontend/src/lib"
    click Server "https://github.com/b30wulffz/job-portal/blob/main/backend/server.js"
    click Middleware "https://github.com/b30wulffz/job-portal/blob/main/backend/lib/jwtAuth.js"
    click Middleware "https://github.com/b30wulffz/job-portal/blob/main/backend/lib/passportConfig.js"
    click Middleware "https://github.com/b30wulffz/job-portal/blob/main/backend/lib/authKeys.js"
    click APIRoutes "https://github.com/b30wulffz/job-portal/blob/main/backend/routes/apiRoutes.js"
    click AuthRoutes "https://github.com/b30wulffz/job-portal/blob/main/backend/routes/authRoutes.js"
    click UploadRoutes "https://github.com/b30wulffz/job-portal/blob/main/backend/routes/uploadRoutes.js"
    click DownloadRoutes "https://github.com/b30wulffz/job-portal/blob/main/backend/routes/downloadRoutes.js"
    click Models "https://github.com/b30wulffz/job-portal/tree/main/backend/db"
    click FileStorage "https://github.com/b30wulffz/job-portal/tree/main/backend/public"

    %% Styles
    classDef frontend fill:#AEDFFD,stroke:#0366d6,color:#000;
    classDef backend fill:#C6F6D5,stroke:#2F855A,color:#000;
    classDef data fill:#FEDCBA,stroke:#DD6B20,color:#000;
    classDef storage fill:#E2E8F0,stroke:#A0AEC0,color:#000;
```
