# vue-admin

**Repository Path**: sclx/vue-admin

## Basic Information

- **Project Name**: vue-admin
- **Description**: 我的第一个AI编辑项目
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-04
- **Last Updated**: 2025-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vue Admin 前端项目

## 项目介绍
这是一个基于 Vue 3 + Element Plus 的后台管理系统前端项目,提供了完整的后台管理功能界面。

## 技术栈
- Vue 3 
- Element Plus UI组件库
- Vue Router 路由管理
- Pinia 状态管理
- Vite 构建工具
- ES6+ JavaScript语法

## 功能模块
1. 用户认证
   - 登录/注册
   - 验证码
   - Token 认证

2. 系统管理
   - 用户管理
   - 角色管理
   - 菜单管理
   - 权限配置

3. 导航管理
   - 导航分组
   - 导航链接

4. 其他功能
   - 面包屑导航
   - 动态菜单
   - 权限控制

## 快速开始

### 环境要求
- Node.js 16+
- npm 8+

### 安装依赖
```bash
npm install
```

### 运行项目
```bash
npm run dev
```

### 构建项目
```bash
npm run build
```



## 项目结构
vue-admin
├── public # 静态资源
├── src # 源代码
│ ├── assets # 资源文件
│ ├── components # 公共组件
│ │ ├── Breadcrumb # 面包屑导航
│ │ ├── MenuItem # 菜单项组件
│ │ └── MenuPermission # 权限配置组件
│ ├── config # 全局配置
│ ├── router # 路由配置
│ ├── stores # Pinia状态管理
│ ├── utils # 工具函数
│ └── views # 页面组件
│ ├── dashboard # 仪表盘
│ ├── login # 登录页
│ ├── nav # 导航管理
│ └── system # 系统管理
├── .env # 开发环境配置
├── .env.production # 生产环境配置
└── package.json # 项目依赖





## 开发规范
1. 组件命名采用大驼峰命名法
2. 文件夹和文件采用小写+横线命名法
3. 组件 props 必须指定类型
4. 使用 setup 语法糖编写组件
5. 统一使用 Element Plus 组件库
6. API 请求统一使用封装的 request 方法

## 环境变量
- VITE_API_URL: API接口地址

## 项目配置
配置文件位于 src/config/config.js:
- baseURL: API基础请求地址
- timeout: 请求超时时间
- tokenKey: token存储键名
- userKey: 用户信息存储键名

## 构建部署
1. 修改 .env.production 中的配置
2. 执行构建命令: npm run build
3. 将 dist 目录下的文件部署到 Web 服务器

## 许可证
Apache License 2.0