-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
5d43258
commit 3097918
Showing
1 changed file
with
108 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,46 +1,133 @@ | ||
# Mess Website - Website for Dining Facility at IIT Indore | ||
A Django-based software project that simplifies the process of applying for rebates by students. | ||
<a name="readme-top"></a> | ||
|
||
# Mess Website - Website for Central Dining Facility at IIT Indore | ||
A Django-based software project that automates and digitalises the complete dining system of IIT Indore. | ||
|
||
## Features | ||
- Automated rebate rule checks | ||
- Student information access | ||
- Admin allocation | ||
- Automated allocation of caterers | ||
- Email notifications | ||
- Billing automation | ||
|
||
Ongoing development of additional features ... | ||
|
||
## Note to Developers | ||
<!-- TABLE OF CONTENTS --> | ||
<details> | ||
<summary>Table of Contents</summary> | ||
<ol> | ||
<li> | ||
<a href="#about-the-project">About The Project</a> | ||
<ul> | ||
<li><a href="#built-with">Built With</a></li> | ||
</ul> | ||
</li> | ||
<li> | ||
<a href="#getting-started">Getting Started</a> | ||
<ul> | ||
<li><a href="#prerequisites">Prerequisites</a></li> | ||
<li><a href="#installation">Installation</a></li> | ||
</ul> | ||
</li> | ||
<li><a href="#roadmap">Roadmap</a></li> | ||
<li><a href="#contact">Contact</a></li> | ||
</ol> | ||
</details> | ||
|
||
## About the Project | ||
|
||
The Mess Website is a Django-based software project that automates and digitalises the complete dining system of IIT Indore. It is a web application that provides a platform for students to fill short and long rebates, caterer allocation forms, access their dining bills and other information. It also provides a platform for the institute's administrations to manage the dining system and the students of IIT Indore. | ||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p> | ||
|
||
### Built With | ||
|
||
* [![Django][Django]][Django-url] | ||
* [![SQlite][SQlite]][SQlite-url] | ||
* [![Bootstrap][Bootstrap]][Bootstrap-url] | ||
* [![python][python]][python-url] | ||
* [![Docker][Docker]][Docker-url] | ||
* [![Gunicorn][Gunicorn]][Gunicorn-url] | ||
* [![Nginx][Nginx]][Nginx-url] | ||
|
||
## Getting Started | ||
|
||
Follow these instructions to set up and run the project locally on your machine. | ||
|
||
### Prerequisites | ||
|
||
Before you begin, ensure you have the following installed: | ||
|
||
- Python 3.10 + | ||
|
||
### Installation | ||
|
||
1. Clone the repository | ||
|
||
### Setup | ||
- Clone the repository | ||
```shell | ||
$ git clone https://github.com/DaemonLab/Mess-Website.git | ||
git clone https://github.com/DaemonLab/Mess-Website.git | ||
``` | ||
- Install Python 3.10 Or Higher | ||
- Install Django | ||
2. Navigate to the project directory: | ||
|
||
```shell | ||
$ pip install django | ||
cd team_22 | ||
``` | ||
- Install all dependencies | ||
3. Install all dependencies | ||
|
||
```shell | ||
$ pip install –-user -r requirements.txt | ||
pip install –-user -r requirements.txt | ||
``` | ||
- Create a superuser | ||
4. Create a superuser | ||
|
||
```shell | ||
$ python manage.py createsuperuser | ||
python manage.py createsuperuser | ||
``` | ||
- Migrate the database | ||
```shell | ||
$ python manage.py migrate | ||
5. Migrate the database | ||
|
||
```shell | ||
python manage.py migrate | ||
``` | ||
- Copy the environment | ||
6. Copy the environment | ||
```shell | ||
$ cp .env.example .env | ||
cp .env.example .env | ||
``` | ||
- Edit the environment variables in `.env` file | ||
- Finally run | ||
7. Edit the environment variables in `.env` file | ||
8. Finally run | ||
```shell | ||
$ python manage.py runserver | ||
``` | ||
_Note:_ SQLite is as the default database | ||
|
||
## Roadmap | ||
|
||
- [x] Student Information Access | ||
- [x] Short Rebate Form | ||
- [x] Long Rebate Form | ||
- [x] Caterer Allocation Form | ||
- [x] Billing System - for both students and caterers | ||
- [x] Email Notifications | ||
- [ ] Scan QR Code feature | ||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p | ||
|
||
## Contact | ||
|
||
- [Ishaan Mittal]([email protected]) | ||
|
||
Project Link: [https://github.com/DaemonLab/Mess-Website](https://github.com/DaemonLab/Mess-Website) | ||
|
||
|
||
[Django]: https://img.shields.io/badge/django-092E20?style=for-the-badge&logo=django&logoColor=white | ||
[Django-url]: https://www.djangoproject.com/ | ||
[SQlite]: https://img.shields.io/badge/sqlite-003B57?style=for-the-badge&logo=sqlite&logoColor=white | ||
[SQlite-url]: https://www.sqlite.org/index.html | ||
[Bootstrap]: https://img.shields.io/badge/bootstrap-7952B3?style=for-the-badge&logo=bootstrap&logoColor=white | ||
[Bootstrap-url]: https://getbootstrap.com/ | ||
[python]: https://img.shields.io/badge/python-3776AB?style=for-the-badge&logo=python&logoColor=white | ||
[python-url]: https://www.python.org/ | ||
[Docker]: https://img.shields.io/badge/docker-2496ED?style=for-the-badge&logo=docker&logoColor=white | ||
[Docker-url]: https://www.docker.com/ | ||
[Gunicorn]: https://img.shields.io/badge/gunicorn-37474F?style=for-the-badge&logo=gunicorn&logoColor=white | ||
[Gunicorn-url]: https://gunicorn.org/ | ||
[Nginx]: https://img.shields.io/badge/nginx-269539?style=for-the-badge&logo=nginx&logoColor=white | ||
[Nginx-url]: https://www.nginx.com/ |