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

# 进入 pear-admin-flask 代码根目录
cd pear-admin-flask

# 切换分支
git checkout mini

• 安装依赖

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

# 然后使虚拟环境生效（windows）
venv\Scripts\activate 
# source venv/bin/activate  # （Linux激活虚拟环境）

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

• 数据迁移

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

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

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

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

flask init-db

• 项目启动

flask run

Git 贡献提交规范

• 参考 vue 规范 (Angular)
  • feat 增加新功能
  • fix 修复问题/BUG
  • style 代码风格相关无影响运行结果的
  • perf 优化/性能提升
  • refactor 重构
  • revert 撤销修改
  • test 测试相关
  • docs 文档/注释
  • chore 依赖更新/脚手架配置修改等
  • workflow 工作流改进
  • ci 持续集成
  • types 类型定义文件更改
  • wip 开发中