智能客服项目介绍:SaaS客服系统、Agent与Python AI项目实战
01 智能客服项目介绍:SaaS客服系统、Agent与Python AI项目实战
一、项目概述
云梯智能客服是一套完整的多租户 SaaS 智能客服平台,面向企业提供从多渠道接入、机器人接待、人工坐席、知识库问答、工单流转、质检、客户经营到套餐计费的完整闭环。
系统采用微服务架构,Java 后端与 Python AI 服务分离,数据层使用 PostgreSQL + pgvector,并通过行级安全(RLS)实现租户级数据隔离。
1.1 项目定位
| 维度 | 说明 |
|---|---|
| 项目类型 | 多租户 SaaS 智能客服平台 |
| 架构模式 | 微服务架构(7 个 Java 服务 + 1 个 Python AI 服务) |
| 后端技术 | Java 25 + Spring Boot 4.0.3 + Spring Cloud 2025.1.2 + MyBatis-Plus 3.5.17 |
| 网关 | Spring Cloud Gateway(WebFlux) |
| 数据库 | PostgreSQL 17(6 个业务库,共 85 张表)+ pgvector(1024 维) |
| 多租户隔离 | 应用层 tenant_code 强制 + PostgreSQL 行级安全(RLS)兜底 |
| 实时通信 | WebSocket 长连接(独立实时网关 :9096) |
| AI 服务 | Python 3.12 + FastAPI + LangGraph + LlamaIndex |
| 大模型 | 通义千问 / DeepSeek(OpenAI 兼容)、qwen-vl(视觉) |
| 语音能力 | 阿里云智能语音交互 NLS(ASR / TTS) |
| 对象存储 | RustFS(S3 兼容) |
| 前端技术 | Vue 3.5 + TypeScript + Vite 5 + Element Plus + Pinia |
| 渠道接入 | 网站挂件、微信公众号、微信小程序、原生 App、400 热线、邮件工单 |
| 计费能力 | 四档套餐 + 用量计量 + 账期账单 + 收款流水 |
1.2 系统架构图

二、后端微服务架构
系统采用 Spring Cloud 微服务架构,共 8 个 Maven 模块(7 个可启动服务 + 1 个公共模块),另有 1 个独立的 Python AI 服务。
网关是 WebFlux 响应式网关,业务服务是 Spring MVC,AI 服务是 FastAPI。
2.1 模块清单
| 模块 | 服务名 | 端口 | 核心职责 |
|---|---|---|---|
| yunti-common | 公共模块 | - | 统一响应、异常、登录上下文、租户上下文、TraceId、审计旁路、雪花 ID |
| yunti-gateway | API 网关 | 9090 | 统一入口、路由转发、JWT 认证、CORS、租户限流、TraceId 透传 |
| yunti-user-service | 用户服务 | 9091 | 注册登录、账号、角色权限、成员邀请、双因素认证 |
| yunti-tenant-service | 租户服务 | 9092 | 企业资料、企业审核、租户开通、配额、租户冻结与升降级 |
| yunti-customer-service | 客服核心 | 9093 | 渠道、会话、消息、工单、客户 360、知识库、质检、快捷话术 |
| yunti-billing-service | 计费服务 | 9094 | 套餐、订单、用量计量、账期账单、收款流水、支付配置 |
| yunti-ops-service | 运营服务 | 9095 | 平台设置、官网配置、审计日志、安全中心、客户成功、可观测 |
| yunti-realtime-service | 实时网关 | 9096 | WebSocket 长连接、消息推送、在线状态、派单与质检预警 |
| yunti-ai(Python) | AI 服务 | 9100 | 客服大脑、RAG、知识库索引、AI 质检、视觉、语音、用量计量 |
| yunti-frontend | 管理后台 | 5173 | 企业管理端 + 平台运营端 |
| yunti-official | 官网 | 5180 | 零依赖静态官网(真实套餐价 + 官网配置 + 在线演示) |
| channel-demos | 渠道示例 | 各自端口 | 六条渠道的独立可运行接入示例 |
2.2 技术选型
| 技术栈 | 版本 | 用途 |
|---|---|---|
| Java | 25 | 后端编程语言 |
| Spring Boot | 4.0.3 | 应用框架 |
| Spring Cloud | 2025.1.2 | 微服务治理 |
| Spring Cloud Gateway | WebFlux | API 网关 |
| MyBatis-Plus | 3.5.17 | ORM 框架 |
| JWT | jjwt | 登录态与内部调用认证 |
| PostgreSQL | 17 | 主数据库 |
| pgvector | 1024 维 HNSW | 知识库向量检索 |
| WebSocket | 原生 + 自定义帧 | 实时消息与在线状态 |
| Python | 3.12 | AI 服务 |
| FastAPI / Uvicorn | - | AI HTTP 服务 |
| Pydantic | v2 | 请求校验与配置 |
| psycopg | 3 | AI 服务数据库访问 |
| LangGraph | 0.2+ | 客服大脑与 RAG 编排 |
| LlamaIndex | 0.11+ | 知识库解析、切块与向量化 |
| 通义千问 / DeepSeek | OpenAI 兼容 | 对话、意图、情绪、质检 |
| qwen-vl | - | 图片 OCR 与截图判读 |
| 阿里云 NLS | - | 语音识别 ASR / 语音合成 TTS |
| RustFS | S3 兼容 | 聊天图片与附件存储 |
| Vue / Vite | 3.5 / 5 | 管理后台 |
| Element Plus / Pinia | - | 组件库与状态管理 |
| Maven | 3.9+ | 后端构建 |
2.3 服务间调用关系

