/Hostel_Management

A user-centric platform designed for hostel authorities to efficiently manage operations, reducing reliance on Excel by 75%.

Primary LanguageJavaScript

Hostel Management System 🏨

Project Duration 🗓️: December 2023 – March 2024

Project Description 📃: A user-centric platform designed for hostel authorities to efficiently manage operations, reducing reliance on Excel by 75%. The system includes features like secure user authentication, student profile management, room allocation, fee management, leave management, and report management.

Table of Contents 📋

  1. About the Project
  2. Tech Stack
  3. Features
  4. Installation
  5. Contact

About the Project ⓘ

Overview

The Hostel Management System is a comprehensive solution for hostel authorities to manage day-to-day operations. It streamlines processes like room allocation, fee management, and leave tracking, significantly reducing manual effort and errors.

Live Demo

Link to Live Demo

Screenshots 🖵

HomePage 🏠

Home Page

Login Page 🔐

Login Page

Admin Dashboard 📊

Admin Dashboard

Student Profile Page 🙎🏻‍♂️

Student Profile Page

New Admission Form Page 📝

New Admission Form Page

Room Allocation 🛏️

Room Allocation

Leave Page 📝

Leave Page

Accountant Dashboard Page 📊

Accountant Dashboard Page

New Fee add Page 💵

New Fee add Page

Due Fees Page 🗓️

Due Fees Page

Fee Status Page ( Accountant ) 🗃️

Fee Status Page Accountant

Fee Status Page ( Student ) 💸

Fee Status Page Student

Online Fee Payment 💳

Online Fee Payment

Tech Stack 🚀📋

  • Frontend: React, Shadcn-ui, Flowbite, Recharts, Framer-motion, Yup, Formik
  • Backend: Node.js, Express.js
  • Database: MongoDB, Mongoose
  • Payment Integration: Razorpay
  • Automation/Testing: Puppeteer
  • Hosting: Netlify, Render
  • Version Control: Git, GitHub

Features 📱🖥️

  • Secure User Authentication: Ensures that only authorized users can access the system.
  • Student Profile Management: Manage and update student profiles efficiently.
  • Room Allocation: Simplifies the process of allocating rooms to students.
  • Fee Management: Includes online fee collection via Razorpay and allows generation and downloading of fee receipts.
  • Leave Management: Tracks student absences in real-time, providing accurate data on student presence in the hostel.
  • Report Management: Generate reports on various operations, aiding in better decision-making.

Installation

Prerequisites

  • Node.js (version)
  • MongoDB (local or cloud setup)
  • npm or yarn

Setup ⚙️

  1. Clone the repository: 
    git clone https://github.com/DhavalDudheliya/Hostel_Management.git
cd Hostel_Management
  2. Install dependencies: 
    # Install server dependencies
cd backend
npm install

# Install client dependencies
cd ../frontend
npm install
  3. Set up environment variables:

    Backend

    MONGO_URL = mongodb+srv://hostelmanagementowners:aMdVx1kEXXYfq5lN@cluster0.yr1psfu.mongodb.net/?retryWrites=true&w=majority PORT = 4004 CLIENT_URL = http://localhost:5173 JWT_SECRET = qpwoeirutyalskdjfhgzmxncbv MAIL_SENDER = apcnadiad13@gmail.com MAIL_PASS = boyxfoqqmrdvofte

ROZORPAY_API_KEY = rzp_test_i3xNVjNQutiV0I ROZORPAY_API_SECRET = NGMfbMPKZAOnJkWiw89CCSg1

VONAGE_API_KEY = b8986d3f; VONAGE_API_SECRET = UEfTmdIHLK5MTfe3;

  1. Run the project: 
    # Run frontend and backend conncurently
cd hostel_management
npm run start

# Run the backend
cd backend
npm run dev

# Run the frontend
cd ../frontend
npm start

Contact 📩📞