roadrunner

Django powered project which acts as Bus and Taxi booking portal for Travel Firm Owners. Fully Restful API for future integration with websites and mobile applications.

Features

• Bus Management
• Basic Bus seat configuration (user can book seats of their choice like in BookMyShow)
• Bus Ticket Booking
• Driver/Conductor Management
• Taxi Management
• Taxi-Driver Management
• Google Maps API integrated for fair and journey time calculations between cities
• User login/signup/password-reset features for accounts management
• User Authorization using access-tokens
• E-Wallet for bus-ticket/taxi-booking payments with pay-later option

What this project includes

• Bus application for bus related tasks (bus)
• Taxi application for taxi related tasks (taxi)
• Payment application for e-wallet management (epay)
• Authorization application for user-authorization using tokens (e-auth)
• User accounts application (superuser)
• Centralized application which contains forms for basic testing of all apps

How to setup roadrunner for development

If you want to contribute to roadrunner by improving the feautures or by testing its features then you'll have to set it up on your machine. Though you can run it globally but i would prefer you do all the development inside virtualenv so that it doesn't pollute your global packages.

Follow the steps as they are and you'll be good to use roadrunner.

Installations

1. install pip

2. install python dependencies sudo apt-get install python-setuptools python-dev build-essential

3. install pip sudo easy_install pip

4. install virtualenv by typing sudo pip install --upgrade virtualenv

5. Clone roadrunner from your forked directory.

6. create a virtual environment by typing virtualenv venv inside your project directory

7. switch to the virtual environment by typing source venv/bin/activate inside your project directory

8. install the dependencies by running pip install -r requirements.txt

9. install mysql

10. sudo apt-get update

11. sudo apt-get install mysql-server-5.5

Setup database

1. Create database tables by running python manage.py makemigrations and then python manage.py migrate

2. collect admin static files by running python manage.py collectstatic

3. create superuser for your project by running the command python manage.py createsuperuser (as i know, your username and password must be same for django admin interface and for mysql)

Testing the URL's

1. Run the Django's development server using python manage.py runserver

2. Open localhost/admin/ in your browser

3. To exit the virtual environment type deactivate

If you encounter any error during the installation, setup or running the server then please inform about it. If you find some error which is easy to fix then also inform about it so that we can fix it in main code or in the above steps.