1、项目介绍

1.1 项目概括

本项目是一个前端基于vite、react、ts，后端基于express、mysql，并依赖websocket、webrtc实现的局域网实时聊天全栈项目，且持续开源和维护。

先放在开头：

👉 项目演示视频地址：https://www.bilibili.com/video/BV1mi421C7Ym

🔨 项目说明文档掘金地址：https://juejin.cn/post/7370963861645017097

（希望各位看官给新人 up 主一键三连 + 给本菜鸡的项目点个 star⭐，不胜感激。）

1.2 为什么要开发这个项目？

先写在前面：本项目是个人学习过程中开发的项目，功能简单、界面简洁，各方面的考虑较为粗糙，适合正在练习上述技术栈的小白进行学习和巩固，代码量极少且逻辑清晰。(大佬勿喷)
注意：本人后面计划整理出项目核心功能的开发教程，发表在本人的掘金博客上，确保对上述技术栈几乎陌生的小白，跟着教程也完全可以从 0 到 1 实现项目。因此希望各位同学点点关注。

1.3 谁需要这个项目？

本项目适合以下同学：

学习了vite、react、ts等技术栈而没有找到一个好的项目进行实践。
想不局限于前端，希望了解后端一些基本知识应用的同学。（如果有写Java、Go等语言的后端同学需要找项目进行实践，也可对该项目的后端用Java进行重构升级，目前的项目后端部分只是为前端提供了简单服务而已，很多东西没有考虑到。）
想扩展自己的技术视野，了解 websocket、webrtc 等知识的基本应用的同学。
想提高自己的代码能力、工程能力的同学：
- 该系统主要可以分为三个模块共40个功能点，系统结构如下图所示:
- 工作量展示如下（已排除引用的第三方代码，只统计前后端项目下的 src 目录代码）:
  
  前端后端其它总
  
  代码行数 7269 2207 336 9812
- 同时，本项目的开发严格进行了工程化配置，前后进行了十次代码治理，降低系统“屎山代码”发生的可能性：
找实习、正式的校招前端同学，正在为简历上没有好的项目而苦恼（B 站大学的很多免费项目都是些烂大街的后台管理系统、仿 XX 商城等，面试官都看腻了）。本项目是本人校招时简历上的个人项目之一，伴随着本人校招拿到了阿里、美团、华为、OPPO 等七个中大厂 offer。本人亲测，该项目的存在会让面试官与你的可聊点变多，让你在千篇一律的简历海中脱颖而出，增加面试通过率。

	前端	后端	其它	总
代码行数	7269	2207	336	9812

1.4 项目亮点？

使用 ESLint+Prettier+Husky+Commitlint+Lint-staged 等工具统一代码和 Git 提交规范，较为完备的前端工程化配置。
项目目录结构合理、清晰，组件和方法抽象程度高，代码耦合度低，且配备较为完善的文档说明。
依赖React Router和高阶组件实现了前端路由系统，包含路由配置、路由守卫、路由重定向等功能，且结合JWT实现鉴权。
借助 MySQL、Express 完成了 7 张表、25 个接口的设计与开发，锻炼全栈能力。
基于 WebSocket 协议、WebRTC 协议实现了局域网通信和音视频通话功能，且支持群聊和群音视频。
实现了本地文件系统，针对大文件传输场景，作出分片上传处理。

1.5 一定要从 0 到 1 实现一次本项目吗？

先说回答：不是。上面提到本项目的功能点众多，工作量不少，如果从 0 到 1实现一次本项目固然收获不少，但对于部分基础好的同学来说太耗时了，也没有必要这样做。本人认为，了解本项目的架构以及核心功能的实现逻辑即可，然后对项目进行二次开发，即完成下面所提到的待完成功能会收获更大。

1.5.1 本项目的核心功能

前端路由系统（React Router的实践）
登录鉴权（jwt鉴权的实践）
建立聊天（websocket的实践）
音视频通话（借助websocket完成webrtc连接建立需要的一些信令交互）
文件上传（本地文件系统的实现）

1.5.2 本项目后续待完成的功能

