1. Project title and short intro text

Campus Placement Management System

A web-based Campus Placement Management System built using Java, JSP, Servlets, JDBC, and MySQL. It digitizes the college placement process by providing separate portals for students and admins to manage profiles, companies, drives, and applications end to end.

Campus Placement Management System

This is the name of your project. It appears as the main heading on GitHub.

The next sentence quickly tells:

It is a web application (runs in browser).

It is built with Java, JSP, Servlets, JDBC, MySQL (tech stack).​

It has two roles: student and admin, and it handles the whole placement flow (profiles → companies → drives → applications).​

This helps visitors immediately know what your project does and what technologies you used.​

2. Features section text

Features

• Student module

  • Student registration and login.
  • View / update profile (branch, CGPA, skills, resume link).
  • Browse companies and placement drives and apply online.
  • View list of applied drives and track current status/stage.

• Admin module

  • Admin login and dashboard.
  • Manage companies (add/update/delete) with role, location, package, eligibility, etc.
  • Create and manage placement drives for companies.
  • View applicants per drive and update application status and stage.

• UI / Tech

  • Responsive, colorful UI using Bootstrap 5 for dashboards, tables, and forms.
  • Clear separation of student and admin flows.

Features

Second‑level heading. Shows what the app can do.​

Student module bullets:

Registration/login: students can create accounts and sign in.​

Profile: store branch, CGPA, skills, resume link, etc.

Browse & apply: see list of companies and drives and click Apply.

Track status: see where each application is in the selection pipeline (APPLIED, SHORTLISTED, etc.).​

Admin module bullets:

Admin has a secure login and dashboard.

Manage companies: CRUD operations with job details and eligibility.​

Manage drives: schedule placement drives per company.

View applicants per drive: see students and update status/stage.​

UI / Tech bullets:

Uses Bootstrap 5 to make pages look modern and responsive (good on laptop and mobile).​

Student and admin pages are clearly separated to avoid confusion.

This section is useful for recruiters and other developers to quickly see the functionality without reading code.​

3. Tech Stack section text

Tech Stack

• Backend: Java, JSP, Servlets (JDBC-based DAOs).
• Frontend: HTML5, CSS3, Bootstrap 5.
• Database: MySQL.
• Server: Apache Tomcat (tested with Eclipse Dynamic Web Project).

Tech Stack

Tells which technologies are used in each layer.​

Backend:

Java: main language.

JSP + Servlets: for web pages and controllers.​

JDBC-based DAOs: classes that talk to the database.​

Frontend:

HTML5, CSS3: structure and styling.

Bootstrap 5: for ready-made styling, components, and responsive layout.​

Database:

MySQL: relational database where all data is stored.​

Server:

Apache Tomcat: Java web server to run JSP/Servlets, used via Eclipse Dynamic Web Project configuration.​

This section shows your technical skills clearly on your GitHub profile.​

4. Getting Started section This explains how someone else can run your project step by step.

text

Getting Started

1. Clone the repository

git clone https://github.com/UmeshDc13/campus-placement-management-system.git

text undefined Step 1: Clone

Command copies the project from GitHub to their local machine.​

They should run it in terminal/command prompt.

text 2. Import into Eclipse

• File → Import → Existing Projects into Workspace → select the cloned folder. Step 2: Import into Eclipse

“Existing Projects into Workspace” tells Eclipse to treat the cloned folder as a Java project.​

Very common step when sharing Java projects via Git.

text 3. Configure database

• Create a MySQL database named placement.

• Ensure the JDBC URL matches:

  jdbc:mysql://localhost:3306/placement
  

• Update DB username and password in the servlets/DAO classes (currently using "root" / "sql123"). Step 3: Database setup

Create a DB called placement in MySQL.​

JDBC URL must match what you used in your code.

If their MySQL username/password is different, they must change it in your Java code (probably in Connection calls).

text 4. Run on Tomcat

• Add the project to your Apache Tomcat server in Eclipse.

• Start the server and open the app in the browser, for example:

  http://localhost:8080/campus-placement-management-system
  

• Adjust the context path if your project name is different in Eclipse/Tomcat. Step 4: Run the app

Add project to Tomcat in Eclipse (Servers tab → Add and Remove).​

Start Tomcat; then access the app in a browser using the context path (usually project name).

“Adjust context path” is a reminder that the URL changes if the project is deployed under a different name.

These steps make it easy for others to run your project without asking you.​

5. Screens section text

Screens (suggested)

• Student: Registration, Login, Dashboard, Available Drives, My Applications.
• Admin: Login, Dashboard, Manage Companies, Manage Drives, Drive Applicants, Analytics. This tells what pages exist in the app and what screenshots someone can expect.

It also helps you prepare screenshots for interviews and your portfolio, showing each main flow.​

6. Future Enhancements section text

Future Enhancements

• Eligibility checker on student drive list (CGPA/branch-based).
• Email alerts to students when status changes to SELECTED/REJECTED using JavaMail. This section shows that: You have ideas to improve the project further.

You understand additional real-world features like eligibility checks and email alerts.

explain the login and usage flow clearly.

text

How to Use

1. Student flow

1. Open the app in your browser:

http://localhost:8080/campus-placement-management-system

text

2. Go to the Student Registration page and create a new account with:

• USN, name, email, password
• Branch, CGPA, skills, and resume link

3. After registration, open the Student Login page and sign in using:

• Email
• Password

4. Once logged in, you can:

• Open Dashboard to see quick actions
• View / update your Profile
• View Companies & Drives and apply for suitable drives
• Open My Applications to track your application status and stage

2. Admin flow

1. Open the Admin Login page:

http://localhost:8080/campus-placement-management-system/admin-login.jsp

text

2. Log in with the admin credentials configured in the database (for example: a row in the admin table with username and password).

3. After login, from the Admin Dashboard you can:

• Manage Companies: add/update/delete company records with job details
• Manage Drives: create placement drives mapped to companies
• View Applicants: select a drive and see all student applicants
• Update Status/Stage: change each applicant’s status (APPLIED, SHORTLISTED, INTERVIEW, SELECTED, REJECTED) and stage
• View Analytics: see basic statistics like students per branch or applications per company

You have ideas to improve the project further.

You understand additional real-world features like eligibility checks and email alerts.​