# 智能用户推荐系统

**Repository Path**: xqstephen/smart-user-recommendations-system

## Basic Information

- **Project Name**: 智能用户推荐系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-16
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Vue

## README

# Make Friend · 交友组队平台

一个基于 **Spring Boot + Vue 3 + Vant + WebSocket** 的移动端交友 / 组队应用。

用户可以通过 **随机推荐、相似度匹配、标签搜索** 等方式发现志同道合的朋友，创建或加入队伍，并基于 WebSocket 进行实时聊天。


---


### 1. 登录 / 注册

<!-- 截图占位：登录页（路由 /login）→ docs/images/01-login.png -->
<img src="docs/images/01-login.png" alt="登录页截图（docs/images/01-login.png）" width="300" />

注册时用户码随便输入,只要不重复即可
<!-- 截图占位：注册页（路由 /register）→ docs/images/02-register.png -->
<img src="docs/images/02-register.png" alt="注册页截图（docs/images/02-register.png）" width="300" />

### 2. 首页 / 发现用户

<!-- 截图占位：首页（路由 /home，随机 / 推荐 / 匹配三个 Tab）→ docs/images/03-home.png -->
<img src="docs/images/03-home.png" alt="首页截图（docs/images/03-home.png）" width="300" />

可点击开始聊天与用户建立对话
<!-- 截图占位：用户详情页（路由 /user/:id）→ docs/images/04-user-detail.png -->
<img src="docs/images/04-user-detail.png" alt="用户详情页截图（docs/images/04-user-detail.png）" width="300" />

### 3. 搜索

<!-- 截图占位：搜索页（路由 /search，关键词 + 标签云）→ docs/images/05-search.png.png -->
<img src="docs/images/05-search.png" alt="搜索页截图（docs/images/05-search.png）" width="300" />

搜索结果
<!-- 截图占位：搜索结果页（路由 /search/result，用户 / 队伍 Tab）→ docs/images/06-search-result.png -->
<img src="docs/images/06-search-result.png" alt="搜索结果页截图（docs/images/06-search-result.png）" width="300" />

### 4. 组队

<!-- 截图占位：找队伍页（路由 /teamup）→ docs/images/07-team-square.png -->
<img src="docs/images/07-team-square.png" alt="找队伍页截图（docs/images/07-team-square.png）" width="300" />

可自己创建队伍
<!-- 截图占位：创建 / 修改队伍弹窗（TeamForm 组件）→ docs/images/08-team-create.png -->
<img src="docs/images/08-team-create.png" alt="创建队伍弹窗截图（docs/images/08-team-create.png）" width="300" />

有密码队伍防止其他人加入
<!-- 截图占位：加入加密队伍的密码弹窗（TeamPwd 组件，可选）→ docs/images/09-team-join.png -->
<img src="docs/images/09-team-join.png" alt="加入加密队伍弹窗截图（docs/images/09-team-join.png）" width="300" />

可查询我自己创建的队伍
<!-- 截图占位：我的队伍页（路由 /my-team，我创建的 / 我加入的）→ docs/images/10-my-team.png -->
<img src="docs/images/10-my-team.png" alt="我的队伍页截图（docs/images/10-my-team.png）" width="300" />

### 5. 聊天

<!-- 截图占位：消息列表（路由 /chat，会话 + 未读红点）→ docs/images/11-chat-list.png -->
<img src="docs/images/11-chat-list.png" alt="消息列表截图（docs/images/11-chat-list.png）" width="300" />

聊天对话窗口
<!-- 截图占位：聊天室（路由 /chat-room，WebSocket 实时消息）→ docs/images/12-chat-room.png -->
<img src="docs/images/12-chat-room.png" alt="聊天室截图（docs/images/12-chat-room.png）" width="300" />

### 6. 个人中心

<!-- 截图占位：个人中心（路由 /person）→ docs/images/13-person.png -->
<img src="docs/images/13-person.png" alt="个人中心截图（docs/images/13-person.png）" width="300" />

---

## ✨ 功能特性

### 👤 用户模块
- 用户注册 / 登录 / 退出登录（Session 保存到 Redis）
- 查看和修改个人资料（用户名、性别、电话、邮箱、头像）
- 头像上传（阿里云 OSS / 腾讯云 COS）
- 个人标签管理（添加、删除标签）

