Skip to content

README.md

Latest commit

 

History

History
103 lines (65 loc) · 2.72 KB

README.md

File metadata and controls

103 lines (65 loc) · 2.72 KB
Raw

💼 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:

🚀 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