v0.1 模块化架构

开源智能
客服与工单系统

模块化单体架构,支持 AI 智能问答、多渠道接入、实时会话与语音能力。企业级可观测性,灵活演进,易于扩展。

Go 1.23 Gin WebSocket OTel OpenAI
Servify Illustration
8+
业务模块
AI
智能问答
WS
实时通信
100%
开源免费

适用于多种业务场景

灵活的模块化设计,满足不同规模企业的客服需求

电商客服

订单咨询、售后处理、智能推荐,7×24小时在线服务。

SaaS 企业

工单流转、客户分层、SLA 管理,提升客户满意度。

在线教育

学员答疑、课程咨询、实时互动,降低运营成本。

系统集成

开放 API,轻松集成到现有系统,支持私有化部署。

为什么选择 Servify

模块化架构设计,每个业务能力独立演进,支持从单体到微服务的平滑过渡

工单系统

完整的工单生命周期管理,支持自定义字段、状态流转、SLA 策略与事务边界。

实时会话

WebSocket 长连接支持,消息持久化,最近会话历史快速读取。

智能路由

人工接管、排队管理、技能组匹配、会话转接,灵活的分配策略。

AI 集成

统一 LLM Provider 抽象,支持 OpenAI、Claude 等多模型切换。

知识库管理

企业知识库集成,支持文档管理、索引任务与多 Provider 适配。

可观测性

OpenTelemetry 追踪,Prometheus 指标,结构化日志,完整的运营诊断能力。

5 分钟部署完成

最小化依赖,开箱即用

Terminal
# 1. 克隆仓库
git clone https://github.com/Toconvo/servify.git
cd servify

# 2. 启动服务(依赖 Docker)
docker-compose up -d

# 3. 访问控制台
open http://localhost:8080

# 4. 配置 AI(可选)
export OPENAI_API_KEY=your_key_here
1

克隆代码

从 GitHub 获取最新代码

2

启动服务

使用 Docker Compose 一键启动

3

开始使用

访问控制台,体验完整功能

模块化单体架构

清晰的业务边界,平台能力独立抽象,支持渐进式演进

flowchart TB subgraph SDK["SDK & Channels"] WEB["Web SDK
Vanilla/React/Vue"] API["Future API/App SDK"] CH["Channel Adapters
微信/Telegram"] end subgraph DL["Delivery Layer"] GIN["Gin Router
HTTP/WebSocket"] end subgraph BM["Business Modules"] TICKET["ticket
工单系统"] CONV["conversation
实时会话"] ROUTE["routing
智能路由"] AGENT["agent
客服管理"] CUST["customer
客户管理"] AI["ai
AI编排"] KNOW["knowledge
知识库"] VOICE["voice
语音能力"] AUTO["automation
自动化"] end subgraph PL["Platform Layer"] BUS["Event Bus"] AUTH["Auth"] CFG["Config"] TRC["Tracing"] end subgraph PV["Providers"] LLM["LLM Provider
OpenAI/Claude"] KP["Knowledge Provider
WeKnora/向量库"] SIP["SIP/WebRTC
Adapter"] end WEB --> GIN API --> GIN CH --> GIN GIN --> TICKET GIN --> CONV GIN --> ROUTE GIN --> AGENT GIN --> CUST CONV --> AI AI --> LLM AI --> KP ROUTE --> AGENT TICKET --> BUS CONV --> BUS ROUTE --> BUS BUS --> AUTO classDef sdkStyle fill:#4f46e5,stroke:#4338ca,color:#fff classDef dlStyle fill:#6366f1,stroke:#4f46e5,color:#fff classDef bmStyle fill:#0ea5e9,stroke:#0284c7,color:#fff classDef plStyle fill:#f59e0b,stroke:#d97706,color:#fff classDef pvStyle fill:#64748b,stroke:#475569,color:#fff class WEB,API,CH sdkStyle class GIN dlStyle class TICKET,CONV,ROUTE,AGENT,CUST,AI,KNOW,VOICE,AUTO bmStyle class BUS,AUTH,CFG,TRC plStyle class LLM,KP,SIP pvStyle

模块化演进路线

清晰的模块边界,渐进式迁移,支持从单体到微服务的平滑演进

第一阶段 - 核心业务模块

已完成

ticket

v0.1

工单生命周期管理、状态流转、SLA 策略、事务边界

conversation

v0.1

WebSocket 长连接、消息持久化、会话历史

routing

v0.1

人工接管、排队管理、技能组匹配、会话转接

ai

v0.1

Query Orchestrator、LLM Provider、Prompt Builder

knowledge

v0.1

文档管理、索引任务、Knowledge Provider 抽象

第二阶段 - 扩展业务模块

进行中

agent

开发中

客服档案、在线状态、并发负载管理

customer

待开始

客户档案、标签、备注、活动轨迹

automation

待开始

基于事件总线的自动化执行引擎

第三阶段 - 增强能力

规划中

analytics

待开始

统计读模型、增量聚合、数据看板

voice

待开始

呼叫会话、媒体会话、录音转写、SIP 适配

智能问答引擎

统一 LLM Provider 抽象,支持多模型切换与知识库检索

  • Query Orchestrator 统一编排层
  • Prompt Builder 与 Guardrails
  • Knowledge Provider 检索集成
  • 降级与熔断保护机制
  • 支持 OpenAI、Claude、DeepSeek
AI Architecture

WebSocket & WebRTC

浏览器原生支持,低延迟 P2P 传输

  • WebSocket 长连接,消息实时推送
  • WebRTC 屏幕共享与远程协助
  • 端到端监控与事件上报
  • SIP 协议适配器(语音能力)
Realtime Communication

多端 SDK 支持

统一的核心合约,跨端 Transport 实现

Web SDK

Vanilla JS、React、Vue 三种绑定,开箱即用。

Transport

WebSocket、HTTP 双 Transport,自动重连与降级。

Core Contract

跨端统一接口,消息类型、事件模型一致。

云原生技术架构

采用成熟稳定的技术栈,确保系统可靠性与可维护性

后端框架

Go 1.23 Gin GORM

实时通信

WebSocket WebRTC SIP

AI 能力

OpenAI Claude DeepSeek

可观测性

OpenTelemetry Prometheus Grafana

数据存储

PostgreSQL Redis S3

部署运维

Docker Kubernetes Helm

开始使用 Servify

开源免费,自托管部署,数据完全掌控