# kefu-rs

**Repository Path**: stringlxd/kefu-rs

## Basic Information

- **Project Name**: kefu-rs
- **Description**: rust语言的客服系统实现，资源占用更少 性能更高
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-03
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">CRMChat - 高性能客服系统</h1>

<div align="center">

![Rust](https://img.shields.io/badge/Rust-1.70+-orange?logo=rust)
![Axum](https://img.shields.io/badge/Axum-0.7-blue)
![Vue](https://img.shields.io/badge/Vue-2.x-green?logo=vue.js)
![MySQL](https://img.shields.io/badge/MySQL-5.7+-blue?logo=mysql)
![Redis](https://img.shields.io/badge/Redis-5.0+-red?logo=redis)

</div>

## 项目简介

CRMChat 是一个采用 **Rust + Vue** 开发的高性能客服系统。客服系统支持 PC端、移动端、小程序、文章中接入客服，利用超链接、网页内嵌、二维码、定制对接等方式让网上所有通道都可以快速通过本系统联系到商家。商家端支持 PC端、移动端（App）随时随地接收到用户的各种咨询，商家可以添加话术库、也可以对用户进行分组、加标签、加备注进行管理。

**让您快速拥有一套强大的私有高性能客服系统**

> 如果对您有帮助，您可以点右上角 "Star" 支持一下 谢谢！

## 技术栈

### 后端 (Rust)
- **核心框架**: Axum 0.7 + Tokio 1.38 (异步运行时)
- **数据库**: SeaORM 1.1 + SQLx 0.8 + MySQL 5.7+
- **缓存**: Redis 0.25 + Deadpool-Redis 0.14
- **WebSocket**: Axum WebSocket + DashMap 6.1
- **安全**: bcrypt + JWT + AES + SHA2
- **特性**: 异步IO | 零成本抽象 | 内存安全 | 跨平台

### 前端
- **框架**: Vue 2.x
- **UI组件**: Element UI
- **特性**: 前后端分离 | 响应式设计 | 实时通信

## 性能指标

- **并发连接**: 10000+
- **响应时间**: ~5ms
- **内存占用**: ~50MB
- **跨平台**: Linux/Windows/macOS

## 快速开始

### 环境要求

- Rust 1.70+
- MySQL 5.7+
- Redis 5.0+
- Node.js (前端开发)

### 后端安装

```bash
# 克隆项目
git clone https://github.com/your-repo/CRMChat.git
cd CRMChat/crmchat-rs

# 配置数据库
cp config/default.toml.example config/default.toml
# 编辑 config/default.toml 设置数据库连接

# 导入数据库
mysql -u root -p crmchat < database/schema.sql

# 运行项目
cargo run

# 生产编译
cargo build --release
./target/release/crmchat-rs
```

### 前端安装

```bash

cd template/admin
npm install
npm run dev

```

## 访问地址

- 后台管理: http://localhost:9000/admin

## 主要特性

### 高性能后端 (Rust)
- 基于 Tokio 异步运行时
- 支持 10000+ 并发 WebSocket 连接
- 平均响应时间 ~5ms
- 内存安全保障

### 前端特性
- Vue 2.x + Element UI
- 响应式设计，支持多终端
- 前后端完全分离
- 实时消息推送

### 核心功能
- **实时聊天**: WebSocket 长连接，实时双向通信
- **多端接入**: PC、移动端、小程序、H5
- **用户管理**: 分组、标签、备注、黑名单
- **话术库**: 快捷回复，提升客服效率
- **消息记录**: 完整的聊天记录保存
- **权限管理**: 多角色、细粒度权限控制

## 详细文档

更多详细文档请查看：
- [Rust 后端文档](crmchat-rs/README.md)
- [部署指南](crmchat-rs/README.md#部署指南)
- [API 文档](crmchat-rs/README.md#api文档)