增加其它功能模块或者为现有的功能模块增加其它CRUD操作，如删除好友、删除分组、退出群聊、群成员管理、好友分组管理等。
完善本地文件系统，优化文件分片上传，增加断点续传、秒传、重试机制：
- 目前项目的文件上传主要用于两处：1、个人/群聊头像上传；2、图片/视频/文件等类型消息的发送。
- 目前的本地文件系统这块实现较为草率，只实现了最基本的大文件分片上传，且存在很多问题（大图片/视频信息发送会失败、较大较复杂文件会丢失信息乱码等）。
- 代码里对于文件上传这块涉及的部分书写了TODO，可直接上手完善相关代码，完成后将是一个比较大的亮点：
完善项目的websocket心跳重连机制，保证持续连接。
前端引入MobX等库进行状态管理，后端进一步利用Redis等缓存进行性能优化。
借助electron打包成桌面应用。
租借云服务器，利用docker进行部署、实现外网通信。

1.6 项目运行截图

1.6.1 用户模块

登录界面：

注册界面：

修改个人信息：

修改密码：

1.6.2 好友模块

好友列表展示、好友信息展示及修改：

查询并添加好友：

1.6.3 聊天模块

群聊列表展示、群聊信息展示及修改：

创建群聊：

聊天界面：

图片消息预览：

视频消息预览：

对好友发起语音通话：

对群友发起语音通话：

好友收到语音通话：

群友收到语音通话：

与好友语音通话中：

与群友语音通话中：

对好友发起视频通话：

对群友发起视频通话：

好友收到视频通话：

群友收到视频通话：

与好友视频通话中：

与群友视频通话中：

2、项目开发教程

2.1 项目如何启动？

先拉取本项目到本地：

git clone [email protected]:XC0703/better-chat.git

用VScode等编辑器打开本项目（无论是用VSCode还是WebStorm进行开发，请提前安装好并配置启用两个插件：ESLint和Prettier，用于代码检查与代码格式化。）
下载根目录下的依赖：
```
pnpm install
```
启动服务端：
```
cd server
```
```
pnpm install
```
```
pnpm start
```
启动客户端：
```
cd client
```
```
pnpm install
```
```
pnpm start
```
此时浏览器会自动打开项目页面

注意：

项目启动前，先确定本地电脑已经配备好相关环境（node，mysql，redis，pnpm等），推荐用navicat作为数据库管理软件（在里面新建本项目的数据库），用redis desktop manager作为redis管理软件。

需要先全局安装pnpm，安装命令为：

npm install -g pnpm

其中关于为什么用pnpm不用npm或者yarn命令，参考博客：关于现代包管理器的深度思考——为什么现在我更推荐 pnpm 而不是 npm/yarn?

数据库安装相关：

1、MySQL8.0.26 安装配置教程 (windows 64 位)：https://blog.csdn.net/weixin_52270997/article/details/120066948
2、Navicat Premium v12.1.9 破解版 _x86_x64：https://blog.csdn.net/juanjuan_01/article/details/84102349
3、Navicat Premium 基本使用：https://blog.csdn.net/Yangchenju/article/details/80633055

Redis 安装相关：

1、Redis 下载和安装（Windows 系统）参考链接：http://c.biancheng.net/redis/windows-installer.html （注意：在执行redis-server.exe --service-start前要把客户端启动关掉，否则端口会被占用）
2、windows 免费安装 redis desktop manager（上 github 找到免费版最新的是 2018 年的，可以直接下载 exe 执行程序）：https://github.com/uglide/RedisDesktopManager/releases/tag/0.9.3
本项目的数据库配置如下：（见server\src\model\config.json文件，根据自己的实际情况作出更改）
```
{
	"host": "127.0.0.1",
	"port": 3306,
	"user": "root",
	"password": "123456",
	"database": "better-chat"
}
```
1. 首先用下面的命令或者Navicat Premium等工具建好数据库：（注意：在 MySQL 中，通常使用反引号来包围数据库、表或列名，特别是当它们包含特殊字符或关键字时。）
```
mysql -u root -p
```
```
CREATE DATABASE `better-chat`;
```
2. 然后可以用source命令或者Navicat Premium等工具运行项目下的better-chat.sql文件，方便可以在本地数据库增加一些模拟数据，同时由于静态资源存储在本地没有上传到仓库，所以需要显示的文件会呈现兜底样式，不会报错。（注意：此步可不进行，保持数据库原始空白状态。）
作者本人的环境配置：

node：v18.20.2

npm：v10.5.0

pnpm：v8.14.3

mysql：v8.0.29

redis：v5.0.14