/pear-admin-flask-mini

Primary LanguageJavaScriptMIT LicenseMIT



Pear Admin Flask

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

预 览 | 官 网 | 群聊 | 社区

Pear Admin Layui Version Python Version Mysql Version

项目简介

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

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

预览

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 --reload

Git 贡献提交规范

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