# BigEvent

**Repository Path**: yun_long_wang/big-event

## Basic Information

- **Project Name**: BigEvent
- **Description**: 黑马程序员Vue3+AntDesignVue大事件big_event前后端工程
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Vue

## README

# 大事件（Big Event）

一个前后端分离的内容管理系统（CMS），支持用户注册登录、文章分类管理、文章管理、头像与文件上传等功能。

## 项目结构

```
big-event/
├── src/                          # 后端（Spring Boot）
│   └── main/
│       ├── java/com/wyl/         # 业务代码
│       └── resources/
│           ├── config/           # 配置文件
│           ├── db/               # 数据库脚本
│           └── mapper/           # MyBatis XML
└── big-event-frontend/           # 前端（Vue 3 + Vite）
    └── src/
        ├── api/                  # 接口封装
        ├── router/               # 路由
        ├── stores/               # Pinia 状态
        ├── utils/                # 工具函数
        └── views/                # 页面组件
```

## 技术栈

### 后端

| 类别 | 技术 |
|------|------|
| 框架 | Spring Boot 3.1、MyBatis |
| 数据库 | MySQL |
| 缓存 | Redis |
| 认证 | JWT |
| 对象存储 | MinIO |
| 其他 | PageHelper 分页、Bean Validation |

### 前端

| 类别 | 技术 |
|------|------|
| 框架 | Vue 3、Vue Router 4 |
| 构建工具 | Vite 8 |
| UI 组件库 | Ant Design Vue 4 |
| 状态管理 | Pinia（含持久化） |
| HTTP | Axios |
| 富文本 | Vue Quill |

## 功能模块

- **用户**：注册、登录、基本资料、头像更换、密码重置
- **文章分类**：分类增删改查
- **文章管理**：发布 / 草稿、搜索筛选、封面上传、富文本编辑
- **文件上传**：基于 MinIO 的图片上传

## 环境要求

| 依赖 | 版本要求 |
|------|----------|
| JDK | 17+ |
| Maven | 3.6+ |
| MySQL | 5.7+ / 8.x |
| Redis | 6.x+ |
| MinIO | 最新稳定版 |
| Node.js | `^20.19.0` 或 `>=22.12.0` |

## 快速开始

### 1. 初始化数据库

创建数据库并导入脚本：

```bash
mysql -u root -p < src/main/resources/db/big_event.sql
```

或在 MySQL 客户端中执行 `src/main/resources/db/big_event.sql`。

### 2. 配置后端

编辑 `src/main/resources/config/application-dev.yml`，按本地环境修改：

- MySQL 连接（`spring.datasource`）
- Redis 连接（`spring.data.redis`）
- MinIO 配置（`minio`）

默认激活 `dev` 配置，见 `application.yml` 中的 `spring.profiles.active`。

### 3. 启动后端

```bash
mvn spring-boot:run
```

服务默认运行在：http://localhost:8080

### 4. 启动前端

```bash
cd big-event-frontend
npm install
npm run dev
```

前端默认访问：http://localhost:5173

开发环境下，`/api` 请求会通过 Vite 代理转发至 `http://localhost:8080`，配置见 `big-event-frontend/vite.config.js`。

## 主要 API

| 模块 | 路径前缀 | 说明 |
|------|----------|------|
| 用户 | `/user` | 注册、登录、用户信息、资料更新 |
| 分类 | `/category` | 分类 CRUD |
| 文章 | `/article` | 文章 CRUD、分页查询 |
| 文件 | `/file` | 文件上传 |

除登录、注册等公开接口外，其余接口需在请求头携带 `Authorization: <token>`。

## 构建部署

### 后端

```bash
mvn clean package
java -jar target/big-event-1.0-SNAPSHOT.jar
```

### 前端

```bash
cd big-event-frontend
npm run build
```

构建产物位于 `big-event-frontend/dist/`，可部署至 Nginx 等静态服务器。

## 子项目文档

前端更详细的说明见：[big-event-frontend/README.md](big-event-frontend/README.md)

## 许可证

本项目仅供学习使用。