Bibi is an e-commerce fullstack solution built with Flask. It includes e-commerce, social, and hot common modules. It stood the test of business operations, is a light but complete solution.

This project provides backend service, based on Flask, MongoDB, Redis, Celery, RabbitMQ, and supports Python 3.5.

Bibi offers fullstack solution for use with the following:

bibi-frontend Mobile web frontend

bibi-ionic Hybrid APP

• 可观看中文文档

Features:

• User

  • Supports Email, Wechat, Weibo, QQ, and Facebook Oauth,social-oauth for details
  • User Information, Address, Contact, Favor collections and etc..

• Social

  • Post, like, comment, and bad information report.
  • Following and followers.
  • Notifications.

• Content

  • Products board
  • Banners

• Product

  • Brands, categories, tags, vendors, price history.
  • Commodities sub-selections based on different colors, sizes and materials.

• Cart

  • Session carts
  • Snapshot for items

• Order

  • Snapshot for order, store items history
  • Split into different packages depend on the total price and categories
  • Logistics information tracking, automatic updates
  • Third party logistics business parcel handling

• Payment

  • Supports Wechat,Paypal and etc..
  • Supports coupons, coins for discount.

• Management System

• AWS file upload

• Bing translate API

• Openexchange rate API

• Kuaidi100 logistics tracking API

Content Management Logistics Management Product Management

This based on Ubuntu/Debian,please skip if you had set up Python 3 environment.

# set up python3 environment
sudo apt-get update
sudo apt-get install python3-pip python3-dev
sudo apt-get install build-essential libssl-dev libffi-dev python-dev
# set up virtualenv
sudo pip3 install virtualenv virtualenvwrapper
echo "export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3" >> ~/.bashrc
echo "export WORKON_HOME=~/Env" >> ~/.bashrc
echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.bashrc
source ~/.bashrc
# Now virtual env for python3 will be installed in ~/Env
mkvirtualenv bibi # rename bibi
workon bibi # activate bibi env
# set up mongodb # 2.6 version
# set up redis
# set up rabbitMQ
mongod & # start mongodb
redis-server & # start redis
rabbitmq-server & # start RabbitMQ

Install dependencies

pip3 install -r requirements.txt

Initial database

python3 manage.py shell
# into Python3 shell
>>> from application.models import User
>>> user = User.create(email="xxxx@xxx.com", password="xxx", name="xxxx")
# Rename the email, password, name
>>> user.roles.append("ADMIN")
>>> user.save()

Run server

# start celery
celery -A application.cel worker -l info &
python3 manage.py runserver

Now open http://127.0.0.1:5000/admin/ on local.

# set up supervisor
sudo apt-get install supervisor
# set up gunicorn
pip3 install gunicorn

Create supervisor config

sudo vim /etc/supervisor/conf.d/bibi.conf

[program:bibi]
command=/root/Env/bibi/bin/gunicorn
 -w 3
 -b 0.0.0.0:8080
 --log-level debug
 "application.app:create_app()"
directory=/opt/py-maybi/ ; Project dir
autostart=false
autorestart=false
stdout_logfile=/opt/logs/gunicorn.log ; log dir
redirect_stderr=true

PS: -w the workers number,formula:(CPUs*2 + 1)

Create nginx config

sudo vim /etc/nginx/sites-enabled/bibi.conf

server {
 listen 80;
 server_name bigbang.maybi.cn;
 location / {
 proxy_pass http://127.0.0.1:8080; # Pointing to the gunicorn host
 proxy_set_header Host $host;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 }
 }

Start supervisor, nginx

sudo supervisorctl reload
sudo supervisorctl start bibi
sudo service nginx restart

Bravo! It's done.

Please open issues if you have problems.

Apache-2.0