💼 KaajKhojo

Smart Job Portal & Recruitment Platform

A modern MERN Stack Recruitment Platform that connects job seekers, recruiters, and administrators through secure authentication, real-time messaging, video interviews, and intelligent job management.

🚀 Overview

KaajKhojo is a full-stack recruitment platform developed using the MERN Stack to simplify and modernize the hiring process. The platform enables recruiters to post job openings, manage applications, and conduct interviews, while job seekers can create professional profiles, apply for jobs, and communicate directly with recruiters.

The application integrates Socket.IO for real-time messaging and WebRTC for browser-based video interviews, creating a seamless recruitment experience.

---

💡 Project Motivation

Challenge	Solution
Delayed recruiter–candidate communication	💬 Real-time messaging
Disconnected interview workflow	🎥 Integrated WebRTC video interviews
Weak authentication mechanisms	🔐 Secure JWT-based authentication
Scattered recruitment process	📋 Centralized job management
Limited role management	👥 Role-based dashboards
Scalability concerns	☁️ Cloud-ready architecture

🎯 Objectives

Objective	Description
📌 Centralized Platform	Build a unified recruitment system
💬 Better Communication	Improve recruiter and candidate interaction
🔐 Secure Authentication	Enable authentication and authorization
⚡ Scalable Architecture	Develop a responsive, scalable application
⏱ Faster Hiring	Reduce recruitment turnaround time
😊 Better User Experience	Deliver a modern and intuitive interface

✨ Features

👤 Job Seeker	🏢 Recruiter	🛡 Admin
✅ User Registration & Login	✅ Recruiter Registration	✅ Dashboard
✅ Profile Management	✅ Company Profile Management	✅ Manage Users
✅ Resume Upload	✅ Create Job Listings	✅ Manage Recruiters
✅ Browse Jobs	✅ Edit/Delete Jobs	✅ Moderate Job Posts
✅ Search & Filter Jobs	✅ View Applicants	✅ Manage Applications
✅ Apply for Jobs	✅ Shortlist Candidates	✅ Platform Monitoring
✅ Application Tracking	✅ Chat with Candidates
✅ Real-Time Chat	✅ Conduct Video Interviews
✅ Video Interviews

💬 Real-Time Communication

Feature	Description
💬 Socket.IO Live Chat	Instant recruiter–candidate messaging
🎥 WebRTC Video Calling	Browser-based video interviews
🔒 Secure Peer-to-Peer Communication	Encrypted direct communication
🔔 Instant Notifications	Real-time updates and alerts
✅ Chat After Application Approval	Messaging enabled after recruiter approval

---

🛠 Tech Stack

Category	Technologies
Frontend
Backend
Database
Authentication
Real-Time
File Upload
Email Service
Development Tools
Version Control

---

🏗️ System Architecture

---

📁 Project Structure

KaajKhojo/

├── backend/
│   ├── controllers/
│   ├── middleware/
│   ├── models/
│   ├── routes/
│   ├── config/
│   ├── socket/
│   ├── uploads/
│   ├── server.js
│   └── .env
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── hooks/
│   │   ├── services/
│   │   └── utils/
│   └── package.json
│
├── package.json
├── README.md
└── .gitignore

---

⚙ Installation

Clone Repository

git clone https://github.com/jyoti1900/KaajKhojo.git

cd KaajKhojo

Install Backend

cd backend

npm install

Install Frontend

cd ../frontend

npm install

---

🔑 Environment Variables

Create a .env file inside the backend directory.

# Server
PORT=8080
NODE_ENV=development

# Database
MONGO_URI=your_mongodb_connection_string

# Authentication
SESSION_SECRET=your_session_secret
JWT_SECRET=your_jwt_secret

# Admin
ADMIN_EMAIL=admin@kaajkhojo.com
ADMIN_PASSWORD=your_admin_password

# SMTP
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=your_email@gmail.com
EMAIL_PASSWORD=your_app_password

# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

GOOGLE_SIGNUP_CALLBACK=http://localhost:8080/api/v1/auth/google/signup/callback
GOOGLE_LOGIN_CALLBACK=http://localhost:8080/api/v1/auth/google/login/callback