三、核心功能模块
3.1 全渠道统一接入
系统支持六条真实渠道,每条渠道都有自己的真实接入方式,而不是只做一个"渠道下拉框":
| 渠道 | 接入方式 | 出站能力 |
|---|---|---|
| 网站在线客服 | 一行 <script> 嵌挂件 | WebSocket 实时消息 |
| 微信公众号 | 服务器回调验签 + 网页授权 | 客服消息 / 模板消息 |
| 微信小程序 | 客服消息回调 | 客服消息 / 订阅消息 |
| 官方 App | 原生 SDK:REST 开会话 + WebSocket 收消息 | 长连接 + 离线推送 webhook |
| 400 热线 | 呼叫中心事件回调(呼入/按键/接听/录音/挂机) | IVR 语音播报 / 通话小结建单 |
| 邮件工单 | IMAP 收信 | SMTP 回执 / 回复 |
所有渠道共用同一条入站链路:
认渠道(验签)
→ 幂等去重(渠道 + 消息 ID 唯一索引)
→ 外部身份绑定平台客户(channel_identity)
→ 创建/复用会话
→ 落库并自动触发机器人新增一条渠道,主要工作是写它的回调解析与出站适配,公共链路不需要重写。
3.2 在线客服工作台与智能路由
工作台是三栏布局:左侧会话队列 / 我的会话,中间聊天区,右侧客户 360 与 AI 辅助。
核心能力:
- 会话队列、待接入、进行中、已结束;
- 坐席在线 / 忙碌 / 小休状态;
- 技能组路由、负载均衡、排队升级;
- 接起、转接、结束会话;
- 快捷话术(Alt+1~9);
- AI 知识推荐、AI 判读卡片;
- 客户 360 侧栏:画像、标签、历史会话、工单、满意度;
- 会话消息幂等、序号、断线补拉。
路由规则:
候选坐席 = 技能组内成员
AND 状态 = 在线
AND 长连接在线
AND 已接待数 < 并发上限
→ 负载最低
→ 同负载时优先更久没换状态的坐席
→ 无人可派则排队,超时升级3.3 实时消息链路
实时能力由独立的实时网关(:9096)承载,访客端、坐席端、管理端共用一套长连接协议。
| 能力 | 实现 |
|---|---|
| 消息幂等 | client_msg_no + (tenant_code, session_id, client_msg_no) 唯一索引 |
| 会话内顺序 | 服务端分配单调递增 seq |
| 消息可达 | 发件箱 + ACK,发送失败重试 |
| 断线续传 | 重连时带 lastSeq,只补拉缺失消息 |
| 在线状态 | 长连接 + HTTP 在线状态对账 |
| 消息类型 | 文本 / 图片 / 卡片 / 事件 / 系统 |
| 可见范围 | 客户与坐席可见 / 仅坐席内部备注 |
3.4 AI 客服大脑
AI 客服大脑是一条用 LangGraph 编排的可控状态机:

