基于 Flask 框架开发的微信小程序后端项目，用于构建小程序商城后台 （电商相关；rbac权限管理；附带自动生成Swagger

<h1 align="center"> mini-shop-server </h1> <h4 align="center"> 构建微信小程序(商城)后端 <br>🤜基于 Flask 框架🤛 </h4> <div align="center"> <img alt="img" src="" width="550px"> <div> <a href="http://47.114.33.143:9000/apidocs/#/" target="__blank">线上 API 文档</a> </div> </div> * 本项目的开发环境是 Mac OS，生产环境是 Linux Ubuntu 16.04 * 感谢慕课网的[七月老师](https://www.imooc.com/t/4294850)，本项目初期是基于他的课程思路 ## 🎮 互动 QQ交流群:聊天、斗图、学习、交流，伸手党勿进 <table align="center"> <tr> <td><img alt="img" src="./media/qq_group_qr_code.jpg" width="250px"></td> <td><img alt="img" src="./media/qq_group_from_lin.png" width="250px"></td> </tr> <tr> <td> <a target="_blank" href="//shang.qq.com/wpa/qunwpa?idkey=ee34348c8d177a4218594598de6c3fb404861a1c7a7091cd9f4384e6dcd6ea32"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="葬爱代码家族群" title="葬爱代码家族群"></a> </td> <td> <a target="_blank" href="//shang.qq.com/wpa/qunwpa?idkey=184ed5a00c7f903271f8d55beb814b7c9779347e114e2db51db7962bf9d016de"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="林间有风团队官方交流" title="林间有风团队官方交流"></a> </td> </tr> <tr> <td>葬爱家族QQ交流群</td> <td>林间有风团队官方QQ交流群</td> </tr> </table> ## ✨ 亮点 - 基于原生的 Flask 构建 RESTful API - 更灵活的 API文档生成方式(可带 **Token**) - AOP(面向切面编程)设计，实现 **参数校验层** & **异常统一处理层** - Ubuntu 16.04上 Nginx + Gunicorn + Pipenv部署 ## 🔩 内置 1. 用户管理：提供用户的相关配置 2. 权限组(角色)管理：接口权限分配和菜单权限分配 3. 菜单管理：实现后端配置菜单动态路由，支持多级菜单 4. 字典管理：维护系统中经常使用的字典数据，如：性别，状态 5. 参数管理：系统动态配置常用参数，如：分页数，前端主题色等 6. 通知管理：系统通知&公告信息的发布维护 7. 日志管理：操作日志和登录日志 8. 接口文档：根据业务代码自动生成相关的api接口文档(Swagger风格) 9. 错误码：前后端开发的错误码的约定 10. 文件管理和上传：文件夹和文件的管理 11. 文章管理 ## 目录 - [亮点](#亮点) - [开发工具](#开发工具) - [开发环境搭建](#开发环境搭建) - [服务器部署](#服务器部署) - [本地&线上同步推进](#本地&线上同步推进)：针对个人项目 - [上传&下载](#上传&下载) - [骚操作](#骚操作) - [三端分离](#三端分离): 后续 - [Nginx 部署](#nginx部署) - [Python 学习路线](#Python学习路线) ## 开发工具 * Python 3.6（虚拟环境：pipenv） * MySQL * PyCharm（开发工具） * Navicat（数据库可视化管理工具） ## 开发环境搭建 * MySQL安装、运行，数据库的导入 * Python 3.6 ### MySQL的安装和数据导入 #### 一、安装 ``` $ sudo apt-get install mysql-server ``` 安装过程中，会让你输入密码。<br> 请务必记住密码!<br> 务必记住密码！<br> 记住密码！<br> 查看是否安装成功 ```$ sudo netstat -tap | grep mysql``` #### 二、运行 ``` $ mysql -u root -p # 执行完毕后输入密码 $ mysql -u root -p123456 # 直接输入密码，进入(我的密码是: 123456) ``` **`-u`** 表示选择登陆的用户名， **`-p`** 表示登陆的用户密码<br> 上面命令输入之后，会提示输入密码(Enter password) #### 三、导入 下载 MySQL数据 [SQL文件](https://server.mini-shop.ivinetrue.com/static/files/zerd.sql) > mysql的每条执行以「分号」结尾 ``` mysql> create database zerd; # 建立数据库(zerd) mysql> use zerd; # 进入该数据库 mysql> source /home/ubuntu/mini-shop-server/zerd.sql; # 导入「mini-shop-server」目录下的sql文件 ``` > Tips: 其他数据库操作<br> ``` // 1. 获取存在的所有表 show tables; // 2. 导入成功，可以直接查询(user表) mysql> select * from user; // 3. 删除数据库(zerd库) mysql> drop database zerd; // 4. 导出数据库 mysql> ``` ### Python3.6版本的安装 查询本地的python3的版本 ```$ python3 --version``` 如果不是python3.6的版本，则如下操作 ``` $ sudo apt-get update $ sudo apt-get install software-properties-common $ sudo add-apt-repository ppa:jonathonf/python-3.6 $ sudo apt-get install python3.6 ``` ### pipenv的安装 如果还未安装pip3包管理工具，请先执行如下语句<br> ```$ sudo apt install python3-pip``` 安装 pipenv<br> ```$ pip3 install pipenv``` > Tips: 其他 pipenv操作 ``` $ pipenv install flask # 安装指定模块，并写入到 Pipfile中 $ pipenv install flask==1.0.2 # 安装指定版本的模块 $ pipenv uninstall flask # 卸载指定模块 $ pipenv update flask # 更新指定模块 $ pip list # 查看安装列表 $ pipenv graph # 查看安装列表，及其相应的以来 $ pipenv --venv # 虚拟环境信息 $ pipenv --py # Python解释器信息 $ pipenv --rm # 卸载当前虚拟环境 $ exit # 退出当前虚拟环境 ``` ### 本地启动 ``` $ git clone https://github.com/Allen7D/mini-shop-server.git $ cd mini-shop-server $ mkdir .venv # 生成.venv文件夹，用于存放该项目的python解释器(包括后续所有安装的包依赖) $ pipenv --python 3.6 # 指定某 Python 版本创建环境 $ pipenv shell # 激活虚拟环境 or 如果没有虚拟环境，则构建新的(默认版本) $ pipenv install # 安装包依赖 $ python server.py run # 启动方式1:默认5000端口 $ python server.py run -p 8080 # 启动方式2:改为8080端口 $ python server.py run -h 0.0.0.0 -p 8080 # 启动方式3:以本地IP地址访问 ``` ### 生成临时管理员信息 ```$ python fake.py``` ### Pycharm的配置^{[[1]](#ref_1)} Pycharm中 配置 Pipenv生成的虚拟环境，并使用 **`指定端口`** 开启「Debug模式」 1. 获取该虚拟环境下 Python的解释器的路径 <div align="center"> <img alt="img" src="./media/python_interpreter.jpg" width="80%"> </div> 2. 配置指定端口号 **`Run > Edit Configurations`** <br> 写入 `run -h 0.0.0.0 8080` <br> 等同于，在终端执行 `python server.py run -h 0.0.0.0 -p 8080` <div align="center"> <img alt="img" src="./media/debug_configurations.jpg" width="80%"> </div> 3. 开启 Debug **`Run > Debug 'server'`** ## 目录结构 <details> <summary>展开查看</summary> <pre><code> . ├── app │   ├── __init__.py │   ├── api │   │   ├── v1 # v1的API接口 │   │   │   ├── __init__.py │   │   │   ├── address.py # 用户地址 │   │   │   ├── banner.py # 推广横幅 │   │   │   ├── category.py # 分类 │   │   │   ├── client.py │   │   │   ├── order.py # 订单 │   │   │   ├── pay.py # 支付 │   │   │   ├── product.py # 产品 │   │   │   ├── theme.py # 主题 │   │   │   ├── token.py # 令牌 │   │   │   └── user.py # 用户 │   │   └── v2 # v2的API接口 │   │   ├── __init__.py │   │   └── file.py # 文件上传 │   ├── api_docs # 对应的 API文档 │   ├── config # 配置文件 │   │   ├── secure.py │   │   ├── setting.py │   │   └── wx.py │   ├── libs # 自己的库 │   │   ├── enums.py │   │   ├── error.py │   │   ├── error_code.py │   │   ├── httper.py │   │   ├── limiter.py │   │   ├── redprint.py │   │   ├── scope.py │   │   ├── swagger_filed.py │   │   