Tyloo Chat

Tyloo-Chat(仿wechat)

線上訪問地址暫時關閉

說明

本項目fork自genal-chat做了優化升級,感謝大佬Genal開源提供思路!

目前還在抽空持續優化中,敬請期待!!!

覺得還不錯的話可以點個Star鼓勵一下!!!

Electron版本客戶端已出爐,詳見release

部分功能截圖

• 整體界面

• 通訊錄

• 群聊功能(群成員列表,在線狀態,支持添加群成員)
• 會話列表(置頂/刪除)

• 消息撤回功能

Electron版本客戶端(位於electron_version分支)

• windows版本(exe)

• mac版本(dmg)

Feature

• 用戶登陸註冊(支持嵌入第三方系統單點登陸)
  • 單點登陸地址,登錄後點擊右上角在線交流按鈕
• 群聊(類似qq群)
  • 邀請好友加入群聊
  • 修改群名/群公告
• 好友功能
• 通訊錄功能(支持接入第三方系統組織架構,直接發起聊天)
• 聊天功能
  • Emoji表情包
  • 圖片發送/圖片預覽
  • 發送附件
  • 消息分頁
  • 消息撤回/複製
• 自定義主題
• 會話置頂/刪除
• 重連提醒
• 智能助手(默認,位於main分支,採用ES搜索引擎需要手動創建ES詞庫)
• 第三方API機器人(當前線上demo版本,位於feature_APIROBOT分支)
• Electron版本(位於electron_version分支,支持生成dmg,exe客戶端)

技術棧

• 前端

  • vue cli 4.x
  • Antd for vue

• 後端

  • NestJS
  • TypeORM
  • Mysql

• Socket.io

• ElasticSearch ES搜索引擎(用於機器人快捷自動回复)

• Nodejieba node版本中文分詞器

數據庫表結構設計

環境準備

• mysql
• chat數據庫(需要手動創建,注意數據庫編碼格式為utf8bm64``utf8bm64``utf8bm64 !!! )
• node v10.16.3

拉取代碼時注意事項

 // windows系统需要配置一下,提交时转换为LF，检出时不转换
git config --global core.autocrlf input

 // 设置为区分大小写
git config core.ignorecase false

運行項目

 // client
cd client 
cnpm i
npm start 

 // server
cd server
cnpm i
npm run start 

如何部署

Deploy

CentOS下部署聊天室

第三方集成/單點登陸

• 第三方系統裡嵌入如下跳轉代碼,需要攜帶userId以及username參數

 let chatUrl // 当前聊天室客户端地址
let userId // 当前系统用户userId
let username // 当前系统用户昵称

window . open ( ` ${ chatUrl } ?userId= ${ userId } &username= ${ username } ` ) ;

• 聊天室獲取參數並自動完成登陸(若為首次登陸會自動註冊賬號)

• 設置聊天室client VUE_APP_ORG_URL為獲取第三方系統組織架構的接口地址

  • 設置VUE_APP_ORG_URL

   // .env.xxx
  // 此接口可以获取到第三方系统的所有部门和人员信息,注意为嵌套tree结构
  VUE_APP_ORG_URL = http : / / 127.0 .0 .1 : 8080 / api / getDeptUsersTree

  • 切換到聯繫人界面自動發出請求

   // Contact.vue
  axios . post ( process . env . VUE_APP_ORG_URL ) . then ( ( res ) => {
      this . organizationArr = res . data . data ;
  } ) ;

  • 返回值格式如下

   interface node {
      id: string ; // id
      label: string ; // 名称
      flag: boolean ; // 是否有下级结点
      children: node [ ] ; // 下级结点
  }

  • 若不需要集成第三方組織架構清空VUE_APP_ORG_URL即可,其他情況自行定制修改。

思路概述

webSocket建立流程

TODO

• @功能实现
• 消息转发
• 代码性能优化
• 群聊功能继续完善
• 微信快捷登陆
• Electron客户端检查更新

交流群