pear-admin-flask/README.md

Pear Admin Flask

开 箱 即 用 的 Flask 快 速 开 发 平 台

预 览 | 官 网 | 群聊 | 社区

项目简介

Pear Admin Flask 基于 Flask 生态的后台管理系统，该项目旨在为 python 开发者提供一个快速开发前后端半分离的后台管理系统的模板

在使用本项目之前最好掌握以下知识点

• html、css、JavaScript
• jQuery
• layui
• flask
• flask-login
• flask-sqlalchemy
• flask-restful

预览

Pear Admin Flask 有以下几个版本：

master分支版本

flask 2.x + flask-sqlalchemy + 权限验证 + Flask-APScheduler 定时任务 + marshmallow 序列化与数据验证

Mini 分支版本

flask 2.x + flask-sqlalchemy + 权限验证 + Flask-restful 序列化与数据验证

内置功能

• 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
• 权限管理：配置系统菜单，操作权限，按钮权限标识等。
• 角色管理：角色菜单权限分配。
• 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
• 登录日志：系统登录日志记录查询包含登录异常。
• 文件上传: 图片上传示例

文档

正在编写

安装使用

• 下载源码

git clone https://gitee.com/pear-admin/pear-admin-flask

# 切换分支
git checkout mini

• 安装依赖

# 创建虚拟环境
python -m venv venv

# 然后使虚拟环境生效（windows，Linux自行解决）
venv\Scripts\activate 

# 安装依赖
pip install -r requirement\requirement-dev.txt

• 数据迁移

默认的使用 sqlite3 作为测试环境的数据库进行演示,不需要按照mysql即可查看演示。如果需要二次开发，建议改成 mysql 。

如果需要在开发环境使用 mysql 作为数据库，请查看 applications/configs/config.py 文件里面的相关配置文件, 注释掉 sqlite 的配置即可

如果需要修改数据的配置信息，请在 .flaskenv 里面调整即可

flask db init
flask db migrate -m '数据初始化'
flask db upgrade

flask init-db

服务器部署

wsgi

采用 gunicorn ,配置文件请查看 gunicorn.conf.py 。暂时未使用 nginx 作为反向代理，需要的可以自行配置。

守护进程

使用下面的命令安装Supervisor：

$ sudo apt install supervisor

编辑配置文件 $ sudo vim /etc/supervisor/conf.d/pear.conf

写入项目配置

[program:pear]
command=bash /home/ubuntu/pear-admin-flask/start.sh
user=root
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true

管理项目进程

$ sudo supervisorctl