Candidate Referral Management System

Features Implemented

Frontend

• Dashboard: View all candidates with filtering by job title/status
• Referral Form: Submit new candidates with PDF resume upload
• Status Management: Update candidate status (Pending → Reviewed → Hired)
• Search: Find candidates by name or job title
• Responsive Design: Works on mobile and desktop
• client/ ├── public/ # Static files │ ├── index.html │ └── favicon.ico ├── src/ │ ├── assets/ # Media files │ │ ├── images/ │ │ └── styles/ │ ├── components/ # Reusable UI components │ │ ├── common/ │ │ │ ├── Button/ │ │ │ ├── Card/ │ │ │ └── ... │ │ └── layout/ │ │ ├── Header/ │ │ └── Footer/ │ ├── pages/ # Route-level components │ │ ├── Dashboard/ │ │ ├── ReferralForm/ │ │ └── ... │ ├── services/ # API connections │ │ ├── api.js │ │ └── candidateService.js │ ├── utils/ # Helper functions │ ├── contexts/ # React contexts │ ├── hooks/ # Custom hooks │ ├── App.jsx │ ├── main.jsx │ └── routes.jsx ├── .env.development # Frontend env vars ├── .env.production └── package.json

Backend

• REST API: CRUD operations for candidates
• File Handling: Secure PDF uploads
• Validation: Email, phone, and file type validation
• MongoDB: Persistent data storage ├── server/ # Node.js backend │ ├── controllers/ # Route controllers │ ├── models/ # MongoDB models │ ├── routes/ # API routes │ ├── middleware/ # Custom middleware │ ├── app.js # Express application │ ├── server.js # Server entry point │ └── package.json # Backend dependencies └── README.md # Project documentation

How to Run Locally

Prerequisites

• Node.js (v16+)
• MongoDB (local or Atlas cluster)
• Git

Setup Instructions

1. Clone the repository

   git clone https://github.com/yourusername/candidate-referral-system.git
   cd candidate-referral-system