# College Placement Management System (CPMS) A full-stack web application built for managing college placements. Supports three roles: **Student**, **Recruiter**, and **Admin**, with role-based JWT authentication, a responsive UI (Tailwind CSS), and a MongoDB backend. ## Tech Stack * **Frontend:** React, Vite, Tailwind CSS, React Router, Axios * **Backend:** Node.js, Express, Mongoose, JWT, bcryptjs * **Database:** MongoDB --- ## 🚀 Setup Instructions ### 1. Prerequisites Ensure you have the following installed: - [Node.js](https://nodejs.org/) (v16+) - [MongoDB](https://www.mongodb.com/try/download/community) (Running locally on `mongodb://127.0.0.1:27017/`) ### 2. Backend Setup 1. Open a terminal and navigate to the `server` directory: ```bash cd server ``` 2. Install dependencies: ```bash npm install ``` 3. Start the server (runs on port 5000): ```bash npm run dev ``` ### 3. Frontend Setup 1. Open a new terminal and navigate to the `client` directory: ```bash cd client ``` 2. Install dependencies: ```bash npm install ``` 3. Start the development server (runs on port 5173): ```bash npm run dev ``` ### 4. Application Flow 1. Open your browser to `http://localhost:5173`. 2. **Register** a new account. You can choose to be a `student`, `recruiter`, or `admin` directly during registration. 3. Test the flow: - **Student:** View eligible jobs, apply to jobs, track application status. - **Recruiter:** Post new jobs, review applications for your jobs, update applicant status to shortlisted/selected/rejected. - **Admin:** View the admin dashboard to see system stats and manage (delete) users. _Note: If a student creates an account, their initial CGPA is 0. They will only see jobs with 0 requirement. To test the CGPA filter fully, apply updates to the profile manually or enhance the App with a profile editor._ # CPMA