# mybolg_cloud

**Repository Path**: lliujc/mybolg_cloud

## Basic Information

- **Project Name**: mybolg_cloud
- **Description**: 博客后台，本项目采用 Springcloud版本框架搭建。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-06
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 博客系统

## 项目简介

本项目是一个基于Spring Boot 3.x的微服务架构博客系统，支持文章管理、分类管理、标签管理、评论管理、用户管理、搜索功能等核心功能。

## 技术栈

### 后端技术
- **Spring Boot 3.x**: 基础框架
- **Spring Cloud**: 微服务架构
  - Spring Cloud Gateway: API网关
  - Spring Cloud OpenFeign: 服务调用
  - Spring Cloud Alibaba Nacos: 服务注册与发现
- **MyBatis Plus**: ORM框架
- **Spring Security**: 安全框架
- **OAuth2**: 认证授权
- **Elasticsearch**: 搜索引擎
- **七牛云**: 对象存储
- **JWT**: 令牌认证
- **MySQL**: 关系型数据库
- **Redis**: 非关系型数据库

### 前端技术
- 前端框架: 待定
- 状态管理: 待定
- UI组件库: 待定

## 项目架构

### 模块划分

| 模块名称 | 端口 | 功能描述 |
| :--- | :--- | :--- |
| blog-gateway | 8080 | API网关，统一路由管理 |
| blog-nacos | 8848 | 服务注册与发现 |
| blog-oauth2 | 8081 | 认证授权服务 |
| blog-user | 8082 | 用户管理服务 |
| blog-article | 8083 | 文章管理服务 |
| blog-category | 8084 | 分类管理服务 |
| blog-tag | 8085 | 标签管理服务 |
| blog-comment | 8086 | 评论管理服务 |
| blog-search | 8087 | 搜索服务 |
| blog-common | - | 公共模块，提供通用工具和DTO |
### 页面截图
1.首页
![首页](shouye.png)

2.标签页
![标签](tag.png)

3.归档页面
![归档](guidang.png)

4.文章详情

![文章](article.png)

5.管理页面

![输入图片说明](manager.png)

### 核心流程

1. **用户认证流程**:
   - 用户通过OAuth2服务获取JWT令牌
   - 后续请求携带令牌通过网关认证
   - 网关验证令牌有效性并转发请求

2. **文章发布流程**:
   - 用户通过文章服务发布文章
   - 文章服务保存文章内容和标签关联
   - 文章服务同步文章到Elasticsearch

3. **搜索流程**:
   - 用户通过搜索服务查询文章
   - 搜索服务调用Elasticsearch API
   - 返回高亮显示的搜索结果

## 功能特性

### 1. 文章管理
- 发布、编辑、删除文章
- 文章列表查询（支持分页）
- 文章详情查询
- 按用户、分类、标签查询文章
- 文章内容图片处理和上传

### 2. 分类管理
- 分类列表查询
- 按分类查询文章

### 3. 标签管理
- 标签列表查询
- 按标签查询文章
- 文章标签关联

### 4. 评论管理
- 文章评论列表
- 添加评论

### 5. 用户管理
- 用户注册、登录
- 权限控制
- 角色管理

### 6. 搜索功能
- 文章全文搜索
- 搜索结果高亮显示
- 模糊查询支持

### 7. 媒体管理
- 图片上传到七牛云
- 图片处理和压缩

## 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Elasticsearch 7.x+
- Nacos Server 2.x+

### 启动步骤

1. **启动依赖服务**:
   - 启动MySQL
   - 启动Elasticsearch
   - 启动Nacos Server

2. **初始化数据库**:
   - 执行 `sql/create_tables_myblog.sql` 创建数据表

3. **配置修改**:
   - 修改各服务的 `application.yml` 配置文件
   - 配置数据库连接
   - 配置Nacos地址
   - 配置七牛云参数
   - 配置Elasticsearch地址

4. **编译打包**:
   ```bash
   mvn clean package
   ```

5. **启动服务**:
   - 按顺序启动：nacos → oauth2 → user → category → tag → article → comment → search → gateway

### API文档

#### 认证相关
- `POST /api/oauth2/token` - 获取令牌

#### 文章相关
- `GET /api/article/list` - 文章列表（支持分页）
- `GET /api/article/info/{id}` - 文章详情
- `POST /api/article/create` - 创建文章
- `PUT /api/article/update` - 更新文章
- `DELETE /api/article/delete/{id}` - 删除文章
- `PUT /api/article/status/{id}` - 修改文章状态
- `GET /api/article/list/user/{userId}` - 按用户查询文章
- `GET /api/article/list/category/{categoryId}` - 按分类查询文章
- `GET /api/article/list/tag/{tagId}` - 按标签查询文章
- `POST /api/article/upload/image` - 上传图片

#### 分类相关
- `GET /api/category/list` - 分类列表

#### 标签相关
- `GET /api/tag/list` - 标签列表
- `GET /api/tag/articles/{id}` - 按标签查询文章

#### 评论相关
- `GET /api/comment/list/article/{articleId}` - 文章评论列表
- `POST /api/comment/create` - 创建评论

#### 搜索相关
- `GET /api/search/article` - 文章搜索

## 目录结构

```
blog-system/
├── blog-article/        # 文章服务
├── blog-category/       # 分类服务
├── blog-comment/        # 评论服务
├── blog-common/         # 公共模块
├── blog-gateway/        # 网关服务
├── blog-nacos/          # 注册中心服务
├── blog-oauth2/         # 认证授权服务
├── blog-search/         # 搜索服务
├── blog-tag/            # 标签服务
├── blog-user/           # 用户服务
├── sql/                 # SQL文件
└── README.md            # 项目文档
```

## 许可证

本项目采用 MIT 许可证。