# sherry-ticket **Repository Path**: CodeBuildingWorld/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**: 0 - **Forks**: 5 - **Created**: 2026-10-16 - **Last Updated**: 2026-10-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Sherry Ticket - Intelligent AI Ticket System [![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) **Sherry Ticket** is an intelligent, omnichannel ticket management system built on Spring Boot 3 and Vue 3. It supports full-lifecycle ticket tracking, SLA monitoring, and multi-channel notifications. It features multiple customer channels (self-service portal, link/QR code submission, email, and WeChat), a zero-code drag-and-drop form builder, and AI-powered ticket classification, priority prediction, and smart replies to help companies easily streamline customer support and IT service workflows. --- ## 🔗 Online Demo - **Gitee Repository**: [https://gitee.com/sanbox/sherry-ticket](https://gitee.com/sanbox/sherry-ticket) - **Demo URL**: [https://ticket.ciyocloud.cn/](https://ticket.ciyocloud.cn/) (Test Account: `test` / `12345678`) ### 🖥️ Screenshots | Dashboard | Workspace | | :---: | :---: | | ![Dashboard](readmeimg/dashboard.png) | ![Workspace](readmeimg/workspace.png) | | Analytics Board | | :---: | | ![Analytics Board](readmeimg/analytics.png) | --- ## ✨ Key Features - 🤖 **AI-Powered Agent Copilot**: Leverages AI to auto-predict ticket categories and priorities, and recommends high-accuracy responses contextually to double agent efficiency instantly. - 🎫 **Dual-Track Immersive Workspace**: Built-in public replies and private internal notes for seamless cross-department collaboration. Claims, transfers, suspends, and resolves tickets with a closed-loop flow. - 🌐 **Seamless Omnichannel Deflection**: Integrates customer portals, automated email-to-ticket conversion, WeChat official accounts, and guest scan-to-submit QR codes to prevent any message loss. - 🎨 **Zero-Code Dynamic Form Builder**: Drag-and-drop builder to configure fields and schemas dynamically. Bind customized forms to distinct business scenarios to collect precise upfront information. - ⏱️ **Rigorous SLA Guard**: Precision tracking for first-response and final-resolution goals. Eye-catching visual countdown tickers with multi-tier automated escalations enforce 100% compliance. - 📚 **KCS-Aligned Knowledge Deflection**: Front-end search suggestions deflect up to 30%+ of routine inquiries before submission. Empowers support agents to retrieve and quote solutions in milliseconds. - 👥 **360° Customer Portrait**: Aggregates customer profiles, emails, and ticket history from all channels. Merge duplicate accounts with one click to maintain continuous service context. - 📊 **Executive Dashboard & Real-Time Alerts**: Multi-dimensional command center visualizing SLA rates, resolution stats, and hot topics. High-performance SSE protocol delivers millisecond-level push alerts. - 💾 **Hybrid Cloud Storage & Notifications**: Unified storage APIs compatible with Local, MinIO, Aliyun OSS, Tencent COS, Qiniu, and AWS S3. Notifications via WeChat templates, emails, and SMS. - 🔒 **Enterprise Sovereignty & 信创 Compliance**: Fully compatible with Kingbase (国产金仓数据库), PostgreSQL, and MySQL, meeting strict localized data sovereignty and Xinchuang standards. ## 🗺️ Roadmap - [ ] **Multi-Tenancy (SaaS)**: Secure data isolation for enterprise tenants. - [ ] **Mobile Agent App / Mini-Program**: Empower support agents to manage tickets on the go. - [ ] **Visual Workflow Builder**: Define customizable, automated routing nodes and trigger actions. - [ ] **AI Agent Integration**: Introduce LLM-based autonomous agents for first-line triaging and resolving common issues. - [ ] **Call Center Integration**: Seamlessly convert phone calls into support tickets. --- ## 🛠️ Tech Stack & Architecture ### Backend - **Core Framework**: Spring Boot 3.4.1 - **Security & Auth**: Sa-Token 1.44.0 + JWT - **Persistence**: MyBatis Plus 3.5.16 - **Database**: MySQL 8.0+ / 9.5+ - **API Documentation**: SpringDoc 2.8.3 + Knife4j 4.5.0 (OpenAPI 3) - **Utilities**: Hutool 5.8, Lombok, MapStruct, EasyExcel - **Messaging & Scheduling**: Quartz (Job), SSE (Server-Sent Events), WebSocket - **Cloud Service SDKs**: Aliyun / Tencent Cloud / Baidu Cloud SMS, WeChat Java SDK (WxJava), MinIO / Aliyun OSS / Tencent COS / Qiniu / AWS S3 ### Frontend - **Core Framework**: Vue 3.5 (Composition API) + TypeScript - **Build Tool**: Vite 7.1 - **UI Component Library**: Element Plus 2.11 + Vant 4 (Mobile adaptation) - **CSS Engine**: UnoCSS (Atomic CSS) - **State Management**: Pinia 3.0 + Pinia PersistedState - **Data Visualization**: ECharts 6.0 - **i18n & Icons**: Vue I18n, Iconify, Element Plus Icons --- ## 📂 Project Structure ```text sherry-ticket ├── sherry-admin # Admin entry module, including API controllers, global exception & security configs ├── sherry-ticket # Core ticket business logic (Ticket flow, Customer Portal, Knowledge Base, SLA, WeChat callbacks) ├── sherry-form # Zero-code dynamic form engine (Custom fields, property extensions, metadata management) ├── sherry-message # Message center (In-app notifications, Email, WeChat template messages, Aliyun/Tencent SMS) ├── sherry-system # System management (Users, Roles, Departments, Posts, Dictionaries, Env configs, Logs) ├── sherry-file # Multi-OSS storage service (Local, Aliyun OSS, Tencent COS, MinIO, etc.) ├── sherry-job # Distributed scheduled job management (Quartz) ├── sherry-generator # Rapid development code generator ├── sherry-common # Utility classes, base Entity/DTO/VO classes, and constant definitions └── ticket-front # Vue 3 + Vite + Element Plus frontend application ``` --- ## 🚀 Quick Start ### 1. Prerequisites - **JDK**: 17 + - **MySQL**: 8.0 + / 9.5 + - **Node.js**: 20.19.0 + - **pnpm**: 8.8.0 + ### 2. Database Initialization 1. Create a database named `sherry_ticket` (Recommended charset: `utf8mb4`). 2. Run the SQL script in the `sql/` directory to import base tables and menu data: - `sql/sherry-ticket.sql` ### 3. Backend Setup 1. Configure database credentials in `sherry-admin/src/main/resources/application-dev.yml` or `application-prod.yml`. 2. Build the project using Maven at the root directory: ```bash mvn clean package -DskipTests ``` 3. Run the main application class: `cn.ciyocloud.api.SherryTicketApplication` 4. Access API documentation at: `http://localhost:8080/doc.html` (Knife4j / OpenAPI 3) ### 4. Frontend Setup ```bash cd ticket-front # Install dependencies pnpm install # Start development server pnpm dev # Build for production pnpm build ``` --- ## 🤝 Acknowledgements - [RuoYi](https://gitee.com/y_project/RuoYi): Excellent open-source admin management framework architecture. - [Sa-Token](https://sa-token.cc/): Lightweight Java authorization & authentication framework. - [Element Plus](https://element-plus.org/): Vue 3 based UI component library. --- ## 💬 Community Community QR Code --- ## 📄 License This project is licensed under the [GPL-3.0 License](LICENSE).