Skip to content

Latest commit

 

History

History
180 lines (136 loc) · 4.75 KB

README_zh.md

File metadata and controls

180 lines (136 loc) · 4.75 KB
Raw

Bibi

Bibi原本是一款海外留学生活助手APP，含电商，社交等热门模块，经历过商业运营的考验，是较为成熟的解决方案。

本项目是电商服务后端，基于 Flask, MongoDB, Redis, Celery, RabbitMQ, 支持 Python 3.5.

Bibi 提供电商全栈解决方案，配合以下项目使用:

bibi-frontend 微信前端项目

bibi-ionic 手机端Hybrid APP源码

Features：

  • 用户中心

    • 支持邮件，微信，微博，QQ，Facebook及其手机客户端等登录，详看social-oauth支持
    • 用户基本信息，收货地址，联系方式，喜欢收藏

  • 社交系统

    • 发布帖子，点赞，评论，不良信息举报
    • 用户之间可相互关注
    • 新消息通知

  • 内容系统

    • 商品专题
    • Banner广告

  • 商品系统

    • 品牌，类别，标签，供货商，价格系统
    • 商品基于不同颜色，尺寸等不同价格的子选择

  • 购物车系统

    • 支持匿名放入购物车
    • 商品快照，上下架更新

  • 订单系统

    • 订单快照，保存商品历史信息
    • 根据商品总价和类别拆分成不同包裹
    • 国内外物流信息跟踪，自动更新
    • 第三方物流商对接包裹处理

  • 支付系统

    • 支持微信，Paypal等支付方式
    • 用户钱包支持 优惠券，金币等减免方式

  • 后台管理系统

  • AWS文件上传

  • Bing翻译API对接

  • Openexchange外币兑换汇率API对接

  • kuaidi100快递跟踪API对接

  • 4PX物流商对接

Screenshot

内容管理界面 物流管理界面 商品管理界面

搭建环境

本教程基于Ubuntu/Debian，已安装python3 环境的请跳过

# 安装python3环境
sudo apt-get update
sudo apt-get install python3-pip python3-dev
sudo apt-get install build-essential libssl-dev libffi-dev python-dev

#安装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

# 现在你的home目录下有Env的文件夹，你的python虚拟环境都会创建在这里

mkvirtualenv bibi # bibi可随便改成你的项目名
workon bibi # 现在已进入项目的独立环境

# 安装 mongodb 略  (请安装mongodb 2.6版本)
# 安装 redis 略
# 安装 rabbitMQ 略

mongod &              # 启动mongodb
redis-server &        # 启动redis
rabbitmq-server &     # 启动RabbitMQ

安装依赖

pip3 install -r requirements.txt

初始化数据库

python3 manage.py shell
# into Python3 shell
>>> from application.models import User
>>> user = User.create(email="[email protected]", password="xxx", name="xxxx")
# email, password, name改成你自己的
>>> user.roles.append("ADMIN")
>>> user.save()

运行

# 启动 celery
celery -A application.cel worker -l info &

python3 manage.py runserver

本地可以打开 http://127.0.0.1:5000/admin/

部署方式

# 安装 supervisor
sudo apt-get install supervisor
# 安装 gunicorn
pip3 install gunicorn

创建supervisor配置

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/                                       ; 你的项目代码目录
autostart=false                                                ; 是否自动启动
autorestart=false                                              ; 是否自动重启
stdout_logfile=/opt/logs/gunicorn.log                          ; log 日志
redirect_stderr=true

PS: 上面 -w 为 开启workers数，公式：（系统内核数*2 + 1)

创建nginx配置

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

server {
    listen 80;
    server_name bigbang.maybi.cn; # 这是HOST机器的外部域名，用地址也行

    location / {
        proxy_pass http://127.0.0.1:8080; # 这里是指向 gunicorn host 的服务地址
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

  }

接着启动 supervisor, nginx

sudo supervisorctl reload
sudo supervisorctl start bibi

sudo service nginx restart

大功告成。

有问题，欢迎提Issue。

License

Apache-2.0