### 🔍 发现用户
- **随机用户**：随机推荐在线用户
- **推荐用户**：分页推荐，支持下拉刷新和上拉加载
- **匹配用户**：根据标签相似度算法推荐（编辑距离 / 相似度）
- 用户详情页：标签、性别、脱敏联系方式、一键开始聊天

### 🔎 搜索模块
- 按用户名 / 队伍名称 / 描述关键词搜索
- 热门标签云，点击标签快速搜索
- 搜索结果区分「匹配用户」和「匹配队伍」

### 🛡️ 组队模块
- 创建 / 修改 / 解散队伍
- 队伍状态：公开、私有、加密（加密队伍需要密码加入）
- 队伍人数上限、过期时间
- 加入队伍、退出队伍
- 「我的队伍」：我创建的 / 我加入的

### 💬 聊天模块
- 会话列表：最后一条消息、时间、未读数
- 历史消息分页加载
- **WebSocket 实时收发消息**，断线自动重连
- 未读消息清除、消息按日期分组展示

### ⚙️ 基础设施
- 全局统一响应体 `BaseResponse` + 全局异常处理
- 登录拦截器 `LoginInterceptor`，未登录统一返回 40100
- Redis 分布式缓存、Redisson 分布式锁
- 重要用户缓存定时任务
- 阿里云 OSS / 腾讯云 COS 对象存储

---

## 🧰 技术栈

### 后端

| 技术 | 版本 / 说明 |
| --- | --- |
| Java | 1.8 |
| Spring Boot | 2.6.4 |
| MyBatis-Plus | 3.5.1 |
| MySQL | 8.x（`mysql-connector-java`） |
| Redis + Spring Session | 分布式会话 / 缓存 |
| Redisson | 3.17.7（分布式锁） |
| WebSocket | `spring-boot-starter-websocket` |
| 腾讯云 COS | `cos_api` 5.6.227 |
| 阿里云 OSS | `aliyun-sdk-oss` 3.17.4 |
| Gson | 2.10.1 |
| Lombok | 简化实体代码 |

### 前端

| 技术 | 版本 / 说明 |
| --- | --- |
| Vue | 3.5.30（`<script setup>`） |
| Vite | 8.0.1 |
| Vant | 4.9.24（移动端组件库） |
| Vue Router | 4.6.4 |
| Pinia | 3.0.4（状态管理） |
| Axios | 1.14.0（HTTP 请求） |
| Day.js | 1.11.20（时间格式化） |
| WebSocket | 原生 `WebSocket` + Pinia 封装 |

---

## 🗂️ 目录结构

```text
make_friend/
├── make-friend-backend/                  # Spring Boot 后端
│   ├── src/main/java/com/xy/friend/
│   │   ├── common/                       # 统一响应体、错误码、工具
│   │   ├── config/                       # Web / Redis / WebSocket / OSS 配置
│   │   ├── controller/                   # User / Team / Chat / Upload 接口
│   │   ├── exception/                    # 业务异常 + 全局异常处理
│   │   ├── interceptor/                  # 登录拦截器
│   │   ├── mapper/                       # MyBatis-Plus Mapper
│   │   ├── model/                        # domain / dto / vo / enums / request
│   │   ├── service/                      # 业务接口与实现
│   │   ├── task/                         # 定时任务
│   │   ├── utils/                        # 算法、OSS、登录用户上下文
│   │   └── websocket/                    # WebSocketServer
│   ├── src/main/resources/
│   │   ├── application.yml               # 主配置（端口 8081）
│   │   ├── application-local.yml         # 本地配置
│   │   ├── application-prod.yml          # 线上配置
│   │   └── mapper/                       # XML 映射文件
│   └── pom.xml
│
├── make-friend-f/make-friend/            # Vue 3 前端
│   ├── src/
│   │   ├── api/                          # 接口封装
│   │   ├── assets/                       # 静态资源
│   │   ├── components/                    # TeamCard / TeamForm / TeamPwd
│   │   ├── composables/                  # useWebSocket
│   │   ├── Layouts/                      # BasicLayout（底部 Tabbar）
│   │   ├── pages/                        # 页面
│   │   │   ├── Login.vue / Register.vue
│   │   │   ├── Home.vue / Search.vue / SearchResult.vue
│   │   │   ├── Chat/                     # 消息列表、聊天室
│   │   │   ├── Team/                     # 找队伍、我的队伍
│   │   │   └── User/                     # 个人中心、用户详情
│   │   ├── router/                       # 路由配置
│   │   ├── store/                        # Pinia：登录用户、WebSocket
│   │   ├── request.js                    # Axios 实例与拦截器
│   │   └── main.js
│   ├── vite.config.js                    # 开发代理（/api、/ws）
│   └── package.json
│
└── docs/images/                          # README 截图目录（见下方清单）
```

