Hostel Mess Management System is a Django-based web application designed to streamline the management of hostel mess operations. The application allows users to apply for mess cuts, mark attendance via QR code scanning, view and pay mess bills, check weekly menus, and provide feedback.
- Messcut Application: Users can apply for mess cuts with validation for overlapping dates and maximum allowable days per month.
- QR Code Attendance: Mess assistants can scan QR codes to mark attendance, with automatic validation against mess cuts and meal times.
- Mess Bill Management: Users can view and pay their mess bills online. Mess administrators can generate and export bill details.
- Weekly Menu: Users can view the weekly mess menu.
- Feedback System: Users can submit feedback directly through the application.
-
Clone the Repository:
git clone https://github.com/yourusername/hostel-mess-management.git cd hostel-mess-management -
Set Up Virtual Environment:
python3 -m venv venv source venv/bin/activate -
Install Dependencies:
pip install -r requirements.txt
-
Run Migrations:
python manage.py migrate
-
Create a Superuser:
python manage.py createsuperuser
-
Run the Development Server:
python manage.py runserver
-
Access the Application: Open your browser and navigate to
http://127.0.0.1:8000.
Add screenshots here to demonstrate key features of the application.
-
Dashboard:
-
Apply for Messcut:
-
QR Code Scanning:
-
View and Pay Mess Bill:
-
View and Pay Mess Bill:
-
View and Pay Mess Bill:
- Students: Log in to apply for mess cuts, view weekly menus, check and pay your mess bills, and submit feedback.
- Mess Assistants: Use the QR code scanning feature to mark attendance and manage mess operations.
- Admins: Oversee the entire system, manage users, and export bill data to CSV if needed.
Contributions are welcome! Feel free to open issues or submit pull requests.
For any inquiries, please contact us at [email protected].
You can copy and paste this into your `README.md` file on GitHub.