# Customer-Service-System-Back **Repository Path**: wyshp08/Back ## Basic Information - **Project Name**: Customer-Service-System-Back - **Description**: 一套微服务在线客服系统：访客在商城页通过悬浮气泡咨询，客服在管理后台工作台实时接待（WebSocket 长连接），同时保留商城/后台本身的业务能力。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-11-05 - **Last Updated**: 2026-11-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 一套微服务在线客服系统：访客在商城页通过悬浮气泡咨询，客服在管理后台工作台实时接待（WebSocket 长连接），同时保留商城/后台本身的业务能力。 架构示意图 浏览器 ┌──────────────────────┐ ┌──────────────────────────┐ │ 商城 customer-system │ │ 后台 admin-system │ │ Naive UI :3001 │ │ Element Plus :3000 │ │ 访客悬浮聊天窗 │ │ 客服工作台(SSO 免二次登录) │ └──────────┬───────────┘ └────────────┬─────────────┘ │ HTTP /api WS /ws │ HTTP /ocs-api WS /ocs-ws ▼ ▼ ┌─────────────────────────┐ │ Spring Cloud Gateway:9000│ 统一入口/路由/静态文件 └────────────┬─────────────┘ ┌───────────────────┼───────────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌─────────────────┐ ┌──────────────────────┐ │ admin-service │ │customer-service │ │ online-service │ │ :8080 │ │ :8081 │ │ :8082 HTTP + :9001 WS │ │ 用户/角色/权限 │ │ 客户/商品/购物车 │ │ 会话/消息/坐席/分配 │ │ admin_system 库│ │ customer_service│ │ online_customer_service│ └────────────────┘ └────────┬────────┘ └───────────┬──────────┘ │ Feign │ └───────────────────────┘ SSO 身份核实 ┌─────────────┬──────────────┬───────────────┐ ▼ ▼ ▼ MySQL 5.7 Redis Nacos 3 (三库独立) (token/在线状态/ (注册发现/配置) 路由/限流) 技术栈 ┌───────────┬───────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ 层 │ 技术 │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 语言/框架 │ Java 21、Spring Boot 3.5、Spring Cloud Alibaba 2025 │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 微服务 │ Spring Cloud Gateway（WebFlux 反应式）、OpenFeign、Nacos（注册+配置） │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 实时通信 │ Netty 手写 WebSocket 服务（9001），30s 心跳、指数退避重连、SYSTEM 事件帧封装；消息发送 HTTP/WS 双通道 │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 持久层 │ MyBatis-Plus 3.5（Lambda 语法为主）、MySQL 5.7（每服务独立库） │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 缓存 │ Redis：客服 token（8h 滑动续期+顶号）、在线状态、技能组路由、限流、策略应急覆盖 │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 后台前端 │ Vue 3.5 + TS + Vite + Element Plus + Pinia，token 存 localStorage，路由表按权限码动态注册 │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 商城前端 │ Vue 3.5 + TS + Vite + Naive UI + Pinia，客户 token 走 httpOnly cookie（不落 localStorage） │ ├───────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 工程规范 │ Lombok、SLF4J + @Slf4j、构造器注入、统一 Result / BusinessException、DTO/VO/DO 分层 │ └───────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────┘ 几个关键设计 - 三库隔离 + 最小耦合：权限点 ocsWorkbench:* 在 admin 库（决定"谁能进工作台"），坐席/会话在 online 库（决定"怎么接待"）；admin 登录后用 adminToken 调 online SSO 换客服 token，online 再反向 Feign 核实 - 会话分配可热切换：轮询 / 最少接待（默认）/ 技能组优先 / 指定客服，支持 Redis 应急覆盖，无需重启 - 访客身份兜底：已登录商城客户打开气泡时，后端从 customer_token cookie 自动识别身份，JS 读不到 token - 消息可靠性：clientMsgId 唯一索引做发送幂等（防重复消息）、乐观消息气泡 + 失败重发、游标分页拉历史、已读回执 整体就是一个典型的「网关 + 三业务服务 + Netty 长连接 + 双前端嵌入」Spring Cloud 教学/演示架构。 ● 基础设施中间件（本地实际运行版本，已实测确认） ┌────────┬────────────────────────┬──────┬─────────────────────────────────────────────────────────────────────────────────┐ │ 中间件 │ 版本 │ 端口 │ 在本项目的用途 │ ├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤ │ MySQL │ 5.7.43 │ 3306 │ 三个服务各独立一库（admin_system / customer_service / online_customer_service） │ ├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤ │ Redis │ 5.0.14.1（Windows 版） │ 6379 │ 客服/客户 token、坐席在线状态、技能组路由、限流、分配策略应急覆盖 │ ├────────┼────────────────────────┼──────┼─────────────────────────────────────────────────────────────────────────────────┤ │ Nacos │ 3.0.3 │ 8848 │ 服务注册发现 + 配置中心 │ └────────┴────────────────────────┴──────┴─────────────────────────────────────────────────────────────────────────────────┘ ▎ 注意：MySQL 是 5.7 而非计划文档里写的 8.0，所以写 SQL 时要兼容 5.7（如没有窗口函数、注意 ONLY_FULL_GROUP_BY）。 与之配套的框架/组件版本（Maven，pom 实际声明） ┌──────────────────────┬─────────────────────────────┬──────────────────────────────────────────────────────┐ │ 组件 │ 版本 │ 说明 │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ JDK │ 21 │ │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Spring Boot │ 3.5.x │ 父 POM 管理 │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Spring Cloud │ 2025.0.3 │ Gateway + OpenFeign │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Spring Cloud Alibaba │ 2025.0.0.0 │ Nacos 注册/配置（Nacos Client 3.0.3） │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ MyBatis-Plus │ 3.5.9 │ ORM（mybatis-plus-spring-boot3-starter） │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Netty │ 随 Spring Boot BOM（4.2.x） │ 9001 端口手写 WebSocket 服务 │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Hutool │ 5.8.32 │ 工具库 │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ Lombok │ 1.18.30 │ │ ├──────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────┤ │ 构建 │ Maven │ 多模块：common / gateway / admin / customer / online │ └──────────────────────┴─────────────────────────────┴──────────────────────────────────────────────────────┘ 前端侧 Node 22.21.1、Vite + Vue 3.5，属于构建工具链而非运行中间件。整套依赖 Spring Boot BOM 对齐版本，没有手工锁冲突的三方包。