关键设计:
- 意图识别支持规则、训练版本向量、模型三种来源;
- 模型返回的意图必须落在租户配置的意图清单里,否则归为"其他";
- 情绪识别取规则与模型更严重的一档;
- 多轮状态记录轮次、连续未解决、槽位、上次意图/情绪;
- 自动转人工按优先级判断:
- 客户明确要求;
- 命中"直接转人工"意图(规则命中直接转,模型判出需有人工信号);
- 模型建议转人工(需有可核对的话面依据);
- 情绪达到愤怒阈值;
- 连续未解决 / 知识不足。
3.5 知识库与 Agentic RAG
知识库支持分类、草稿/审核/发布/下线、文档切片、向量索引与命中统计。
RAG 链路:

关键设计:
- 向量阈值与关键词阈值分开配置(两种分数不在同一量纲);
- 最多改写一次,防止死循环;
- 回答强制标注
[1][2]; - 越界引用编号会被剔除;
- 检索不到时明确说明,不硬编。
3.6 工单与 SLA
工单支持从会话一键创建,自动带来源会话、客户和最近对话摘要。
| 能力 | 说明 |
|---|---|
| 两段 SLA | 首次响应 / 解决,按优先级四档配置 |
| 建单快照 | 建单时固定截止时间,后续调整优先级不重算 |
| 定时扫描 | 每 30 秒检查,正常 → 即将超时 → 已超时 |
| 状态流转 | 待处理 / 处理中 / 待客户确认 / 已解决 / 已关闭 / 重开 |
| 协作动作 | 认领、转派、回复、升级、催办 |
| 平台支持工单 | 平台侧跨租户处理企业提交的支持工单 |
| 结单回访 | 已解决后自动发回访邮件,客户评分回写满意度 |
3.7 客户 360
客户 360 把客户画像、标签、会话轨迹、工单、订单和满意度集中到一个视图。
核心能力:
- 客户等级、类型、风险、最近意图/情绪、满意度;
- 标签体系:分组、颜色、手工/规则、启停;
- 标签自动化引擎:指标 + 比较符 + 阈值 + 统计窗口;
- 四种触发:会话结束、建单、定时、手动重算;
- 会话轨迹与聊天记录回看;
- 合并、匿名化、删除、批量打标、CSV 导入;
- 手机号字段级权限,查看写审计。
3.8 质检中心
质检分两条链路:
| 链路 | 能力 |
|---|---|
| 实时质检 | 会话中边聊边检,风险话术 / 响应超时秒级预警 |
| 全量质检 | 规则命中 + AI 判分双通道,产出评分、命中规则、评语 |
| 人工复核 | 通过 / 驳回,留复核意见 |
| 质检规则 | 规则类型、权重、关键词、严重级别、是否实时、超时阈值 |
AI 不可用时自动退回规则质检,流程不中断。
3.9 计费与账单
计费分"预付费套餐"和"后付费用量"两条线:
| 模块 | 说明 |
|---|---|
| 套餐 | 免费 / 标准 / 专业 / 企业四档,配额 + 价格的唯一来源 |
| 订单 | 下单、支付、套餐生效、我的订单 |
| 用量计量 | 会话、消息、AI 调用、席位、存储五类 |
| 账期账单 | 套餐费 + 超量费,重算幂等,已结算不可改 |
| 收款流水 | 订单支付 / 账期确认收款各一条,业务号唯一防重复 |
| 支付配置 | 支付宝 / 微信 / 对公转账,平台可关闭在线支付 |
3.10 平台运营与安全
平台侧覆盖:
- 企业审核、租户管理、租户冻结与升级;
- 平台用户、角色权限、菜单权限;
- 平台设置(注册、审核、套餐价格、支付、公告);
- 官网配置(草稿 / 预览 / 发布);
- 平台数据(租户增长、套餐分布、收入、用量 Top);
- AI 监控(调用量、Token 成本、质量安全、租户配额);
- 客户成功(健康度、续费风险、扩展商机、回访任务);
- 可观测(告警规则、告警事件、成本预算、调用链);
- 安全中心(双因素、IP 白名单、导出审批、水印、空闲登出、API 密钥);
- 审计日志(只追加、旁路写、操作人姓名快照)。
3.11 客户成功与数据大屏
客户成功模块把"续费"从事后动作变成可提前干预的过程:
| 能力 | 说明 |
|---|---|
| 租户健康度 | 用量 35% + 活跃 25% + 到期 20% + 趋势 20% |
| 续费风险 | 已过期 / 一周内到期 / 快到期且不健康等规则 |
| 扩展商机 | 免费版有真实用量、配额使用 ≥ 70% 等 |
| 回访任务 | 建 / 改 / 完成 / 取消,完成写结论并回写随访表 |
数据大屏提供会话趋势、渠道分布、坐席绩效、满意度、实时事件流等指标。
四、数据库设计
4.1 数据库分布
系统按服务边界拆成 6 个 PostgreSQL 库,共 85 张表:
| 数据库 | 所属服务 | 表数 | 核心表 |
|---|---|---|---|
| user_db | 用户服务 | 8 | sys_user、sys_role、sys_permission、sys_role_permission、sys_user_role、tenant_member、member_invite、login_log |
| tenant_db | 租户服务 | 7 | enterprise、enterprise_review、tenant、tenant_quota、tenant_usage_daily、tenant_schema_upgrade、tenant_security_event |
| customer_db | 客服核心 | 43 | channel、channel_key、session、session_message、customer、ticket、kb_document、kb_chunk、qa_rule、qa_task、agent_status、skill_group 等 |
| billing_db | 计费服务 | 7 | plan、billing_order、billing_statement、billing_usage_daily、payment_record、payment_config、invoice_record |
| ops_db | 运营服务 | 12 | audit_log、security_policy、api_key、data_export、register_config、site_config、announcement、customer_success、observability_alert_rule 等 |
| ai_db | AI 服务 | 8 | bot_setting、bot_intent、bot_dialogue、bot_model、bot_version、training_job、bot_intent_sample、ai_usage_record |
4.2 多租户隔离:应用层 + RLS 双防线
第一道在应用层:网关解析登录态,租户上下文全链路透传,各服务 SQL 强制带 tenant_code。
第二道在数据库层:
-- customer_db:所有带 tenant_code 的表
ALTER TABLE public.<table> ENABLE ROW LEVEL SECURITY;
ALTER TABLE public.<table> FORCE ROW LEVEL SECURITY;
CREATE POLICY <table>_tenant_isolation ON public.<table>
USING (
NULLIF(current_setting('app.tenant_code', true), '') IS NULL
OR NULLIF(current_setting('app.tenant_code', true), '') = 'PLATFORM'
OR tenant_code = NULLIF(current_setting('app.tenant_code', true), '')
);customer_db43 张表中 42 张带tenant_code,全部开启并 FORCE RLS;- 平台运维走
PLATFORM上下文放行; - 跨租户越权有专门测试用例;
- 大客户可升级为独立库,脚本清单版本化、控制面下发、双边留痕。
4.3 设计原则
- 主键统一雪花 ID(BIGINT),由应用层生成;
- 逻辑删除统一
is_deleted; - 禁止跨库外键,关联在应用层做;
- 金额用 NUMERIC,枚举用 SMALLINT + CHECK;
- 多租户表必须有
tenant_code与复合索引; - 状态/类型字段必须有码值注释与 CHECK 约束;
- 表结构变更走基线 + 增量脚本,幂等可重复执行。
五、前端架构
5.1 技术栈
| 技术 | 用途 |
|---|---|
| Vue 3.5 | 前端框架 |
| TypeScript | 类型系统 |
| Vite 5 | 构建与开发服务器 |
| Element Plus | UI 组件库 |
| Pinia | 状态管理 |
| Vue Router | 路由与权限 |
| Axios | HTTP 请求与拦截器 |
5.2 页面结构
企业运营端
| 页面 | 说明 |
|---|---|
| 数据概览 / 实时大屏 | 经营指标、会话趋势、渠道分布、坐席绩效 |
| 在线客服工作台 | 三栏工作台、会话队列、路由、转接、快捷话术、客户 360 |
| 智能机器人 | 意图、话术、模型参数、多轮流程、未覆盖问题 |
| 训练中心 | 全量/增量训练、版本、灰度、回滚 |
| 知识库 | 分类、文档、状态流转、切片、检索测试 |
| 工单中心 | 看板、SLA、转派、回访 |
| 客户 360 | 画像、标签、会话轨迹、合并/匿名化 |
| 质检中心 | 规则、任务、复核、实时预警 |
| 渠道接入 | 六条渠道配置、回调地址、连接测试、演示中心 |
| 团队与设置 | 成员、角色、技能组、消息中心 |
平台运营端
| 页面 | 说明 |
|---|---|
| 企业审核 / 租户管理 | 企业资料审核、租户冻结、独立库升级 |
| 平台用户 / 角色权限 | 平台账号与菜单权限 |
| 计费与账单 / 收款流水 | 套餐、订单、账期账单、收款对账 |
| 平台数据 | 租户增长、套餐分布、收入、用量 |
| AI 监控 | 调用量、Token 成本、质量安全、租户配额 |
| 客户成功 | 健康度、续费风险、扩展商机、回访任务 |
| 安全中心 | 安全策略、API 密钥、安全事件、导出审批 |
| 审计日志 | 全平台操作留痕、筛选、导出 |
| 官网配置 | 9 个区块可视化编辑、预览、发布 |
| 可观测 | 告警、成本预算、调用链 |
客户侧
- 访客端(
/visitor):机器人接待、知识引用、转人工、满意度; - 渠道演示中心(
/channel-demos):六条渠道客户侧真实体验; - 官网(
yunti-official):产品介绍、真实套餐价、在线演示。
5.3 前端分层
views/ 页面
api/ 接口封装
stores/ Pinia 状态
router/ 路由与权限守卫
components/ 通用组件
assets/ 样式与设计令牌开发代理:
/api/**→ 网关:9090/ws/**→ 实时网关:9096- 生产环境由网关统一转发。
六、API 全景
6.1 网关路由
| 路径前缀 | 目标服务 | 说明 |
|---|---|---|
/api/user/** | :9091 | 登录、注册、账号、角色、成员 |
/api/tenant/** | :9092 | 企业、租户、审核、配额 |
/api/customer/** | :9093 | 会话、工单、客户、知识库、质检 |
/api/platform/** | :9093 | 平台支持工单 |
/api/open/** | :9093 | 开放 API(X-Api-Key) |
/api/billing/** | :9094 | 套餐、订单、账单、收款 |
/api/ops/** | :9095 | 平台设置、审计、安全、客户成功、可观测 |
/api/ai/** | :9100 | AI 对话、RAG、知识库、质检、视觉、语音 |
/api/realtime/** | :9096 | 在线状态与内部推送 |
ws://host:9096/ws/realtime | :9096 | 实时消息长连接 |
6.2 AI 服务接口
| 接口 | 说明 |
|---|---|
POST /api/ai/v1/agent/chat | 机器人对话 |
POST /api/ai/v1/agent/brain | 客服大脑(意图/情绪/转人工) |
POST /api/ai/v1/kb/index | 文档解析与索引 |
POST /api/ai/v1/kb/index-text | 文本切块与索引 |
POST /api/ai/v1/kb/search | 知识检索 |
POST /api/ai/v1/rag/ask | RAG 问答 |
POST /api/ai/v1/qa/evaluate | AI 质检 |
POST /api/ai/v1/agent/vision | 图片理解(OCR / 截图判读) |
/api/ai/v1/speech/* | 语音识别/合成 |
/api/ai/v1/bot/* | 机器人配置、意图、模型、对话状态 |
/api/ai/v1/bot/training/* | 训练任务、版本、灰度、回滚 |
/api/ai/health | 健康检查 |
6.3 统一响应格式
{
"code": 0,
"message": "成功",
"data": {},
"timestamp": 1792058839321
}code=0成功;非 0 为业务错误;- 401:未登录;
- 40302:平台接口被企业账号访问;
- 网关与各服务统一返回该结构。
七、项目亮点
7.1 多租户架构亮点
① 应用层 + 数据库层双防线
不是只在代码里写 WHERE tenant_code = ?,而是在 42 张租户表上 ENABLE + FORCE ROW LEVEL SECURITY,即使某条 SQL 漏写条件,数据库也不会把别家的行交出来。
② 独立库升级能力
对大客户支持独立库:脚本清单版本化、控制面下发、数据面执行、双边留痕;平台侧可发起升级并查看结果。
③ 租户级限流
网关按租户做令牌桶 QPS + 日额度,单租户突发流量不会拖垮其他租户。
7.2 全渠道接入亮点
- 六条渠道真实对接,不是只做配置页;
- 统一入站链路:验签 → 幂等 → 身份绑定 → 开会话 → 机器人;
- 出站按渠道分流:客服消息 / 模板消息 / 订阅消息 / 长连接 / 语音 / SMTP;
- 六个独立示例项目可直接拷走对接。
7.3 实时消息亮点
client_msg_no幂等,重试不重复;- 会话内
seq序号,顺序一致; - 发件箱 + ACK + 断线增量补拉;
- 长连接与 HTTP 在线状态对账;
- 独立实时网关,资源隔离、可单独扩容。
7.4 AI Agent / RAG 亮点
- 两套 LangGraph 状态机:客服大脑 + RAG;
- 意图识别结果收敛到租户配置清单;
- 情绪识别取更严重档;
- 五类自动转人工触发,每次带可解释原因;
- pgvector 1024 维 HNSW 余弦检索;
- 召回判分 + 规则改写重检 + 引用校验;
- 无模型密钥 / 无向量时自动降级。
7.5 质检与工单亮点
- 实时质检边聊边检,风险话术秒级预警;
- 全量质检规则 + AI 判分双通道;
- 工单两段 SLA、建单快照、30 秒扫描;
- 会话转工单自动带上下文;
- 结单回访与满意度回写。
7.6 计费与成本治理亮点
- 四档套餐 + 五类用量计量;
- 账期账单 = 套餐费 + 超量费;
- 收款流水业务号唯一,防重复入账;
- AI 每次调用记录 token 与成本;
- 租户配额 80% 预警、超限标红;
- 平台可配置告警与成本预算。
7.7 安全与合规亮点
- 双因素认证(邮箱验证码 + 覆盖范围可配);
- 登录失败锁定、IP 白名单、空闲登出、水印;
- 数据导出审批,审批通过可从消息直接下载;
- API 密钥只存 SHA-256,明文只回显一次;
- 审计日志只追加、旁路写、姓名快照;
- 手机号字段级权限,查看写审计;
- 客户合并 / 匿名化 / 删除。
7.8 工程化与自检亮点
- 6 个库 85 张表,基线 + 增量脚本;
- 一键初始化脚本(建库 + 结构 + 初始数据);
- 数据库脚本与运行期副本一致性检查;
- 渠道、消息、路由、质检、工单、客户 360、计费、安全、可观测均有自检脚本;
- 渠道示例自带
selfcheck.js; - 本地运行指南与数据初始化教程齐全。
7.9 亮点汇总速览
| 维度 | 一句话 |
|---|---|
| 多租户 | 应用层 + RLS 双防线,42 张表 FORCE RLS |
| 全渠道 | 六条渠道真实接入,统一入站分流出站 |
| 实时 | 幂等 + 序号 + 补拉 + ACK |
| AI | 双 LangGraph + 意图/情绪/转人工 |
| RAG | pgvector 1024 HNSW + 引用溯源 |
| 质检 | 实时 + 全量,规则 + AI |
| 工单 | 两段 SLA + 建单快照 |
| 计费 | 套餐 + 用量 + 账期账单 + 收款流水 |
| 安全 | 双因素 + 审计 + 导出审批 + API 密钥 |
| 运维 | TraceId 全链路 + 告警 + 成本预算 |
系统截图
八、快速启动
8.1 环境要求
| 依赖 | 版本 |
|---|---|
| JDK | 25 |
| Maven | 3.9+ |
| Node.js | 18+(推荐 20 LTS) |
| Python | 3.11+(推荐 3.12) |
| PostgreSQL | 17 + pgvector |
| RustFS | S3 兼容(可选,图片/附件需要) |
8.2 启动步骤
# 1. 初始化 6 个数据库(建库 + 结构 + 初始数据)
PGPASSWORD=123456 psql -h 127.0.0.1 -p 5432 -U mac -d postgres \
-f yunti-backend/deploy/db-init/db-init.sql
# 2. 构建后端
cd yunti-backend
mvn -q clean package -DskipTests
# 3. 启动 7 个 Java 服务
java -jar yunti-user-service/target/yunti-user-service-1.0.0-SNAPSHOT.jar
java -jar yunti-tenant-service/target/yunti-tenant-service-1.0.0-SNAPSHOT.jar
java -jar yunti-customer-service/target/yunti-customer-service-1.0.0-SNAPSHOT.jar
java -jar yunti-billing-service/target/yunti-billing-service-1.0.0-SNAPSHOT.jar
java -jar yunti-ops-service/target/yunti-ops-service-1.0.0-SNAPSHOT.jar
java -jar yunti-realtime-service/target/yunti-realtime-service-1.0.0-SNAPSHOT.jar
java -jar yunti-gateway/target/yunti-gateway-1.0.0-SNAPSHOT.jar
# 4. 启动 AI 服务
cd yunti-ai
bash scripts/bootstrap.sh
./start.sh
# 5. 启动前端
cd yunti-frontend
npm install
npm run dev访问:
- 管理后台:http://localhost:5173
- 官网:http://localhost:5180(
yunti-official/serve.sh) - AI 健康检查:http://localhost:9100/api/ai/health
8.3 默认账户
| 角色 | 账号 | 密码 |
|---|---|---|
| 平台管理员 | admin@yunti.example.com | Admin@123456 |
| 企业管理员 | 13800001234 | demo123456 |
| 客服主管 | 13900000001 | Yunti@123456 |
| 高级客服 | 13900000002 | Yunti@123456 |
账号由 scripts/seed-test-accounts.py 幂等初始化。
这套源码能带给你什么?
如果你是 Java 后端工程师:
- 7 个可独立启动的 Spring Cloud 服务怎么按业务边界拆分,网关、业务服务与实时服务如何解耦;
- Spring Cloud Gateway(WebFlux)与 Spring MVC 业务服务如何在同一个项目中协作;
- JWT 鉴权、登录上下文、租户上下文、TraceId 如何从网关一路透传到业务服务和数据库;
- MyBatis-Plus 在 6 个 PostgreSQL 业务库、85 张表中的实际用法,以及雪花 ID、逻辑删除、复合索引和增量脚本的设计方式;
- 应用层
tenant_code校验与 PostgreSQL RLS 如何组成双防线,避免一条 SQL 漏写条件就造成跨租户越权; - WebSocket 长连接如何实现消息幂等、会话内
seq顺序、发件箱、ACK、断线补拉和在线状态对账; - Java 业务服务如何通过清晰的 HTTP 契约调用 Python AI 服务,把 AI 能力接入而不侵入核心业务流程;
- 租户限流、双因素认证、审计日志、导出审批、API 密钥和字段级权限如何落到真实代码与数据表中。
如果你是前端工程师:
- Vue 3.5 + TypeScript + Vite + Element Plus + Pinia 如何组织一个企业级多页面管理后台;
- 企业运营端与平台运营端如何共用一套工程结构,同时保持菜单、页面和权限边界清晰;
- Vue Router 权限守卫、Axios 请求拦截器、接口封装和 Pinia 状态管理如何协同工作;
- 三栏在线客服工作台怎么做,包括会话队列、实时聊天、客户 360、AI 辅助和快捷话术;
- WebSocket 消息如何与普通 HTTP 请求共存,并处理重连、补拉、消息去重和在线状态;
- 数据概览、知识库、工单看板、质检中心、计费账单、系统设置等复杂页面如何拆分组件与业务状态;
- 前台访客端、渠道演示中心和官网如何与后台复用接口,同时针对不同终端做交互取舍。
如果你关注 AI / LLM:
- FastAPI + Pydantic + LangGraph + LlamaIndex 如何构建一个独立的 AI 服务;
- 客服大脑如何用 LangGraph 编排意图识别、情绪判断、知识召回、回答生成和转人工;
- Agentic RAG 如何实现 pgvector 向量检索、召回归一化评分、问题改写、二次检索和引用校验;
- 知识库从文档上传、解析、切片、向量化、发布到命中统计的完整链路如何落地;
- AI 质检、图片 OCR、截图理解、语音识别和语音合成如何作为独立能力接入客服系统;
- 如何设计 token 计量、调用成本、租户配额、预算告警和多级降级,避免 AI 能力失控;
- 无模型密钥、模型超时或向量不可用时,业务如何自动降级而不是整体中断。
如果你是架构师或技术负责人:
- 一个多租户 SaaS 系统如何划分用户、租户、客服核心、计费、运营和实时通信等业务域;
- 为什么实时网关、AI 服务和普通业务服务要独立部署,以及各自如何单独扩容;
- 6 个业务库如何按服务边界拆分,如何避免跨库外键,并处理跨服务数据一致性;
- 大客户独立库升级、数据库脚本版本化、控制面下发和双边留痕如何设计;
- 渠道接入、消息必达、智能路由、工单 SLA、计费账单和审计体系如何组成完整业务闭环;
- TraceId、结构化日志、告警、成本预算和自检脚本如何支撑生产环境排障;
- 一个项目从需求、数据库、后端、前端、AI 到部署文档,如何保持完整的工程交付链路。
无论你主要做 Java 后端、前端、AI 应用还是 SaaS 架构,都可以沿着一条真实业务流程,从页面一路读到接口、服务、数据库和部署脚本。