# Pear Admin Flask

**Repository Path**: liuyiyangwang/pear-admin-flask

## Basic Information

- **Project Name**: Pear Admin Flask
- **Description**: 🌶 基于 Flask 生态，权限，快速开发平台
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.pearadmin.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1143
- **Created**: 2023-05-07
- **Last Updated**: 2024-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<br/>
<br/>
<div align="center">

# Fastapi_Template 示例代码

#### 开 箱 即 用 的 FastApi 快 速 开 发 平 台

[![fastapi](https://img.shields.io/badge/fastapi-0.108.0-green)](https://fastapi.tiangolo.com/zh/)
[![Python](https://img.shields.io/badge/Python-3.9.18-green.svg)](https://www.python.org/downloads/release/python-3918/)
[![gitlab](https://img.shields.io/badge/fastapi-a502%20gitlab-blue?logo=gitlab)](http://a502-gitlab-power.cospower.cn/fastapi/fastapi_template)

</div>

## 项目简介

fastapi_template 基于 fastapi 的快速开发平台  
项目使用 fastapi + sqlalchemy + JWT 权限验证 + pydantic 序列化与数据验证

### 内置功能

- [x] 用户管理：用户是系统操作者，该功能主要完成系统用户配置
- [x] 权限管理：配置系统菜单，操作权限，按钮权限标识等
- [x] 角色管理：角色菜单权限分配
- [x] 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询
- [x] 登录日志：系统登录日志记录查询包含登录异常
- [x] 服务监控：监视当前系统CPU、内存、磁盘、python版本,运行时长等相关信息
- [x] 文件上传: 图片上传示例

## 项目结构

### 应用结构

``` 应用结构
Pear Admin Flask
├─applications  # 应用
│  ├─configs  # 配置文件
│  │  ├─ common.py  # 普通配置
│  │  └─ config.py  # 配置文件对象
│  ├─extensions  # 注册插件
│  ├─models  # 数据模型
│  ├─static  # 静态资源文件
│  ├─templates  # 静态模板文件
│  └─views  # 视图部分
│     ├─admin  # 后台管理视图模块
│     └─index  # 前台视图模块
├─docs  # 文档说明
├─migrations  # 迁移文件记录
├─requirement  # 依赖文件
└─.env # 项目的配置文件
```

### 资源结构

``` 资源结构
Pear Admin Flask
├─static    # 项目设定的 Flask 资源文件夹
│  ├─admin    # pear admin flask 的后端资源文件（与 pear admin layui 同步）
│  ├─index    # pear admin flask 的前端资源文件
│  └─upload     # 用户上传保存目录
└─templates # 项目设定的 Flask 模板文件夹
  ├─admin   # pear admin flask 的后端管理页面模板
  │  ├─admin_log    # 日志页面
  │  ├─common       # 基本模板页面（头部模板与页脚模板）
  │  ├─console      # 系统监控页面模板
  │  ├─dept         # 部门管理页面模板
  │  ├─dict         # 数据自动页面模板
  │  ├─mail         # 邮件管理页面模板
  │  ├─photo        # 图片上传页面模板
  │  ├─power        # 权限（菜单）管理页面模板
  │  ├─role         # 角色管理页面模板
  │  ├─task         # 任务设置页面模板
  │  └─user         # 用户管理页面模板
  ├─errors  # 错误页面模板
  └─index   # 主页模板
```

## 部署方式

### 开发环境

``` 开发环境
安装conda

conda create -n fastapi python=3.9.18

pip install -r ./requirements.txt
# uvicorn 有bug 无法reload https://github.com/encode/uvicorn/pull/2211
```