💼 CareerHub - Jobs, Interviews & Recruitment Management System

A full-stack recruitment management platform with role-based access for Admins, Recruiters, and Applicants.

---

📋 Prerequisites

Make sure the following are installed on your system:

• Node.js - tested on v16.15.0
• JDK 17 - required for the backend
• MySQL Workbench - or any MySQL server

---

🚀 Installation & Setup

Step 1 - Configure the Backend

Navigate to the backend configuration file:

jobs&interviews&recrutement management system/backend/src/main/resources/application.properties

Inside application.properties, update the following as needed:

• Database credentials: change username and password to match your MySQL setup
• Database name: defaults to careerhub. If you rename it, make sure to create a matching database in MySQL Workbench

---

Step 2 - Start the Backend

Make sure your MySQL server is running, then launch the Spring Boot application.

Once running, all API endpoints will be available and can be tested with Postman.

⚠️ The backend must be running before starting the frontend.

---

Step 3 - Set Up & Start the Frontend

Open a terminal in your IDE (e.g. WebStorm) and run the following commands:

# Navigate to the frontend directory
cd "jobs&interviews&recrutement management system/frontend"

# Install dependencies
npm install --legacy-peer-deps

# Start the development server
npm start

The --legacy-peer-deps flag helps avoid compatibility issues between packages.

---

Step 4 - Open the Application

Once both servers are running, visit:

http://localhost:3000

---

🔐 Authentication & Roles

The application supports three user roles, each with its own access point:

Role	Login URL	Notes
Admin	http://localhost:3000/authenticate	Create an admin account directly in the database to access the admin interface
Recruiter	http://localhost:3000	Sign in via the regular sign-in interface
Applicant	http://localhost:3000	Sign in via the regular sign-in interface

---

🗂️ Project Structure

jobs&interviews&recrutement management system/
├── backend/        # Spring Boot application (JDK 17)
│   └── src/main/resources/application.properties
└── frontend/       # React application (Node.js v16.15.0)

---

🛠️ Tech Stack

Layer	Technology
Frontend	React (Node.js v16.15.0)
Backend	Spring Boot (JDK 17)
Database	MySQL (via MySQL Workbench)
API Testing	Postman