# fastapi-web-admin

**Repository Path**: lsaiahshen/fastapi-web-admin

## Basic Information

- **Project Name**: fastapi-web-admin
- **Description**: 🚀 技术栈
后端：Python Tortoise ORM JWT FastAPI Uvicorn
前端: VUE3 VITE vue-router pinia elementPlus
🤝贡献指南 欢迎贡献！请遵循以下步骤：
Fork 项目
创建新分支
提交更改
创建 Pull Request
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2025-08-18
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastAPI Admin

一个基于 FastAPI 的现代化全栈管理系统，提供完整的后端 API 服务和多前端框架支持。

## 📖 项目简介

本项目是一个前后端分离的管理系统，后端采用 FastAPI 构建，提供 RESTful API 服务；前端提供 Vue3 和 React 两个版本，可根据团队技术栈灵活选择。

## 🚀 技术栈

### 后端
- **Python 3.8+** - 编程语言
- **FastAPI** - 现代化 Web 框架
- **TortoiseORM** - 异步 ORM 框架
- **JWT** - 身份认证
- **Uvicorn** - ASGI 服务器
- **MySQL** - 数据库

### 前端 Vue3
- **Vue 3** - 渐进式 JavaScript 框架
- **Vite** - 下一代前端构建工具
- **Vue Router** - 官方路由管理器
- **Pinia** - 状态管理
- **Element Plus** - UI 组件库

### 前端 React
- **React 18** - 用户界面构建库
- **Vite** - 下一代前端构建工具
- **React Router** - 声明式路由
- **Zustand** - 轻量级状态管理
- **Ant Design** - 企业级 UI 设计语言

## 📁 项目结构

```
fastapi-vue3-admin/
├── fastapi-server/      # 后端服务 (FastAPI)
├── admin-ui/            # 前端 Vue3 版本
├── admin-ui-react/      # 前端 React 版本
└── README.md            # 项目说明文档
```

## 🚀 快速开始

### 后端启动

```bash
cd fastapi-server
pip install -r requirements.txt
python main.py
```

详细说明请查看 [fastapi-server/README.md](./fastapi-server/README.md)

### 前端启动

#### Vue3 版本
```bash
cd admin-ui
yarn install
yarn start
```

详细说明请查看 [admin-ui/README.md](./admin-ui/README.md)

#### React 版本
```bash
cd admin-ui-react
pnpm install
pnpm start
```

详细说明请查看 [admin-ui-react/README.md](./admin-ui-react/README.md)

## ✨ 主要特性

- ✅ 用户认证与授权（JWT）
- ✅ 用户管理
- ✅ 字典管理
- ✅ RESTful API 设计
- ✅ 异步数据库操作
- ✅ 多环境配置支持
- ✅ 前后端分离架构
- ✅ 双前端框架支持（Vue3 / React）

## 🤝 贡献指南

欢迎贡献！请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 许可证

该项目采用 MIT 许可证

## 👨‍💻 作者

Lsaiah

## 📞 联系方式

请通过 Gitee 仓库页面联系作者

## 🙇‍ 愿景

学习 Python 进行后端开发，学习 Vue/React 进行前端开发，希望最终作品可开源投入商业使用