# 瑜伽馆后台管理系统

**Repository Path**: hgh2002/YogaStudio-Admin-Pro

## Basic Information

- **Project Name**: 瑜伽馆后台管理系统
- **Description**: 瑜伽馆后台管理系统，专为瑜伽馆设计的高效管理软件，涵盖会员管理、课程安排、预约系统等功能，助力瑜伽馆运营。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-07-10
- **Last Updated**: 2025-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 瑜伽馆后台管理系统

## 一、项目概述

本项目是一个功能完善的瑜伽馆后台管理系统，采用前后端分离技术栈开发。该系统旨在为瑜伽馆的日常运营提供数字化解决方案，支持管理员、教练和学员三种角色，并根据不同角色动态展示功能菜单。

- **前端**：基于 Vue 3 和 Element Plus 构建，实现了数据可视化、课程表、在线预约、多角色权限控制等丰富的交互界面。
- **后端**：使用 Node.js 和 Express.js 搭建 RESTful API 服务，并采用 MongoDB 进行数据存储，通过 JWT (JSON Web Token) 实现安全认证。

## 二、技术栈

### （一）前端 (`StudentCourse`)

- **核心框架**: Vue 3
- **构建工具**: Vite
- **UI 组件库**: Element Plus
- **路由**: Vue Router 4
- **状态管理**: Pinia
- **HTTP 请求**: Axios
- **数据可视化**: ECharts
- **日期处理**: Moment.js
- **其他**: `crypto-js` (加密处理), `nprogress` (页面加载进度条), `pixi-live2d-display` (Live2D 看板娘)

### （二）后端 (`NodeCourse`)

- **运行环境**: Node.js
- **Web 框架**: Express.js
- **数据库**: MongoDB
- **ORM**: Mongoose
- **用户认证**: JSON Web Token (JWT)
- **其他**: `multer` (文件上传), `md5` (密码加密), `cors` (跨域处理)

## 三、主要功能模块

系统根据用户角色（管理员、教练、学员）提供不同的操作权限和视图。

- **登录/注册**: 提供用户登录和注册功能，并进行身份认证。
- **首页**: 展示欢迎信息和核心功能入口。
- **个人信息**: 用户可以查看和编辑自己的个人资料。
- **课程管理 (管理员/教练)**: 管理员和教练可以创建、编辑和删除瑜伽课程。
- **课程表**: 以日历形式直观展示每周的课程安排。
- **教练预约 (学员)**: 学员可以浏览教练列表并在线预约私人课程。
- **我的课程 (学员)**: 学员可以查看已预约的课程列表。
- **课程评价**: 学员可以对已完成的课程和私教进行评价。
- **数据图表 (管理员)**: 以图表形式展示课程销量、教练评价等多维度数据，辅助运营决策。
- **班级与权限管理 (管理员)**: 管理员可以管理班级信息和系统用户权限。
- **关于我们**: 展示瑜伽馆的基本信息。

## 四、目录结构

### （一）前端 (`StudentCourse`)

```
StudentCourse/
├── src/
│   ├── apis/         # API 请求模块
│   ├── assets/       # 静态资源 (图片, 样式)
│   ├── components/   # 公共组件
│   ├── router/       # 路由配置
│   ├── store/        # Pinia 状态管理
│   ├── utils/        # 工具函数
│   ├── view/         # 页面视图组件
│   ├── App.vue       # 根组件
│   └── main.js       # 入口文件
├── public/           # 公共资源
├── package.json      # 依赖配置
└── vite.config.js    # Vite 配置文件
```

### （二）后端 (`NodeCourse`)

```
NodeCourse/
├── config/       # 配置文件
├── db/           # 数据库连接
├── middlewares/  # Express 中间件 (如Token校验)
├── models/       # Mongoose 数据模型
├── public/       # 静态文件托管
├── router/       # 路由定义
├── uploads/      # 上传文件存储
├── utils/        # 工具函数
├── index.js      # 应用入口文件
└── package.json  # 依赖配置
```

## 五、部署与启动

### （一）环境准备

1.  **Node.js**: 请确保已安装 Node.js (建议 v16 或更高版本)。
2.  **MongoDB**: 请确保已安装并运行 MongoDB 数据库服务。

### （二）后端启动

```bash
# 1. 进入后端项目目录
cd NodeCourse

# 2. 安装依赖
npm install

# 3. 启动服务 (开发模式)
#    服务将运行在 http://localhost:3000 (或在代码中配置的端口)
npm run start
```

### （三）前端启动

```bash
# 1. 进入前端项目目录
cd StudentCourse

# 2. 安装依赖
npm install

# 3. 启动开发服务器
#    服务将运行在 http://localhost:5173 (或Vite指定的其他端口)
npm run dev
```

## 六、注意事项

- 启动后端服务前，请务必确保 MongoDB 数据库已成功连接。
- 项目包含了丰富的角色权限控制，请使用不同角色的账号登录以体验完整功能。
- 前端项目中使用了 Live2D 模型，首次加载可能需要一些时间。

## 七、项目展示
![课程管理](/image.png)
![课程表](image2.png)
![图表数据](/image3.png)
![评价](/image4.png)