🚀 PlaceMax

PlaceMax is a full-stack MERN-based Placement Management System that simplifies campus recruitment by connecting students and placement administrators on a single platform. The application allows students to apply for placement drives while enabling administrators to efficiently manage companies, drives, and student records.

---

✨ Features

👨‍🎓 Student

• Secure Registration & Login
• JWT Authentication
• College Email Verification
• Update Student Profile
• Browse Eligible Companies
• Apply for Placement Drives
• Track Application Status

👨‍💼 Admin

• Secure Admin Dashboard
• Manage Students
• Add/Edit/Delete Companies
• Create Placement Drives
• View Applications
• Batch-wise Student Filtering
• Placement Statistics Dashboard

---

🛠 Tech Stack

Frontend

• React.js
• React Router
• Axios
• Bootstrap / CSS

Backend

• Node.js
• Express.js
• JWT Authentication
• bcrypt.js

Database

• MongoDB Atlas
• Mongoose

---

📁 Folder Structure

PlaceMax
│
├── client
│   ├── public
│   ├── src
│   │   ├── components
│   │   ├── pages
│   │   ├── services
│   │   └── App.js
│   └── package.json
│
├── server
│   ├── config
│   ├── controllers
│   ├── middleware
│   ├── models
│   ├── routes
│   ├── utils
│   ├── server.js
│   └── package.json
│
└── README.md

---

⚙️ Installation

1. Clone the Repository

git clone https://github.com/krishnam2003/PlaceMax.git
cd PlaceMax

2. Install Backend

cd server
npm install

Create a .env file inside the server folder.

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key
CLIENT_URL=http://localhost:3000

Run the backend:

npm run dev

---

3. Install Frontend

cd client
npm install
npm start

Frontend runs at:

http://localhost:3000

Backend runs at:

http://localhost:5000

---

🔒 Authentication

• JWT Authentication
• Protected Routes
• Password Hashing (bcrypt)
• Role-based Authorization

---

🚀 Future Enhancements

• Resume Upload
• Email Notifications
• Interview Scheduling
• Real-time Notifications
• Analytics Dashboard
• Export Reports (Excel/PDF)

---

📸 Screenshots

Add screenshots inside a screenshots/ folder.

Example:

screenshots/
├── login.png
├── dashboard.png
├── companies.png
└── applications.png

---

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create a feature branch

git checkout -b feature-name

3. Commit your changes

git commit -m "Add feature"

4. Push your branch

git push origin feature-name

5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License.

---

👨‍💻 Author

Krishnam Singh

GitHub: https://github.com/krishnam2003