# ReviewPilot

**Repository Path**: smtgw/ReviewPilot

## Basic Information

- **Project Name**: ReviewPilot
- **Description**: AI 电商差评转化助手
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 电商差评转化助手

基于 Java + Vue + AI 的电商客服辅助系统，帮助淘宝、京东、拼多多等商家快速分析差评、生成高情商回复、推荐补偿方案并查看数据统计。

## 技术栈

后端：Java 17、Spring Boot 3、MyBatis Plus、MySQL 8、JWT、Maven  
前端：Vue3、Vite、Element Plus、Axios、ECharts  
AI：DeepSeek API / OpenAI-compatible API

## 核心功能

- 用户注册、登录、JWT 鉴权
- 差评提交、AI 自动分析、历史记录管理
- 情绪分析、严重等级判断、辱骂检测、挽回概率预测
- 官方客服、温柔道歉、幽默三种回复风格
- AI 推荐补偿建议和优惠券额度
- 回复模板收藏、复用和管理
- 首页仪表盘、分类统计、平台分布、关键词云、趋势分析

## 快速启动

### 1. 初始化数据库

创建 MySQL 8 数据库并执行：

```sql
source review-pilot-backend/src/main/resources/sql/init.sql;
```

### 2. 配置后端

默认配置位于 `review-pilot-backend/src/main/resources/application.yml`，可通过环境变量覆盖：

```bash
DB_URL=jdbc:mysql://localhost:3306/review_pilot?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
DB_USERNAME=root
DB_PASSWORD=123456
AI_BASE_URL=https://api.deepseek.com
AI_API_KEY=你的API密钥
AI_MODEL=deepseek-chat
JWT_SECRET=review-pilot-default-jwt-secret-key-2026
```

未配置 `AI_API_KEY` 时，系统会启用本地规则兜底，方便课程设计和演示。

### 3. 启动后端

```bash
cd review-pilot-backend
mvn spring-boot:run
```

接口文档：

```text
http://localhost:8080/swagger-ui.html
```

启动后也可以直接访问一体化页面：

```text
http://localhost:8080
```

默认管理员账号：

```text
用户名：admin
密码：123456
```

### 4. 启动前端

如果需要前后端分离开发，再单独启动前端：

```bash
cd review-pilot-frontend
npm install
npm run dev
```

访问：

```text
http://localhost:5173
```

## Docker 部署

```bash
docker compose up -d --build
```

前端地址：`http://localhost:5173`  
后端地址：`http://localhost:8080`

## 项目亮点

- 将差评处理拆为 AI 工作流：分析、分级、回复、补偿、统计。
- Prompt 设计要求模型返回结构化 JSON，方便 Java 后端落库和前端展示。
- 实现关键词云、分类统计、平台分布、挽回趋势等数据可视化。
- 保持中等规模，结构清晰，适合课程设计、简历项目和软著申请。

## DeepSeek 配置

本地开发可在 `review-pilot-backend/src/main/resources/application-local.yml` 中配置 DeepSeek。该文件已加入 `.gitignore`，避免 API Key 被提交到仓库。