---

## 🚀 快速开始

### 1. 环境要求

| 环境 | 版本建议 |
| --- | --- |
| JDK | 1.8+ |
| Maven | 3.6+ |
| MySQL | 8.x |
| Redis | 5.x+ |
| Node.js | 20.19+ 或 22.12+（Vite 8 要求） |
| npm | 10+ |

### 2. 初始化数据库

1. 创建数据库：

   ```sql
   CREATE DATABASE make_friend DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   ```

2. 导入表结构（仓库未附带 SQL 文件，请根据下列实体表补全/导入）：
   - `user`：用户
   - `team`：队伍
   - `user_team`：用户 - 队伍关系
   - `chat_session`：聊天会话
   - `chat_message`：聊天消息
   - `chat_unread`：未读消息

3. 启动 Redis（默认使用 `db 2`）。

### 3. 启动后端

```bash
cd make-friend-backend
mvn spring-boot:run
```

或者用 IDEA 打开 `make-friend-backend`，运行 `MakeFriendApplication`。

启动前请检查 `src/main/resources/application-local.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/make_friend?serverTimezone=Asia/Shanghai
    username: root
    password: 1234        # 改成你自己的数据库密码
  redis:
    host: 127.0.0.1
    port: 6379
    database: 2

oss:
  client:
    access-key-id: xxx    # 改成你自己的 OSS 配置，不传图可暂时不填
    access-key-secret: xxx
    bucket-name: xxx
    endpoint: xxx
```

后端启动成功后：`http://localhost:8081`

### 4. 启动前端

```bash
cd make-friend-f/make-friend
npm install
npm run dev
```

浏览器访问：`http://localhost:5173`

> 前端通过 `vite.config.js` 做了开发代理：
> - `/api` → `http://localhost:8081`
> - `/ws` → `ws://localhost:8081`

### 5. 打包构建

```bash
# 前端
cd make-friend-f/make-friend
npm run build

# 后端
cd make-friend-backend
mvn clean package
```

---

## 🔌 核心接口一览

| 模块 | 方法 | 接口 | 说明 |
| --- | --- | --- | --- |
| 用户 | POST | `/user/register` | 用户注册 |
| 用户 | POST | `/user/login` | 用户登录 |
| 用户 | POST | `/user/logout` | 退出登录 |
| 用户 | GET | `/user/current` | 获取当前登录用户 |
| 用户 | POST | `/user/update` | 更新个人资料 |
| 用户 | GET | `/user/random?num=10` | 随机用户 |
| 用户 | GET | `/user/recommend?pageNum=1&pageSize=10` | 推荐用户（分页） |
| 用户 | GET | `/user/match?num=10` | 匹配用户 |
| 用户 | GET | `/user/search?username=` | 搜索用户 |
| 用户 | GET | `/user/searchByTag?tagList=` | 按标签搜索 |
| 用户 | GET | `/user/{userId}` | 用户详情 |
| 队伍 | POST | `/team/add` | 创建队伍 |
| 队伍 | GET | `/team/page` | 队伍分页 / 筛选 |
| 队伍 | POST | `/team/update` | 更新队伍 |
| 队伍 | POST | `/team/join` | 加入队伍 |
| 队伍 | POST | `/team/quit/{teamId}` | 退出队伍 |
| 队伍 | POST | `/team/delete/{teamId}` | 解散队伍 |
| 队伍 | GET | `/team/myTeam` | 我创建的 / 我加入的队伍 |
| 聊天 | GET | `/chat/session/page` | 会话列表 |
| 聊天 | POST | `/chat/message/send` | 发送消息（HTTP） |
| 聊天 | GET | `/chat/message/page` | 历史消息分页 |
| 聊天 | GET | `/chat/clearUnread` | 清除未读 |
| 聊天 | WS | `/ws/chat/{userId}` | WebSocket 实时消息 |

> 详情见 `make-friend-backend/src/main/java/com/xy/friend/controller/`。

---


## 📄 说明
`
本项目仅供学习与交流使用。
`