# AI智能电商运营工作台

**Repository Path**: parsecc/customer-service-intelligence

## Basic Information

- **Project Name**: AI智能电商运营工作台
- **Description**: 基于 Spring Boot + Vue.js + Spring AI 的客户服务智能系统，提供 AI 智能客服、数据分析、知识库管理和任务工单等功能。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-05-12
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringAI, Vue

## README



# AI智能电商运营工作台

基于 Spring Boot + Vue.js + Spring AI 的客户服务智能系统，提供 AI 智能客服、数据分析、知识库管理、任务工单和沙箱环境等功能。

## 系统功能

### 🤖 AI 智能客服
- AI Agent 智能对话，支持 ReAct 模式
- 智能工具调用：订单查询、库存查询、投诉处理、任务创建等
- 异常趋势检测与自动告警
- WebSocket 实时状态推送
- RAG 向量知识库检索

### 📊 数据分析
- 仪表盘统计数据
- 销售/库存/投诉报告生成
- 趋势图表可视化
- SQL 查询分析（安全防护）
- 图表配置生成（ECharts）

### 📚 知识库管理
- 文档创建与分类
- 向量索引与检索
- 知识库批量管理
- 文件解析上传

### ✅ 任务工单
- 工单/任务创建与分配
- 状态流转管理
- 逾期提醒通知
- 优先级设置

### 🔔 通知系统
- 站内通知推送
- 邮件通知
- WebSocket 实时推送
- 未读消息统计

### 🛡️ 系统安全
- JWT 认证授权
- RBAC 角色权限控制
- API 限流保护
- 审计日志记录
- 数据脱敏

### 🖥️ 沙箱环境
- 本地命令执行（Shell/CMD），支持自定义工作目录和超时控制
- 本地应用启动与后台运行管理
- 运行中进程查看与终止
- AI 对话工具集成：可通过自然语言指令调用沙箱功能（如"打开计算器"、"执行 ipconfig"）
- 安全隔离：仅限管理员角色访问，输出长度限制，审计日志记录

## 技术架构

### 后端
- Spring Boot 3.x
- Spring AI (AI Agent)
- Spring Security + JWT
- PostgreSQL + pgvector (向量数据库)
- Redis (缓存/限流)
- RabbitMQ (消息队列)
- Java 17

### 前端
- Vue 3 + Composition API
- Vite 构建
- Pinia 状态管理
- Vue Router
- Axios
- ECharts

## 快速开始

### 环境要求
- JDK 17+
- Node.js 20+
- PostgreSQL 15+ (需安装 pgvector 扩展)
- Redis 7+
- Maven 3.9+

### 配置步骤

1. **克隆项目**
```bash
git clone https://gitee.com/parsecc/customer-service-intelligence.git
cd customer-service-intelligence
```

2. **配置数据库**
```bash
# 创建数据库
createdb aiops_db

# 执行 SQL 脚本
psql -d aiops_db -f backend/src/main/resources/db/schema.sql
psql -d aiops_db -f backend/src/main/resources/db/data.sql

# (可选) 向量维度升级
psql -d aiops_db -f backend/src/main/resources/db/upgrade_vectors_1024.sql
```

3. **配置后端**
```bash
cp backend/.env.example backend/.env
# 编辑 application.yml 或 application-dev.yml 配置数据库/Redis 等
```

4. **启动后端**
```bash
cd backend
mvn spring-boot:run
```

5. **启动前端**
```bash
cd frontend
npm install
npm run dev
```

6. **访问系统**
- 前端: http://localhost:5173
- 后端 API: http://localhost:8080

### Docker 部署

```bash
# 编译
mvn clean package -DskipTests

# 构建镜像
docker-compose up -d
```

## 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 运营 | operator | operator123 |

## API 文档

启动后访问 Swagger UI: `http://localhost:8080/swagger-ui.html`

### 沙箱环境 API（仅管理员）

| 方法 | 端点 | 说明 |
|------|------|------|
| POST | `/api/v1/sandbox/execute` | 执行本地命令 |
| POST | `/api/v1/sandbox/app/launch` | 启动本地应用 |
| DELETE | `/api/v1/sandbox/app/{pid}` | 终止进程 |
| GET | `/api/v1/sandbox/app/list` | 列出运行中应用 |

### 沙箱配置

在 `application.yml` 中可配置以下参数：

```yaml
sandbox:
  max-timeout-seconds: 300   # 命令最大超时时间（秒）
  max-output-size: 1048576   # 命令最大输出字节数（1MB）
```

## 目录结构

```
ai-ops-workstation-optimized/
├── backend/
│   ├── src/main/java/com/aiops/
│   │   ├── agent/           # AI Agent 核心
│   │   │   ├── dto/         # Agent通信DTO
│   │   │   ├── OpsAgentOrchestrator.java  # Agent编排引擎
│   │   │   ├── OpsAgentTools.java         # 运营工具集
│   │   │   └── SandboxTools.java          # 沙箱工具集
│   │   ├── annotation/      # 自定义注解
│   │   ├── aspect/          # AOP 切面
│   │   ├── config/          # 配置类
│   │   ├── controller/      # 控制器
│   │   ├── dto/             # 数据传输对象
│   │   ├── entity/          # 实体类
│   │   ├── enums/           # 枚举
│   │   ├── exception/       # 异常处理
│   │   ├── health/          # 健康检查
│   │   ├── init/            # 数据初始化
│   │   ├── repository/      # 数据访问
│   │   ├── scheduled/       # 定时任务
│   │   ├── security/        # 安全认证
│   │   ├── service/         # 业务服务
│   │   │   ├── impl/        # 服务实现
│   │   │   └── SandboxService.java       # 沙箱服务接口
│   │   └── AiOpsApplication.java
│   ├── src/main/resources/
│   │   ├── application.yml
│   │   ├── application-dev.yml
│   │   └── db/              # 数据库脚本
│   └── pom.xml
├── frontend/
│   ├── src/
│   │   ├── api/             # API接口模块
│   │   ├── components/      # 公共组件
│   │   ├── composables/     # 组合式函数
│   │   ├── router/          # 路由配置
│   │   ├── stores/          # Pinia状态管理
│   │   ├── styles/          # 全局样式
│   │   ├── utils/           # 工具函数
│   │   └── views/           # 页面视图
│   │       ├── Sandbox.vue  # 沙箱环境页面
│   │       └── ...
│   └── package.json
├── docs/                    # 项目文档
│   ├── 沙箱环境使用指南.md
│   ├── 优化变更记录.md
│   ├── 数据库设计文档.md
│   ├── Docker部署指南.md
│   └── ...
├── docker-compose.yml
└── LICENSE
```

## 核心模块说明

### AI Agent 工具
- `queryOrder` - 订单查询
- `queryInventory` - 库存查询
- `queryComplaints` - 投诉查询
- `createTicket` - 创建工单
- `getDatabaseSchema` - 获取表结构
- `executeAnalysisSQL` - SQL 分析
- `generateChart` - 生成图表
- `saveReport` - 保存报告
- `searchKnowledge` - 知识检索
- `executeCommand` - 沙箱执行系统命令
- `launchApplication` - 沙箱启动本地应用
- `killApplication` - 沙箱终止进程
- `listApplications` - 沙箱列出运行中应用

### 定时任务
- 任务到期提醒 (每5分钟)
- 每日报告生成 (18:00)
- 周报生成 (每周一 2:00)
- 月报生成 (每月1日 3:00)
- 低库存预警 (每小时)
- 会话清理 (每周日 4:00)

## 许可证

MIT License