# vue-fastapi-pgsql-admin

**Repository Path**: zh423328/vue-fastapi-pgsql-admin

## Basic Information

- **Project Name**: vue-fastapi-pgsql-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

VUE+FASTAPI-PGSQL-ADMIN
后台管理系统，包含管理员系统，菜单系统，角色系统，词典系统，多租户，基于RBAC的权限管理，Excel的导入和导出，定时任务的配置，后台任务的添加和配置，要求服务端并发5000以上，服务端多环境配置

## 技术栈

### 后端框架
- FastAPI + PostgreSQL + Redis + Uvicorn + Alembic + SQLAlchemy 2.0 Async + JWT
- 自动监测 SQLAlchemy 模型变更并生成迁移文件
- 支持多节点部署和负载均衡

### 前端框架
- Vue3 + TypeScript + Vite + Ant Design Vue 4 + Axios + Pinia + UnoCSS
- 响应式设计，适配移动端

## 项目结构

```
vue-fastapi-pgsql-admin/
├── backend/                 # 后端代码
│   ├── app/                # 应用代码
│   │   ├── api/           # API 路由
│   │   ├── core/          # 核心功能（认证、权限、缓存等）
│   │   ├── db/            # 数据库配置
│   │   ├── middleware/    # 中间件
│   │   ├── models/        # 数据模型
│   │   ├── schemas/       # Pydantic 模型
│   │   └── services/      # 业务逻辑
│   ├── alembic/           # 数据库迁移
│   ├── tests/             # 测试文件
│   ├── .env.example       # 环境变量模板
│   ├── Dockerfile         # Docker 镜像配置
│   └── pyproject.toml     # Python 依赖配置
├── frontend/               # 前端代码
│   ├── src/               # 源代码
│   │   ├── api/          # API 请求
│   │   ├── components/   # 组件
│   │   ├── layouts/      # 布局
│   │   ├── router/       # 路由
│   │   ├── store/        # 状态管理
│   │   ├── utils/        # 工具函数
│   │   └── views/        # 页面
│   ├── Dockerfile         # Docker 镜像配置
│   └── package.json       # 前端依赖配置
├── docker/                 # Docker 部署配置
│   ├── docker-compose.yml      # 开发环境配置
│   ├── docker-compose.prod.yml # 生产环境配置
│   ├── nginx/                  # Nginx 配置
│   │   ├── nginx.conf         # 主配置文件
│   │   └── ssl/               # SSL 证书目录
│   ├── data/                   # 数据持久化目录（本地）
│   │   ├── postgres/          # PostgreSQL 数据
│   │   └── redis/             # Redis 数据
│   ├── logs/                   # 日志目录（本地）
│   │   ├── backend/           # 后端日志
│   │   └── nginx/             # Nginx 日志
│   └── README.md              # Docker 使用说明
├── scripts/                # 脚本文件
│   └── init_db.py         # 数据库初始化脚本
├── docs/                   # 项目文档
│   └── deployment.md      # 部署指南
└── README.md              # 本文件
```

## 快速开始

### 前置要求

- Docker 20.10+
- Docker Compose 2.0+

### 开发环境

```bash
# 1. 克隆项目
git clone <repository-url>
cd vue-fastapi-pgsql-admin

# 2. 进入 docker 目录
cd docker

# 3. 启动所有服务
docker-compose up -d

# 4. 等待服务启动（约 30 秒）
sleep 30

# 5. 初始化数据库
docker exec admin_backend_dev alembic upgrade head
docker exec admin_backend_dev python scripts/init_db.py

# 6. 访问系统
# 前端: http://localhost:5173
# 后端 API: http://localhost:8000
# API 文档: http://localhost:8000/docs
```

默认管理员账户：
- 用户名: `admin`
- 密码: `admin123`

### 生产环境

详细的生产环境部署指南请参考：[docs/deployment.md](docs/deployment.md)

## 核心功能

- ✅ 用户认证与授权（JWT）
- ✅ 基于 RBAC 的权限管理
- ✅ 多租户支持（数据隔离）
- ✅ 动态菜单管理
- ✅ 角色和权限管理
- ✅ 词典管理
- ✅ Excel 导入导出
- ✅ 定时任务配置
- ✅ 后台任务管理
- ✅ 审计日志
- ✅ API 限流保护
- ✅ 响应式前端（移动端适配）
- ✅ 自动生成 API 文档
- ✅ 数据库自动迁移
- ✅ 多节点部署支持

## 性能特性

- 支持 5000+ 并发连接
- 异步数据库操作
- Redis 缓存优化
- 数据库连接池
- 后端负载均衡
- Gzip 压缩
- 静态资源缓存

## 开发指南

### 后端开发

```bash
cd backend

# 安装 uv（Python 包管理器）
pip install uv

# 创建虚拟环境并安装依赖
uv venv
source .venv/bin/activate  # Linux/macOS
uv sync

# 配置环境变量
cp .env.example .env.dev
vim .env.dev

# 运行开发服务器
uvicorn main:app --reload
```

### 前端开发

```bash
cd frontend

# 安装 pnpm
npm install -g pnpm

# 安装依赖
pnpm install

# 启动开发服务器
pnpm run dev
```

### 数据库迁移

```bash
# 生成迁移文件
alembic revision --autogenerate -m "描述"

# 应用迁移
alembic upgrade head

# 回滚迁移
alembic downgrade -1
```

## 文档

- [部署指南](docs/deployment.md) - 完整的部署文档
- [Docker 使用说明](docker/README.md) - Docker 配置说明
- [API 文档](http://localhost:8000/docs) - 自动生成的 API 文档

## 许可证

MIT License