# Frontend
CLIENT_URL=http://localhost:3000

---

▶ Running Locally

Backend

cd backend

npm start

Frontend

cd frontend

npm start

Application runs at:

Frontend : http://localhost:3000

Backend : http://localhost:8080

---

🔐 Authentication & Security

Security Feature	Description
🔑 JWT Authentication	Secure user authentication using JSON Web Tokens
🛡 Express Sessions	Session management for authenticated users
👥 Role-Based Authorization	Access control for Admin, Recruiter, and Job Seeker
🔒 Protected API Routes	Restricts unauthorized API access
🔐 Password Hashing	Encrypts user passwords before storage
✅ Input Validation	Validates incoming user data
📂 Secure File Uploads	Safely uploads resumes and documents
⚙ Environment Variable Protection	Secures sensitive application credentials

📦 API Modules

Module	Description
🔐 Authentication	User registration, login, JWT, and session management
👤 Users	User profile and account management
🏢 Recruiters	Recruiter profiles and company management
💼 Jobs	Job creation, updates, and listings
📄 Applications	Job application submission and tracking
📎 Resume Upload	Resume upload and document management
💬 Chat	Real-time recruiter–candidate messaging
🎥 Video Interview	WebRTC-based online interviews
📊 Admin Dashboard	Platform monitoring and management

⚡ Performance Optimizations

Optimization	Benefit
🏗 Modular MVC Architecture	Improves maintainability and scalability
🔗 RESTful API Design	Efficient and standardized API communication
🍃 MongoDB Query Optimization	Faster database performance
⚡ Efficient Socket.IO Handling	Low-latency real-time communication
🚀 Lazy Component Loading	Faster initial page load
⚛ Optimized React Rendering	Reduces unnecessary re-renders
☁️ Scalable Backend Structure	Supports increasing user traffic

🧪 Experimental Results

Result	Impact
💬 Faster Recruiter Response	Improved communication through real-time chat
🎥 Integrated Video Interviews	Reduced reliance on third-party meeting tools
📈 Higher Candidate Engagement	Better interaction with recruiters
☁️ Scalable Architecture	Supports multiple concurrent users
📋 Centralized Workflow	Simplified recruitment management

🚧 Challenges Faced

Challenge	Solution
🎥 WebRTC Peer-to-Peer Communication	Implemented browser-based video calling
🔄 Socket.IO Synchronization	Managed real-time communication across users
🔐 Role-Based Route Protection	Secured APIs based on user roles
📎 Secure Resume Uploads	Implemented protected file upload handling
🔗 Workflow Integration	Connected chat and interviews with job applications

🚀 Future Enhancements

Feature	Description
🤖 AI Job Recommendation	Personalized job suggestions
📧 Email Notifications	Automated email updates
🔔 Push Notifications	Real-time browser notifications
📊 Analytics Dashboard	Recruitment insights and reporting
📅 Interview Scheduling	Built-in interview planner
🐳 Docker & Kubernetes	Container orchestration and scalability
⚙ CI/CD Pipeline	Automated build, testing, and deployment

---

👨‍💻 Development Team

Team Member	Contribution
Jyotipriya Das	Project Lead, Backend Development, API Design, Database Architecture
Sayan Pal	Frontend Development, Testing, Debugging
Indrajit Sahu	User & Recruiter Frontend Modules
Hasanoor Zaman	Admin Dashboard Development

---

🤝 Contributing

Contributions are welcome!

1. Fork the repository

2. Create a feature branch

git checkout -b feature/new-feature

3. Commit your changes

git commit -m "Add new feature"

4. Push to GitHub

git push origin feature/new-feature

5. Open a Pull Request

---

📜 Conclusion

KaajKhojo demonstrates the development of a modern recruitment platform that combines secure authentication, intelligent job management, real-time communication, and browser-based video interviews into a unified ecosystem. Its modular architecture, scalable backend, and responsive frontend make it suitable for real-world recruitment workflows and future enterprise enhancements.

---

📄 License

This project is licensed under the MIT License.

---

⭐ If you found this project useful, consider giving it a Star on GitHub!