12 个实施 backlog 全部完成

开源智能
客服与工单系统

Servify 已完成全部核心模块化拆分与管理面安全基线,落地 AI/知识库基础抽象、tenant/workspace scope、RBAC、审计与令牌状态管理,并建立完整的可观测性体系(Prometheus 指标、错误分类、事件总线观测与 Grafana 面板)。

Go 1.25 Gin WebSocket OTel OpenAI
Servify Illustration
10
已收口业务模块
RBAC
管理面权限控制
Prometheus
指标采集与告警
Grafana
运营面板与排障

适用于多种业务场景

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

电商客服

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

SaaS 企业

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

在线教育

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

系统集成

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

为什么选择 Servify

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

工单系统

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

实时会话

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

智能路由

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

AI 集成

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

知识库管理

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

可观测性

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

管理面安全基线

管理类接口统一叠加 scope、RBAC、审计与 token state policy,并提供通用 user security 管理入口。

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
自动化"] ANALYTICS["analytics
统计分析"] 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 BUS --> ANALYTICS 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,ANALYTICS 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

v0.1

客服档案、认证接入、统一 user security 与令牌失效控制

customer

v0.1

客户档案、标签备注、管理面边界迁移与受保护查询入口

第二阶段 - 扩展业务模块

已完成

automation

v0.1

基于事件总线的自动化执行引擎与规则编排能力

analytics

v0.1

统计读模型、增量聚合、运营指标与数据看板

voice

v0.1

呼叫会话、媒体事件、录音转写与 SIP / WebRTC 适配

第三阶段 - 管理面安全基线

已完成

security baseline

v0.1

tenant/workspace scope、RBAC、audit、token state policy 与统一 user security surface

第四阶段 - 可观测性体系

已完成

telemetry

v0.1

统一指标/追踪/日志命名规范、上下文传播、RequestID 中间件

metrics

v0.1

Prometheus Registry、HTTP 指标中间件、业务指标(会话/工单/路由/AI)

error taxonomy

v0.1

4 级严重度 × 8 类别错误分类、自动映射、错误计数与用户安全消息

async observability

v0.1

事件总线装饰器、Worker 追踪、死信记录、Replay 接口预留

dashboards & alerts

v0.1

Grafana Dashboard JSON、Prometheus 告警规则、运维排障手册

智能问答引擎

统一 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.25 Gin GORM

实时通信

WebSocket WebRTC SIP

AI 能力

OpenAI Claude DeepSeek

可观测性

OpenTelemetry Prometheus Grafana

数据存储

PostgreSQL Redis S3

部署运维

Docker Kubernetes Helm

开始使用 Servify

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