# vue3admin

**Repository Path**: xvlie/vue3admin

## Basic Information

- **Project Name**: vue3admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# vue3admin

前后端整合项目，包含：

| 目录                    | 说明          | 技术栈                                   |
| :---------------------- | :------------ | :--------------------------------------- |
| `vue3-element-admin/` | PC 管理端前端 | Vue 3 + Vite + Element Plus + Pinia      |
| `youlai-fastapi/`     | 后端接口服务  | FastAPI + SQLAlchemy 2.0 + MySQL + Redis |

> 后端已由 PostgreSQL 迁移至 MySQL（异步驱动 `aiomysql`），初始化脚本见 `youlai-fastapi/sql/mysql/youlai-admin.sql`。

---

## 环境要求

- **Node.js** 18+（推荐 20+），包管理器 **pnpm**
- **Python** 3.11+
- **MySQL** 5.7+（推荐 8.0），需先导入初始化脚本
- **Redis** 7.x

## 快速开始

### 1. 初始化数据库

```bash
# 建库建表 + 种子数据（脚本内含 CREATE DATABASE / USE，直接执行即可）
mysql -u root -p < youlai-fastapi/sql/mysql/youlai-admin.sql
```

### 2. 启动后台（youlai-fastapi，端口 8000）

```bash
cd youlai-fastapi

# 首次安装依赖（已安装可跳过）
python -m venv .venv
.venv\Scripts\pip install -e .        # Windows
# source .venv/bin/pip install -e .   # Linux / Mac

# 配置数据库连接（MySQL 账号密码、Redis 地址）
# 复制 .env.example 为 .env 后按需修改
.venv\Scripts\activate 激活虚拟环境
# 启动服务（开发调试可加 --reload）
.venv\Scripts\python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000
# 或
.venv\Scripts\python.exe -m fastapi dev app/main.py
```

启动后接口文档：http://localhost:8000/docs

### 3. 启动前台（vue3-element-admin，端口 3000）

```bash
cd vue3-element-admin

# 首次安装依赖（已安装可跳过）
pnpm install

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

启动后访问：http://localhost:3000

> 前端通过 Vite 代理 `/dev-api` → `http://localhost:8000`，无需额外配置 CORS。

## 默认账号

| 用户名 | 密码   | 角色       |
| :----- | :----- | :--------- |
| admin  | 123456 | 系统管理员 |

## 常用命令

| 场景     | 命令                                                                                                   |
| :------- | :----------------------------------------------------------------------------------------------------- |
| 后台启动 | `cd youlai-fastapi && .venv\Scripts\python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000` |
| 后台停止 | 终端`Ctrl+C`                                                                                         |
| 前台启动 | `cd vue3-element-admin && pnpm dev`                                                                  |
| 前台构建 | `cd vue3-element-admin && pnpm build`                                                                |

## 目录结构

```
vue3admin/
├── vue3-element-admin/      # 前端（Vue3 + Vite）
├── youlai-fastapi/          # 后端（FastAPI + SQLAlchemy + MySQL）
└── README.md
```