A Virtual Hostel Allotment System designed for universities to allocate hostel rooms fairly and transparently. Unlike first-come-first-serve models, HostelNET uses a systematic and logic-driven approach to ensure unbiased seat allotment for students.
- 🎯 Fair Allotment Logic – eliminates bias and ensures transparent allocation.
- 👨🎓 Student Portal – easy hostel registration and status tracking.
- 🏢 Admin Dashboard – manage hostels, rooms, and student allotments.
- 🔐 Role-based Access – separate access levels for students and admins.
- 💳 (Optional) Payment Gateway integration for hostel fee submission.
- Backend: Django (Python)
- Frontend: HTML, CSS, JavaScript (with Bootstrap / Tailwind)
- Database: MySQL / PostgreSQL
- Payment Gateway: Razorpay (optional)
- Deployment: Docker / Heroku / AWS
HostelNET/
│── hostelnet/ # Core Django project files
│── allotment/ # Hostel allocation logic
│── users/ # Authentication & roles
│── payments/ # Razorpay integration (if enabled)
│── templates/ # HTML files
│── static/ # CSS, JS, Images
│── requirements.txt # Dependencies
│── manage.py
-
Clone the Repository
git clone https://github.com/your-username/HostelNET.git cd HostelNET -
Create Virtual Environment & Install Dependencies
python -m venv venv source venv/bin/activate # On Windows use: venv\Scripts\activate pip install -r requirements.txt
-
Apply Migrations
python manage.py migrate
-
Create Superuser
python manage.py createsuperuser
-
Run Development Server
python manage.py runserver
Now visit 👉 http://127.0.0.1:8000/
flowchart TD
A[Student Registers] --> B{Admin Approval?}
B -- Yes --> C[Allotment Logic Runs]
B -- No --> D[Rejected Notification]
C --> E[Room Assigned]
E --> F[Student Receives Confirmation]
Contributions are welcome!
- Fork the repo
- Create a feature branch
- Commit changes & open a PR
Made with ❤️ by Akshit Sahore