# Vben_FastApi_Admin

**Repository Path**: VilanStudio/vben_fastapi_admin

## Basic Information

- **Project Name**: Vben_FastApi_Admin
- **Description**: 这是vben和fastapi结合的版本
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-11
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vben_FastApi_Admin

一个基于 `vue-vben-admin` 和 `FastAPI` 的前后端分离管理后台项目。

当前仓库已经将前端 `web-antd` 应用与 `fastapi-backend` 进行对接，登录、验证码、用户信息、动态菜单、个人中心等主链路可以直接围绕本仓库继续开发。

## 项目结构

```txt
Vben_FastApi_Admin/
├── fastapi-backend/      # FastAPI 后端
├── vue-vben-admin/       # Vben 前端 monorepo
├── README.md
└── README.en.md
```

当前实际使用的是：

- 前端：`vue-vben-admin/apps/web-antd`
- 后端：`fastapi-backend`

## 前后端对接关系

当前前端开发代理配置如下：

- 前端请求前缀：`/api`
- 开发代理重写后：`/api/v1`
- 后端根前缀：`/api/v1`
- 系统模块前缀：`/system`

所以前端请求例如：

- `/api/system/auth/login`
- `/api/system/user/current/info`

最终会落到后端：

- `/api/v1/system/auth/login`
- `/api/v1/system/user/current/info`

## 已完成的核心适配

已完成的主要接口适配包括：

- 登录：`POST /system/auth/login`
- 刷新令牌：`POST /system/auth/token/refresh`
- 退出登录：`POST /system/auth/logout`
- 获取验证码：`GET /system/auth/captcha/get`
- 当前用户信息：`GET /system/user/current/info`
- 个人资料更新：`PUT /system/user/current/info/update`
- 修改密码：`PUT /system/user/current/password/change`
- 上传头像：`POST /system/user/current/avatar/upload`
- 用户注册：`POST /system/user/register`

动态菜单不是单独请求菜单接口，而是从当前用户信息中的 `menus` 字段提取，再转换为 Vben 路由结构。

## 后端启动

后端目录：`fastapi-backend`

1. 配置 `fastapi-backend/env/.env.dev`
2. 准备 MySQL 和 Redis
3. 启动后端

推荐方式：

```bash
uv sync
uv run main.py run --env=dev
```

或使用 `pip`：

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python main.py run --env=dev
```

启动成功后可访问：

- `http://127.0.0.1:8001/api/v1/docs`
- `http://127.0.0.1:8001/api/v1/redoc`

更多说明见：`fastapi-backend/项目启动.md`

## 前端启动

前端目录：`vue-vben-admin`

安装依赖：

```bash
pnpm install
```

启动当前对接后的前端应用：

```bash
pnpm dev:antd
```

默认开发端口见：`vue-vben-admin/apps/web-antd/.env.development`

## 适合继续开发的方向

你可以在当前仓库继续做这些事情：

- 继续补系统管理模块页面
- 对接更多 FastAPI 业务接口
- 优化个人中心与账号体系
- 收口文档、部署和初始化流程

## 说明

`vue-vben-admin` 是一个 monorepo，除了 `apps/web-antd` 外还包含其他示例应用；当前业务开发应优先以 `apps/web-antd` 为准.