之所以叫ghChat，是想着以后做一些GitHub的集成，希望让这个即时通讯工具成为chat tool for github。目前只支持github授权登录，和展示github用户公开的信息，然后可以方便地在ghChat中为自己的github项目建个项目群，然后贴群链接到readme中，方便项目即时交流。

地址

github项目地址。富应用型的开发很耗时间精力，觉得还不错的麻烦给个star鼓励下ʘᴗʘ

应用线上地址(也是项目的群链接)，支持直接github授权登录

技术栈

前端React全家桶，后端node.js(koa2), 数据库MySQL, 双向通信SocKet.io, jwt鉴权等等。具体看package.json。有疑问的可以加ghChat群交流哦，我每天都在线，也可以私聊我，点击加我

项目展示：

之前某个时间的大部分功能的截图，其他功能和新功能直接线上体验。

建议开启PWA: 如何在chrome浏览器中开启对PWA的支持

目前进度

• 账户

  • [x] 登录
  • [x] 注册
  • [x] 退出登录
  • [x] 多设备同时登录

• 对github的集成

  • [x] 支持github授权登录
  • [x] 展示github用户公开的信息

• UI

  • [x] 弹窗，提示等基础组件
  • [x] 响应式布局, 适配桌面端和移动端。

• 私聊

  • [x] 私聊
  • [x] 添加联系人
  • [x] 好友资料展示
  • [x] 删除联系人

• 群聊

  • [x] 群聊
  • [x] 建群
  • [x] 加群
  • [x] 群资料展示
  • [x] 退群
  • [x] 编辑群资料
  • [x] 有人加入群时会有提示

• 查询

  • [x] 用户搜索&&群搜索： 支持前端模糊搜索和后端模糊搜索

• 丰富聊天方式

  • [x] 聊天页表：实时按时间降序展示联系过的人和加入的群
  • [x] 发图
  • [x] 发表情
  • [x] 发文件
  • [x] 下载文件
  • [x] Enter快捷键发送信息,发送按钮灰亮
  • [x] @某人
  • [x] 图片放大查看
  • [x] 发送copy的图片(如截图后粘贴可直接发图)
  • [x] 分享群|联系人给其他的人|群（应用内|外都支持）
  • [ ] 提供在线表情库
  • [ ] 支持Markdown
  • [ ] 支持Quote

• 新消息提示

  • [x] 浏览器桌面通知（生产环境下，使用chrome的桌面通知需要你的网站是HTTPS的）
  • [x] 列表未读消息数目提示
  • [x] 刷新/重开/(不同账号)重登页面，列表未读消息的数目将仍然且准确显示

• 不断的重构和性能优化

  • [x] gzip 压缩
  • [x] 聊天内容懒加载，每次获取20条数据
  • [x] 路由按需加载
  • [x] 接口请求频率限制
  • [ ] css文件单独打包
  • [ ] sql优化

• 其他

  • [x] 机器人智能聊天回复
  • [x] 部署SSL证书
  • [x] 支持PWA
  • [ ] 国际化
  • [ ] 后端用TS重写，封装成sdk
  • [ ] CI/CD

项目结构图

├── LICENSE
├── README-zh_CN.md
├── README.md
├── build
├── package-lock.json
├── package.json
├── postcss.config.js
├── secret.js // 放一些非公开的secret
├── server  // 后端代码
│   ├── config.js
│   ├── controllers
│   ├── ecosystem.config.js // pm2加生产环境变量的配置文件
│   ├── gulpfile.js
│   ├── index.js
│   ├── init  // 初始化mysql
│   ├── middlewares
│   ├── models
│   ├── package-lock.json
│   ├── package.json
│   ├── routes  // 后端路由，跟登录注册模块有关
│   ├── socket  // 除了登录注册，其他都用socket 来通信
│   ├── utils
│   └── yarn.lock
├── src  // 前端代码
│   ├── App.js
│   ├── app.scss
│   ├── assets
│   ├── components
│   ├── containers
│   ├── index.html
│   ├── index.js
│   ├── manifest.json // PWA需要
│   ├── modules
│   ├── redux
│   ├── router
│   ├── service-worker.js // PWA需要
│   └── utils
├── webpack.common.config.js  // 通用webpack设置
├── webpack.config.js  //生产相关的webpack配置
├── webpack.dev.config.js  //开发相关的webpack配置

本地开发

1. 项目拉到本地

git clone https://github.com/aermin/react-chat.git

1. 在react-chat文件夹下创建一个secret.js的空白文件。

如果要使用github授权登录，使用七牛云cdn，生产环境数据库和jwt的secret的单独配置，就要填充相应的配置了。

module.exports = {
  client_secret: '', // github授权登录需要的  github-> settings ->  Developer settings 那边生成获取
  db: {
    host: '', // 数据库IP
    port: , // 数据库端口
    database: '', // 数据库名称
    user: '', // 数据库用户名
    password: '', // 数据库密码
  },
  secretValue: '', // json web token 的 secret
  qiniu: { // 七牛云配置
    accessKey: '',
    secretKey: '',
    bucket: ''
  }
};

1. 下载前端的npm包

cd react-chat

npm i

1. 下载后端的npm包

cd cd react-chat/server 

npm i

1. 初始化数据库

//需要先在本地建一个名为ghchat的mysql数据库
配置如下看react-chat/server/config.js

npm run init_sql    //然后查看下数据库是否init成功

1. 跑起前端和后端的代码

npm run start

cd ..      // 返回到react-chat/目录

npm run start

ps: 本地发图片和发文件和github登录无法使用，需要自己去github和七牛云申请一些东西

文档

这边开坑了一篇ghChat开发历程 ，将不断地更新总结做这个全栈项目时会遇到的问题，知识点，和坑。