HostelConnect is a modern, web-based hostel management system developed using Django and Bootstrap. It simplifies hostel operations by digitizing student data, rent management, and visitor communication, while offering a clean, responsive UI suitable for mobile and desktop use.
The system is designed to manage student accommodation effectively, providing a reliable interface for both administrators and hostel residents. Visitors can explore facilities and submit contact inquiries, while students can log in to manage complaints and view personal details.
Video Recording is provided in above files.
💡 The UI design and Bootstrap styling were implemented with the help of ChatGPT, which also assisted with code optimization, debugging, and mobile responsiveness.
🎯 Objective
The goal of this project is to simplify hostel operations such as room inquiry, student registration, rent management, and complaints, by digitizing them into a centralized platform that is mobile-friendly and easy to use.
🔧 Key Features
🌐 For Visitors
-
Explore hostel images and facilities
-
Contact form for booking-related inquiries
-
View location using embedded Google Maps
-
List of all amenities (Wi-Fi, meals, inverter, washing machine, etc.)
-
Home Page -
- Services Page -
👨🎓 For Students
-
Secure login system
-
View personal profile and facilities
-
Submit complaints or feedback
-
See complaints responses given by admin
-
Stay informed about hostel services
-
Student login -
-
Student dashboard -
🧑💼 For Admin
-
View and manage student data
-
Track and manage rent payments
-
Receive and respond to complaints
-
Access contact inquiries from visitors
-
📱 Frontend
-
Built with Bootstrap 5 for responsive design
-
Clean, attractive, and optimized UI
-
Image carousel, icons, and feature cards for a modern look
🛠️ Backend
-
Built using Django (Python)
-
Uses SQLite database (can be upgraded to PostgreSQL)
-
Models for Students, Complaints, Rent, and Contacts
-
CSV Export feature in the admin panel for downloading student data
-
Admin panel for complete control
🛡️ Security
-
CSRF protection on all forms
-
Only authenticated users (students/admin) can access protected data
-
No Online Payment Integration Rent payments are not handled online; it only stores data manually.
-
No Automated Email Alerts No system for auto-sending email notifications for rent due, complaint status, etc.
-
Lacks Role-based Authorization All admin users have the same privileges; no granular roles like warden, accountant, etc.
-
No Room Allotment System Students aren’t assigned specific rooms through the system.
-
Single Admin Model No support for multi-admin handling or hostel branches.
-
Basic Complaint Management Complaints can be submitted but not marked as “Resolved” with status tracking.
👤 User Roles
Visitor: Contact form for booking inquiry
Student: Login to access profile & complaint box
Admin: Manages all operations via dashboard
🔮 Future Updates (Planned) ✅ Online Payment Gateway Allow students to pay rent using Razorpay/Paytm and auto-update rent status.
✅ Student Registration Flow Add a student self-registration form with admin approval.
✅ Room Allotment & Availability Enable real-time room allocation and view of available beds.
✅ Notification System Email/SMS alerts for payment reminders, complaint replies, etc.
✅ Admin Roles Create separate dashboards/privileges for different hostel staff (warden, accountant, etc.)
✅ Search & Filter in Admin Panel Add ability to search/filter students by name, room, status, etc.
✅ Data Backup/Export Feature for admins to download all data in Excel or CSV format.
How to Run: Clone or download the project folder.
Open terminal / command prompt in the project root directory.
Create and activate a virtual environment:
python -m venv venv venv\Scripts\activate (Windows) source venv/bin/activate (Mac/Linux) Install Django:
pip install django Run migrations:
python manage.py makemigrations python manage.py migrate Run the server:
python manage.py runserver Open in browser: http://127.0.0.1:8000/
Developer Info:
Created by Ayush GitHub: github.com/AyushGaikwad84 Email: ayushsgaikwad8480@gmail.com
Note:
This project was made for learning purposes only. It includes basic functionality and can be further enhanced for production use.