7 Star 78 Fork 31

fastapiadmin/fastapi_vue3_admin

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
README.md 9.94 KB
一键复制 编辑 原始数据 按行查看 历史

Fastapi-Vue3-Admin v2.0.0

一套现代、开源、全栈融合的中后台快速开发平台,给个⭐️支持一下

Gitee Stars GitHub Stars License


简体中文 | English


📘 项目介绍(作者:@1014TaoTao)

Fastapi-Vue3-Admin 是一套 完全开源、高度模块化、技术先进的现代化快速开发平台,旨在帮助开发者高效搭建高质量的企业级中后台系统。该项目采用 前后端分离架构,融合 Python 后端框架 FastAPI 和前端主流框架 Vue3 实现多端统一开发,提供了一站式开箱即用的开发体验。

设计初心: 以模块化、松耦合为核心,追求丰富的功能模块、简洁易用的接口、详尽的开发文档和便捷的维护方式。通过统一框架和组件,降低技术选型成本,遵循开发规范和设计模式,构建强大的代码分层模型,搭配完善的本地中文化支持,专为团队和企业开发场景量身定制。

fastapi_vue3_admin
├─ backend        # 后端工程
├─ frontend       # 前端工程
├─ devops         # 部署工程
├─ docker-compose.yaml # 部署文件
├─ start.sh       # 一键部署脚本
├─ LICENSE        # 许可协议
|─ README.en.md   # 英文文档
└─ README.md      # 中文文档

✨ 核心亮点

特性 描述
🔭 快速开发 一套完全开源的现代化快速开发平台,旨在帮助开发者高效搭建高质量的中后台系统。
🌐 全栈整合 前后端分离,融合 Python (FastAPI) + Vue3 多端开发
🧱 模块化设计 系统功能高度解耦,便于扩展和维护
⚡️ 高性能异步 使用 FastAPI 异步框架 + Redis 缓存优化接口响应速度
🔒 安全认证 支持 JWT OAuth2 认证机制,保障系统安全
📊 权限管理 RBAC 模型实现菜单、按钮、数据级别的细粒度权限控制
🚀 快速部署 支持 Docker/Docker Compose/Nginx 一键部署
📄 开发友好 提供完善的中文文档 + 中文化界面 + 可视化工具链,降低学习成本
🚀 快速接入 基于 Vue3、Vite5、Pinia、Ant Design Vue 等主流前端技术栈,开箱即用。

🛠️ 技术栈概览

类型 技术选型 描述
后端框架 FastAPI / Uvicorn / Pydantic 2.0 / Alembic 现代、高性能的异步框架,强制类型约束,数据迁移。
ORM SQLAlchemy 2.0 强大的 ORM 库。
定时任务 APScheduler 轻松实现定时任务。
权限认证 PyJWT 实现 JWT 认证。
前端框架 Vue3 / Vite5 / Pinia / TypeScript 快速开发 Vue3 应用。
UI 库 Ant Design Vue 快速开发美观的 UI 组件。
数据库 MySQL / MongoDB 强大的数据库。
缓存 Redis 强大的缓存数据库。
文档 Swagger / Redoc 自动生成 API 文档。
部署 Docker / Nginx / Docker Compose 快速部署项目。

📌 内置模块

模块名 子模块名 描述
仪表盘 工作台 、分析页 常用功能入口
系统管理 包含菜单、部门、岗位、角色、用户、日志、配置、公告、字典、任务等子模块 系统主功能
监控管理 在线用户、服务器监控、缓存监控 系统监控管理功能
公共管理 接口管理、文档管理 项目接口文档

🍪 演示环境


👷 安装和使用

版本说明

类型 技术栈 版本
后端 Python 3.10(大于3.10的版本, 会有兼容问题, 将来升级,暂时不考虑升级)
后端 FastAPI 0.109
前端 Node.js >= 20.0(推荐使用最新版)
前端 npm 16.14
前端 Vue3 3.3
数据库 MySQL 8.0 (推荐使用最新版)
中间件 Redis 7.0 (推荐使用最新版)

获取代码

# 克隆代码到本地
git clone https://gitee.com/tao__tao/fastapi_vue3_admin.git
或
git clone https://github.com/1014TaoTao/fastapi_vue3_admin.git

本地后端启动

#  进入后端工程目录
cd backend
# 安装依赖
pip3 install -r requirements.txt
# 启动后端服务
python3 main.py run 
或 
python3 main.py run--env=dev 
# 生成迁移文件
python3 main.py revision "初始化迁移" --env=dev(不加默认为dev)
# 应用迁移
python3 main.py upgrade --env=dev(不加默认为dev)

本地前端启动

# 进入前端工程目录
cd frontend
# 安装依赖
npm install
# 启动前端服务
npm run dev
# 构建前端, 生成 `frontend/dist` 目录
npm run build

本地访问地址


docker 部署

# 复制脚本 `fastapi_vue3_amdin/start.sh` 脚本文件到服务器, 并赋予执行权限
chmod +x start.sh
# 执行脚本
./start.sh
# 查看镜像:
docsker images -a
# 查看容器:
docsker compose ps
# 查看日志
docker logs -f <容器名>
# 服务停止
docsker compose down
# 删除镜像
docker rmi <镜像名>
# 删除容器
docker rm <容器名>
# 后端配置文件目录
fastapi_vue3_amdin/backend/env/.env.prod.py
# 前端配置文件目录
fastapi_vue3_amdin/frontend/vite.config.ts
和 
fastapi_vue3_amdin/frontend/.env.production
# 部署文件目录  
fastapi_vue3_amdin/docker-compose.yaml
和 
fastapi_vue3_amdin/devops/devops/nginx/nginx.conf


🔧 模块展示

登陆 仪表盘 菜单管理 部门管理
岗位管理 角色管理 用户管理 日志管理
配置管理 在线用户管理 服务器监控 缓存监控
任务管理 字典管理 分析管理 接口管理
系统主题 在线文档 系统锁屏

🙏 特别鸣谢

感谢以下项目的贡献和支持,使本项目得以顺利完成:

🎨 社区


❤️ Star 支持我

如果你喜欢这个项目,请给我一个 ⭐️ Star 支持一下吧!非常感谢!

Loading...
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/tao__tao/fastapi_vue3_admin.git
git@gitee.com:tao__tao/fastapi_vue3_admin.git
tao__tao
fastapi_vue3_admin
fastapi_vue3_admin
master

搜索帮助