Tyloo Chat

Tyloo-Chat (imitation wechat)

Online access address is temporarily closed

illustrate

This project fork has been optimized and upgraded from general-chat. Thanks to the boss Genal for its open source ideas!

It is still time to continue to optimize, so stay tuned!!!

If you think it's pretty good, please click Star to encourage it!!!

Electron version client has been released, see release for details

Screenshots of some functions

• Overall interface

• Contacts

• Group chat function (group member list, online status, support for adding group members)
• Session list (top/delete)

• Message retraction function

Electron version client (located in the electron_version branch)

• Windows version (exe)

• mac version (dmg)

Feature

• User login registration (supports single login embedded in third-party systems)
  • Single sign-in address, click the online communication button in the upper right corner after logging in
• Group chat (similar to QQ group)
  • Invite friends to join the group chat
  • Modify group name/group announcement
• Friends function
• Contact book function (supports access to the third-party system organizational structure and initiates chat directly)
• Chat function
  • Emoji emoji pack
  • Image Send/Picture Preview
  • Send attachments
  • Message pagination
  • Message retraction/copy
• Custom theme
• Session top/delete
• Re-connect reminder
• Smart Assistant (default, located in the main branch, using ES search engine requires manual creation of ES thesaurus)
• Third-party API robot (current online demo version, located in the feature_APIROBOT branch)
• Electron version (located in the electron_version branch, supports generation of dmg and exe clients)

Technology stack

• front end

  • vue cli 4.x
  • Antd for vue

• rear end

  • NestJS
  • TypeORM
  • Mysql

• Socket.io

• ElasticSearch ES search engine (used to robots for quick and automatic responses)

• Nodejieba node version Chinese word segmenter

Database table structure design

Environmental preparation

• mysql
• chat database (need to be created manually, please note that the database encoding format is utf8bm64``utf8bm64``utf8bm64 !!! )
• node v10.16.3

Things to note when pulling code

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

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

Run the project

 // client
cd client 
cnpm i
npm start 

 // server
cd server
cnpm i
npm run start 

How to deploy

Deploy

Deploy chat rooms under CentOS

Third-party integration/single sign-in

• The following jump code is embedded in the third-party system, and userId and username parameters are required.

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

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

• The chat room obtains parameters and automatically completes login (if it is the first time you log in, you will automatically register an account)

• Set the chat room client VUE_APP_ORG_URL to obtain the interface address of the organizational structure of the third-party system

  • Set VUE_APP_ORG_URL

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

  • Switch to the contact interface to automatically issue requests

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

  • The return value format is as follows

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

  • If you do not need to integrate the third-party organizational structure, just clear VUE_APP_ORG_URL , and customize and modify it yourself in other situations.

Overview of ideas

webSocket establishment process

TODO

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

Communication group