CleverFool77 / outpassfinal

Outpass Portal[EXCLUSIVELY FOR FEMALE PARTICIPANTS]

Outpass Portal is designed to simplify and speeding up the process of seeking an outpass for leave.It aims to eliminate unneccesary paperwork by making the process of creating requests digital.The caretakers can then approve the outpass at the click of a button.

How it Works-

1. Signup and then login to create a new request.
2. Fill the required form details.
3. An email with the same details will be sent to your parent's email informing them about your leave application.
4. The admin can then view and approve your request.
5. You will receive an email notification on approval.[IN PROGRESS]
6. Forum for discussion regarding hostel and mess issues [TO BE IMPLEMENTED].

Setup for developers (Unix)

1. Make sure you have installed Python 3.6, pip3 and virtualenv.

2. If working behind a proxy, make sure your environment variables are properly set up. If you still get an error due to proxy, use "-E" flag along with "sudo" to export all the environment variables.

3. Clone the repo - git clone and cd into the directory. If working behind a proxy, follow the instructions here.

4. Create a virtual environment with Python 3 and install dependencies:

   $ virtualenv venv --python=/path/to/python3
   $ source venv/bin/activate
   $ pip install -r requirements.txt

5. Run python manage.py makemigrations.

6. Run python manage.py migrate.

7. Run python manage.py createsuperuser to create a superuser for the admin panel. Fill in the details asked.This user can be then used to login normally or through admin dashboard.

8. Run python manage.py runserver to start the development server.

In case if you run into any issues during setup feel free to contact Team Opencode.