College Placement Management System

Table of Contents

• Introduction
• Features
• Tech Stack
• Project Structure
• User Roles
• Installation
• Contributors

Introduction

The College Placement Management System is a web application designed to streamline the placement process in educational institutions. This system provides distinct roles for students, TPO (Training and Placement Officer) admin, management admin, and super admin, ensuring a smooth and efficient workflow.

Features

• Student Portal: Students can view available job opportunities, apply for placements, and track their application status.
• TPO Admin Portal: TPO admins can manage job postings, schedule interviews, and track student progress.
• Management Admin Portal: Management can oversee the entire placement process, view reports, and analyze data.
• Super Admin Portal: The super admin can manage system settings, user accounts, and oversee the management of TPO and management users.

Tech Stack

• Frontend: Vite + React.js, Tailwind CSS, Bootstrap
• Backend: Node.js, Express.js
• Database: MongoDB
• Authentication: JSON Web Tokens (JWT)
• Styling: Tailwind CSS, Bootstrap

Project Structure

├── frontend
│   ├── public
│   ├── src
|   |   ├── api
|   |   ├── assets
│   │   ├── components
|   |   |   ├──LandingPages
|   |   |   └──students
│   │   ├── config
│   │   ├── context
│   │   ├── hooks
│   │   ├── pages
│   │   ├── styles
│   │   ├── utility
│   │   ├── App.jsx
│   │   └── main.jsx
│   ├── .gitignore
│   ├── .eslint.config.js
│   ├── index.html
│   ├── package-lock.json
│   ├── package.json
│   ├── postcss.config.js
│   ├── tailwind.config.js
│   └── vite.config.js
├── backend
│   ├── config
│   ├── controllers
│   ├── middleware
│   ├── models
│   ├── public
│   │   └──  offerLetter
│   │   └──  resumes
│   │   └──  profileImgs
│   │         └── default
│   ├── routes
│   ├── .env (NOTE: YOU NEED TO CREATE THIS FILE)
│   ├── .gitignore
│   ├── index.js
│   ├── package.json
│   └── package-lock.json
└── README.md

User Roles

• Students: Can view and apply for job opportunities, update profiles, and track their application status.
• TPO Admin: Manages job postings, student applications, and interviews.
• Management Admin: Oversees the placement process, views reports, and analyzes placement data.
• Super Admin: Manages the overall system, creates new admin users (TPO and Management), and manages system-level settings.

Installation

Prerequisites

• Node.js and npm installed
• MongoDB installed and running

Clone the Repository

git clone https://github.com/moinmn/college-placement-management-system.git
cd college-placement-management-system

Backend Setup

1. Navigate to the backend folder:

   cd backend

2. Install the necessary packages:

   npm install

3. Create a .env file for environment variables:

   MONGO_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret

4. Start the backend server:

   npm start

Frontend Setup

1. Navigate to the frontend folder:

   cd frontend

2. Install the necessary packages:

   npm install

3. Start the frontend development server:

   npm run dev

Contributors

• Member 1: Moin MN
• Member 2: Rafat Muskan Shaikh
• Member 3: Saquib Patel
• Member 4: Neeraj Kumar