Giter Club home page Giter Club logo

crowd-funding-django's Introduction

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

crowd-funding-django's People

Contributors

hossamkhalil01 avatar ahmedatef3 avatar ayahamedd avatar hosam94 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.