/crowd-funding-django

A crowdfunding web application where people can donate and rate campaigns, it's a project that utilizes Django framework and MySQL database.

Primary LanguageCSS

CrowdFunding

CrowdFunding is an Egyptian for-profit crowd funding platform that allows people to raise money for events ranging from life events such as celebrations and graduations to challenging circumstances like accidents and illnesses. The project is developed using Python, Django framework and MySQL database.

Deployment

http://crowd-fundingapp.herokuapp.com/

Table of Contents

Features

  • Sign in with your Google / Facebook accounts
  • Create a fund raising campaign
  • Report campaigns
  • Rate campaigns
  • Add comments to any campaign
  • Reply to comments
  • Report comments
  • View all your campaigns and donations
  • Live search for campaigns
  • Browse campaigns based on category

Getting Started

To use and run this project you need to:

Before executing the following commands, please install python 3 as stated in the following setup

Setup Your Environment

  1. Run the following command to install the project locally.
python3 -m pip install --upgrade pip

git clone https://github.com/hossamkhalil01/crowd-funding-django.git

cd crowd-funding-django/ 

python3 -m venv venv

source venv/bin/activate

pip3 install -r requirements.txt
  1. Execute configuration required in configurations section
python3 manage.py migrate
  1. Run the server
python3 manage.py runserver
  1. Go to the browser and go to the following url: http://localhost:8000
Note:

Make sure that your database is up and configured properly for the application to work

Using Docker

You can also use the docker image provided to setup a running environment for the application to avoid any environment conflicts.

Change your working directory to the projects folder and execute the following commands (only one time)

docker-compose build

to build the image and then

docker-compose run app python3 manage.py migrate

to setup the database

Configurations

Write your database credentials in the secrets.py file inside crowdfunding directory then:

  • Create database named crowd_funding

As for the Facebook and Google API's configurations you will need to:

  • write the Google and Facebook APIs' keys in secrets.py file
  • Save then close the file

Dependencies

Limitations

  • User account is not deleted after expiration of the activation mail

Possible Improvements

  • Allow payment system

About Us

We are a team of software engineering students at ITI intake 41, Smart Village branch, Open-source application track.

  • Ahmed Atef
  • Aya Hamed
  • Hossam Ali
  • Hossam Khalil