作者：C1own
homie 匹配系统是一个移动端网页的在线云交友平台。实现了按标签匹配、查找用户，基于 Redis GEO 实现搜索附近用户，同时个人还可以建队、组队以打造个人学习队伍。除了添加好友、搜索好友外，还基于 Websocket 实现好友间私聊，方便用户寻找志同道合的学习搭子。
| 技术 | 用途 | 版本 |
|---|---|---|
| Vue | 前端经典框架，方便开发页面 | 3.3.11 |
| Vue-Router | 细致的导航控制 | 4 |
| Axios | 发送请求至后端 | 1.6.2 |
| Vant | 移动端样式组件库 | 4.8.0 |
| Vite | 前端构建工具 | 5.0.8 |
| 技术 | 用途 | 版本 |
|---|---|---|
| Spring Boot | 快构建 Spring 应用 | 2.7.6 |
| JDK | Java 应用开发工具 | 1.8 |
| MyBatis | 操作数据库的框架 | 3.5.2 |
| MyBatis-Plus | MyBatis的增强框架，无需编写 SQL 语句 | 3.5.2 |
| MySQL | 一个关系型数据库产品，用于存储数据 | 8.0..33 |
| Redis | 一个非关系型数据库产品，用于存储数据 | 5. |
| WebSocket | 使得客户端和服务器之间的数据交换变得更加简单 | 2.4.1 |
| Lombok | 实体类方法的快速生成工具 | |
| knife4j | 在线接口文档生成的库 | 2.0.9 |
| EasyExcel | 快速、低占用地操作 Excel | 3.3.2 |
| hutool | 强而全的工具库 | 5.7.17 |
| Guava-Retrying | 提供重试机制的库 | 1.0.6 |
| Apache-commons-lang3 | 工具库 | 3.12.0 |
一个普通学校的大三学生，即将大四毕业了，正在做毕设。
觉得项目还不错的同学可否给我项目点个 Star 呢？如果可以，小弟不胜感激，谢谢！
登录
注册
首页
按标签匹配相似用户
按标签搜索用户
按距离搜索用户
好友页面
搜索好友
好友私聊
建队
个人页面
- 基于 Spring AOP + Axios 实现前端登录拦截
- 基于 Redis 实现分布式 Session 存储
- 使用 Redis List 结构配合 Vue-infinite-loading 组件实现滑动加载
- Spring Scheduling + Redis 分布式锁实现缓存预热
- 了解编辑距离算法，可用于匹配相似字符串，单词校验
- 基于 Redis GEO 存储用户地理微信信息，实现搜索附近用户
- 基于 Redis 分布式锁防止用户重复入队
- 通过 Guava 库实现重试机制，保证缓存数据一致性
- 基于 Websocket 实现用户间私聊
- 集成第三方库生成接口测试文档，方便测试项目接口
- 熟悉 EasyExcel 的使用
- 基于 Axios 封装请求实例，方便请求后端接口
- 熟悉 Vant 组件库的使用
- 熟悉 Vue3 setup 语法
- 掌握 Vue-Router 基本使用
如果大家拉取了后端源码，直接找到 sql/create_sql.sql 文件直接运行即可创建相应数据库和表结构
/*用户表*/
create table hjj.user
(
id bigint auto_increment comment 'id'
primary key,
username varchar(256) null comment '用户昵称',
userAccount varchar(256) null comment '账户',
avatarUrl varchar(1024) null comment '用户头像' default 'https://www.keaitupian.cn/cjpic/frombd/0/253/936677050/470164789.jpg',
gender tinyint null comment '用户性别',
profile varchar(512) null comment '个人简介',
userPassword varchar(512) not null comment '用户密码',
phone varchar(128) null comment '电话',
email varchar(512) null comment '邮箱',
userStatus int default 0 not null comment '状态 0 - 正常',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',
isDelete tinyint default 0 not null comment '是否删除',
userRole int default 0 not null comment '用户角色 0 - 普通用户 1 - 管理员',
planetCode varchar(512) null comment '星球编号',
tags varchar(1024) null comment '标签列表(json)',
longitude decimal(10, 6) null comment '经度',
dimension decimal(10, 6) null comment '纬度'
)
comment '用户';/*队伍表*/
create table if not exists hjj.team
(
id bigint auto_increment comment 'id'
primary key,
teamName varchar(256) not null comment '队伍名称',
description varchar(1024) null comment ' 描述',
maxNum int default 1 null comment '最大人数',
expireTime datetime null comment '过期时间',
userId bigint not null comment '队伍创建者/队长id',
status tinyint default 0 null comment '队伍状态 - 0 - 公开， 1 - 私有，2 - 加密
- ',
password varchar(512) null comment '队伍密码',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',
isDelete tinyint default 0 not null comment '是否删除'
)
comment '队伍信息';/*用户队伍关系*/
create table if not exists hjj.user_team
(
id bigint auto_increment comment 'id'
primary key,
userId bigint comment '用户id',
teamId bigint comment '队伍id',
joinTime datetime comment '加入时间',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',
isDelete tinyint default 0 not null comment '是否删除'
)
comment '用户队伍关系表';/*好友表*/
create table hjj.friend
(
id bigint auto_increment comment 'id'
primary key,
userId bigint not null comment '用户id（即自己id）',
friendId bigint not null comment '好友id',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',
isDelete tinyint default 0 not null comment '是否删除'
)
comment '好友表';/*聊天表*/
CREATE TABLE `chat` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '聊天记录id',
`fromId` bigint(20) NOT NULL COMMENT '发送消息id',
`toId` bigint(20) NULL DEFAULT NULL COMMENT '接收消息id',
`text` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL,
`chatType` tinyint(4) NOT NULL COMMENT '聊天类型 1-私聊 2-群聊',
`createTime` datetime NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updateTime` datetime NULL DEFAULT CURRENT_TIMESTAMP,
`teamId` bigint(20) NULL DEFAULT NULL,
`isDelete` tinyint(4) NULL DEFAULT 0,
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '聊天消息表' ROW_FORMAT = COMPACT;基础环境
- 软件：WebStorm 2022.2.5 / Vscode
- 环境：Node 版本：18.0.2
1）拉取项目
git clone https://github.com/dnwwdwd/homeiMatching-frontend.git2）安装依赖
npm install3）运行项目
npm run dev4）打包项目
npm run build1）对于拉去后端项目的同学直接运行 /sql/create_sql.ql 文件即可，前提电脑装了 MySQL（5.7 或 8.x 都可）
2）完事后将 application.yml 文件中数据库的账号密码改为自己的即可，对了此项目还用了 Redis，所以还要修改 Redis 的连接配置，有密码的加上密码
spring:
profiles:
active: dev
mvc:
pathmatch:
matching-strategy: ant_path_matcher
application:
name: homieMatching
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/hjj?characterEncoding=UTF-8
username: root
password: 123456
session:
timeout: 86400
store-type: redis
redis:
port: 6379
host: localhost
database: 0
server:
port: 8080
servlet:
context-path: /api
session:
cookie:
domain: localhost
same-site: none
secure: true
mybatis-plus:
configuration:
map-underscore-to-camel-case: false
global-config:
db-config:
logic-delete-field: isDelete
logic-delete-value: 1
logic-not-delete-value: 0基础环境
- 软件：IDEA 2023.1.6
- JDK 1.8 + MySQL 8.0.33 + Redis 5.x（最好是 5.x 以上） + Spring Boot 2.7.6
更细的环境请看上面的技术选型，上面有具体的依赖关系和版本。
各位一定要注意在启动后端前，一定要先建好数据库表和安装 Redis，改好 yml 文件的连接信息再启动后端。
1）拉取项目
git clone https://github.com/dnwwdwd/homieMatching.git2）点击小圆圈重新加载所有 Maven 项目 ，下载依赖。
3）启动后端
找到 HomieMatchingApplication 主类，点击运行即可。
跟着上面的教程一步一步来即可，不行你不会，如果中间有任何问题欢迎在这个网站，或者 CSDN 上，亦或者是微信上向我提问。觉得项目还不错的话，请给我点个 Star 呗，谢谢！