功能一览
- 类微信 Web 聊天：好友、单聊、群聊，消息实时送达，无需刷新页面。
- 支持文字、图片、文件、语音；可引用回复、@ 成员、转发消息。
- 未读红点、会话置顶与免打扰；群聊支持未读智能摘要（可选 AI）。
- 2 分钟内可撤回消息，双方界面同步更新。
- 好友在线状态实时显示；单聊支持语音与视频通话（WebRTC）。
- 朋友圈：发动态、点赞评论，好友互动有未读提醒。
- 好友推荐、动态推荐（协同过滤算法，含演示数据）。
- 管理后台：全站消息巡查、违规删除、群组监管。
- 电脑、平板、手机浏览器均可使用，聊天界面自适应屏幕。
核心亮点与创新点
| 亮点 | 亮点说明 |
|---|---|
| WebRTC 音视频 | 单聊语音/视频通话：媒体 P2P，SDP/ICE 信令经 STOMP 转发；支持局域网 HTTPS 演示 |
| WebSocket 实时通信 | STOMP over SockJS 全双工通道；消息、撤回、好友申请、在线状态、通话信令统一推送 |
| 协同过滤推荐 | 朋友圈 Item-CF 推荐动态；好友推荐融合共同好友、共同群聊等社交图谱 |
| 群聊未读摘要 | 未读消息一键生成中文要点；可接 OpenAI 兼容大模型，未配置时规则兜底 |
| 未读位点算法 | last_read_message_id 位点 + COUNT 统计未读，会话角标与顶栏红点联动 |
| 鉴权闭环 | JWT 贯穿 REST 与 WebSocket CONNECT；会话成员校验，无法越权读他人消息 |
| 内容安全 | DFA 敏感词过滤；管理端全站检索与违规删除，操作可追溯 |
系统技术栈
| 层次 | 技术 |
|---|---|
| 后端 | Java 21、Spring Boot 3、Spring Security、JWT、Spring WebSocket（STOMP）、MyBatis-Plus |
| 前端 | Vue 3、Pinia、Element Plus、SockJS、@stomp/stompjs |
| 数据 | MySQL 8（utf8mb4） |
| 实时 | WebSocket + STOMP 推送 |
| 音视频 | WebRTC（浏览器端） |
| 智能（可选） | OpenAI 兼容接口（群未读摘要） |
| 其它 | 操作日志、接口文档（Swagger）、图形验证码 |
前后端分离；附件经鉴权上传与下载，不暴露公网静态目录。
数据库表概述
合计 14 张业务表（系统 5 + 聊天 4 + 朋友圈 5）。
系统表
| 表名 | 说明 |
|---|---|
| sys_role | 角色（管理员、普通用户） |
| sys_user | 用户账号与资料 |
| sys_menu | 后台菜单 |
| sys_login_log | 登录日志 |
| sys_operation_log | 操作日志 |
聊天表
| 表名 | 说明 |
|---|---|
| chat_friend | 好友关系与申请状态 |
| chat_conversation | 会话（单聊/群聊） |
| chat_conversation_member | 成员、已读位点、置顶免打扰 |
| chat_message | 消息内容与状态 |
朋友圈表
| 表名 | 说明 |
|---|---|
| moment_post | 动态正文 |
| moment_media | 图片/视频附件 |
| moment_like | 点赞 |
| moment_comment | 评论与回复 |
| moment_feed_state | 动态与互动已读状态 |
关系说明
- 用户与角色对应；聊天与朋友圈数据按用户隔离。
- 演示种子含多用户好友关系、群聊历史与推荐算法样例数据。
难度与范围
| 项目 | 说明 |
|---|---|
| 等级 | 标准（standard） |
| 适合 | 已学 Spring Boot + Vue，需要实时通信、社交功能完整、可答辩演示的 IM 课题 |
| 包含 | 单聊群聊、WebSocket、撤回未读、朋友圈、音视频、推荐算法、管理端监管 |
系统截图
登录页
聊天主页（会话列表 + 消息流）
移动端聊天
好友列表
群聊与群资料
朋友圈
语音/视频通话
管理端消息巡检
管理端朋友圈巡查
管理端控制台
角色与功能说明
内置 管理员、普通用户 两种登录角色。
普通用户
登录后使用前台：消息、群聊、好友、朋友圈。
认证与账号
| 功能 | 说明 |
|---|---|
| 注册 | 用户名注册，默认普通用户 |
| 登录 | 用户名、密码与图形验证码 |
| 退出 | 清除登录状态，断开 WebSocket |
| 个人中心 | 昵称、邮箱、手机等资料 |
| 修改密码 | 校验旧密码后更新 |
| 头像 | 独立头像上传 |
消息 / 单聊
| 功能 | 说明 |
|---|---|
| 会话列表 | 单聊与群聊统一列表，显示预览、时间与未读角标 |
| 实时消息 | 文字、图片、文件、语音；上拉加载历史 |
| 引用与 @ | 引用回复；群聊 @ 指定成员 |
| 转发 | 转发到其它会话 |
| 搜索 | 会话内或关键字搜索历史消息 |
| 撤回 | 2 分钟内撤回，全员同步 |
| 未读 | 进入会话后清零；顶栏汇总总未读 |
| 桌面通知 | 非当前会话新消息浏览器提醒（可关闭） |
| 会话设置 | 置顶、免打扰、删除会话 |
| 语音/视频 | 单聊发起通话，支持静音、挂断、摄像头开关 |
好友
| 功能 | 说明 |
|---|---|
| 搜索添加 | 按用户名搜索并发送好友申请 |
| 申请处理 | 同意/拒绝，实时通知 |
| 好友列表 | 备注、在线/离线状态 |
| 推荐好友 | 基于社交关系的推荐列表 |
| 删除好友 | 解除好友关系 |
群聊
| 功能 | 说明 |
|---|---|
| 创建群聊 | 选择好友建群（至少 3 人） |
| 群消息 | 全员实时接收 |
| 群资料 | 群名、公告、成员列表 |
| 成员管理 | 邀请、踢人、退群、转让群主、解散 |
| 未读摘要 | 群未读较多时生成中文要点 |
| 我的群聊 | 独立群列表页 |
朋友圈
| 功能 | 说明 |
|---|---|
| 时间线 | 浏览好友动态 |
| 发布 | 文字 + 图片或视频 |
| 点赞评论 | 含回复评论 |
| 未读 | 新动态与互动红点 |
| 推荐 | 协同过滤推荐动态 |
管理员
登录管理后台，维护用户、菜单、聊天监管与日志。
控制台与用户
| 功能 | 说明 |
|---|---|
| 控制台 | 消息量、登录趋势等数据图表概览 |
| 用户管理 | 增删改查、角色分配 |
| 菜单管理 | 后台菜单配置 |
| 系统日志 | 登录与操作日志 |
聊天监管
| 功能 | 说明 |
|---|---|
| 消息巡检 | 按发送者/会话名称、关键字检索全站消息 |
| 删除消息 | 标记违规并写操作日志 |
| 朋友圈巡查 | 按发布者名称、关键字检索动态 |
| 群组管理 | 查看群列表、强制解散 |