# sherry-ticket

**Repository Path**: sanbox/sherry-ticket

## Basic Information

- **Project Name**: sherry-ticket
- **Description**: 雪梨智能 ai 工单客服系统
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 1
- **Created**: 2026-07-14
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 雪梨智能 AI 工单系统 (Sherry Ticket)

[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.4+-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3.5+-4fc08d.svg)](https://vuejs.org/)
[![License](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE)

[中文](README.md) | [English](README.en.md)

**雪梨智能 AI 工单系统 (Sherry Ticket)** 是一个基于 Spring Boot 3 和 Vue 3 开发的智能化、全渠道工单管理系统。

不仅支持传统的工单全流程追踪、SLA 监控和多通道消息通知，还集成了客户自助 Portal、免登录快捷提交、微信服务号、邮件建单等全渠道接入方式。同时，系统自带零代码动态表单引擎，支持可视化拖拽建表，并引入了 AI 智能分类、优先级预测和智能回复推荐，帮企业轻松搞定客户服务与 IT 服务流转。

---

## 🔗 在线体验

- **Gitee 仓库**：[https://gitee.com/sanbox/sherry-ticket](https://gitee.com/sanbox/sherry-ticket)
- **演示地址**：[https://ticket.ciyocloud.cn/](https://ticket.ciyocloud.cn/) （测试账号：`test` / `12345678`）

### 🖥️ 系统截图

| 首页控制台 | 客服工作台 |
| :---: | :---: |
| ![首页控制台](readmeimg/dashboard.png) | ![客服工作台](readmeimg/workspace.png) |

| 效能分析大屏 |
| :---: |
| ![效能分析大屏](readmeimg/analytics.png) |

---

## ✨ 业务功能

- 🤖 **AI 智能提效**：自动识别工单分类与优先级，还能根据历史记录和知识库自动推荐回复内容，客服一键即可发送。
- 🎫 **全能客服工作台**：待办、组内工单清晰分类，支持一键认领、转派、挂起与结案，内部协同备注与外部回复双轨并行。
- 🌐 **全渠道建单接入**：客户可以通过自助 Portal、免登录快捷扫码、发邮件或微信服务号直接提交工单，进度实时同步。
- 🎨 **零代码动态表单**：支持可视化拖拽建表，文本、下拉框、附件等控件随意组合，不同业务分类可绑定不同的自定义表单。
- ⏱️ **SLA 履约保障**：可配置首次响应与最终解决的时限，工单列表自带红黄牌实时倒计时，超时自动发通知告警。
- 📚 **企业知识库**：支持分类和标签管理，客户提交前可搜索知识库自助解决，客服回复时也能快速检索一键引用。
- 👥 **客户档案与合并**：汇总同一个客户在微信、邮件、Portal 等各渠道的工单记录，支持一键合并重复账号。
- 📊 **运营看板与通知**：图形化展示团队效率、SLA 履约率及热点问题，支持 SSE 浏览器桌面级新工单实时推送。
- 📩 **消息中心与云存储**：支持微信、邮件、短信通知，并支持本地/MinIO/阿里OSS/腾讯COS等多介质文件管理。

## 🗺️ 未来规划 (Roadmap)

- [ ] **多租户 SaaS 模式**：支持多企业入驻，数据安全隔离。
- [ ] **移动端客服 App/小程序**：让客服随时随地在手机上处理工单。
- [ ] **可视化工作流引擎 (Workflow)**：支持自由配置工单流转节点与自动触发动作。
- [ ] **深度 AI 智能体 Agent**：引入大模型 Agent，实现无人值守的初审与全自动解决常见问题。
- [ ] **呼叫中心集成**：支持电话接入并自动转录为工单，实现真正的全渠道。

---

## 🛠️ 技术架构

### 后端 (Backend)

- **核心框架**: Spring Boot 3.4.1
- **安全鉴权**: Sa-Token 1.44.0 + JWT
- **持久层**: MyBatis Plus 3.5.16
- **数据库**: MySQL 8.0+ / 9.5+
- **API 文档**: SpringDoc 2.8.3 + Knife4j 4.5.0 (OpenAPI 3)
- **工具链**: Hutool 5.8, Lombok, MapStruct, EasyExcel
- **消息与调度**: Quartz (Job), SSE (Server-Sent Events), WebSocket
- **云服务 SDK**: 阿里云 / 腾讯云 / 百度云 SMS、微信 Java SDK (WxJava)、MinIO / 阿里云 OSS / 腾讯云 COS / 7牛云 / AWS S3

### 前端 (Frontend)

- **核心框架**: Vue 3.5 (Composition API) + TypeScript
- **构建工具**: Vite 7.1
- **UI 组件库**: Element Plus 2.11 + Vant 4 (移动端适配)
- **样式引擎**: UnoCSS (Atomic CSS)
- **状态管理**: Pinia 3.0 + Pinia PersistedState
- **图表展示**: ECharts 6.0
- **国际化/图标**: Vue I18n, Iconify, Element Plus Icons

---

## 📂 项目模块结构

```text
sherry-ticket
├── sherry-admin        # 管理后台入口，包含 API 控制层、全局异常与安全配置
├── sherry-ticket       # 工单业务核心逻辑（工单流转、客户门户、知识库、SLA、微信回调等）
├── sherry-form         # 零代码动态表单引擎（自定义字段、属性扩展与元数据管理）
├── sherry-message      # 消息中心（站内信、邮件、微信服务号、阿里云/腾讯云 SMS）
├── sherry-system       # 系统基础管理（用户、角色、部门、岗位、字典、环境变量与日志）
├── sherry-file         # 多 OSS 文件存储服务（本地、阿里云 OSS、腾讯云 COS、MinIO 等）
├── sherry-job          # 分布式定时任务处理 (Quartz)
├── sherry-generator    # 快速开发代码生成器
├── sherry-common       # 通用工具类、基础 Entity/DTO/VO 与常量定义
└── ticket-front        # Vue 3 + Vite + Element Plus 前端工程
```

---

## 🚀 快速开始

### 1. 环境准备

- **JDK**: 17 +
- **MySQL**: 8.0 + / 9.5 +
- **Node.js**: 20.19.0 +
- **pnpm**: 8.8.0 +

### 2. 数据库初始化

1. 创建数据库 `sherry_ticket`（字符集建议 `utf8mb4`）。
2. 执行 sql 目录下的脚本文件导入基础结构与菜单数据：
   - `sql/sherry-ticket.sql`

### 3. 后端启动

1. 修改 `sherry-admin/src/main/resources/application-dev.yml` 或 `application-prod.yml` 中的数据库账号与密码配置。
2. 在项目根目录使用 Maven 编译构建：
   ```bash
   mvn clean package -DskipTests
   ```
3. 运行主启动类：
   `cn.ciyocloud.api.SherryTicketApplication`
4. 接口文档地址：`http://localhost:8080/doc.html` (Knife4j / OpenAPI3)

### 4. 前端启动

```bash
cd ticket-front

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产包
pnpm build
```

---

## 🤝 贡献与鸣谢

- [RuoYi](https://gitee.com/y_project/RuoYi)：优秀的开源后台管理系统框架架构思想。
- [Sa-Token](https://sa-token.cc/)：轻量级 Java 权限认证框架。
- [Element Plus](https://element-plus.org/)：基于 Vue 3 的组件库。

---

## 💬 交流群

<img src="readmeimg/wechat_group.jpg" width="300" alt="交流群">

---

## 📄 许可证

本项目遵循 [GPL-3.0 License](LICENSE) 开源许可协议。