# 客户满意度评价功能完整部署指南

## 📋 部署清单

### 1. 数据库脚本执行顺序
```sql
-- 1. 执行数据库表结构
source sql/customer_evaluation_tables.sql

-- 2. 执行菜单配置
source sql/evaluation_menu.sql

-- 3. 执行字典配置
source sql/evaluation_dict.sql
```

### 2. 后端配置

#### 2.1 微信配置（可选）
在 `ruoyi-admin/src/main/resources/application.yml` 中配置：
```yaml
wechat:
  appId: your_wechat_appid
  appSecret: your_wechat_appsecret
  redirectUri: http://yourdomain.com/evaluation
```

#### 2.2 文件上传路径配置
确保 `ruoyi.profile` 配置的路径有写入权限：
```yaml
ruoyi:
  profile: /path/to/upload
```

### 3. 前端配置

#### 3.1 路由配置
已在 `ruoyi-ui/src/router/index.js` 中添加评价相关路由。

#### 3.2 页面组件
已创建以下页面组件：
- `ruoyi-ui/src/views/evaluation/index.vue` - 客户评价页面
- `ruoyi-ui/src/views/evaluation/test.vue` - 测试页面
- `ruoyi-ui/src/views/evaluation/customer/index.vue` - 客户评价管理
- `ruoyi-ui/src/views/evaluation/dimension/index.vue` - 评价维度配置
- `ruoyi-ui/src/views/evaluation/qrcode/index.vue` - 车辆二维码管理

## 🚀 部署步骤

### 步骤1：执行数据库脚本
```bash
# 连接数据库
mysql -u username -p database_name

# 执行脚本
source sql/customer_evaluation_tables.sql
source sql/evaluation_menu.sql
source sql/evaluation_dict.sql
```

### 步骤2：编译后端项目
```bash
# 在项目根目录执行
mvn clean install
```

### 步骤3：启动后端服务
```bash
cd ruoyi-admin
mvn spring-boot:run
```

### 步骤4：编译前端项目
```bash
cd ruoyi-ui
npm install
npm run dev
```

## 🧪 功能测试

### 1. 访问管理界面
- 登录系统后，在左侧菜单中可以看到"评价管理"菜单
- 包含以下子菜单：
  - 客户评价
  - 评价维度
  - 车辆二维码
  - 评价统计

### 2. 测试评价功能
- 访问：`http://localhost:80/evaluation/test`
- 测试二维码生成、评价维度加载、评价提交等功能

### 3. 测试评价页面
- 访问：`http://localhost:80/evaluation?vehicle=粤A12345`
- 填写评价信息并提交

## 📱 微信配置（生产环境）

### 1. 微信公众平台配置
1. 登录微信公众平台
2. 进入"开发" -> "接口权限"
3. 配置网页授权域名：`yourdomain.com`
4. 配置JS接口安全域名：`yourdomain.com`

### 2. 域名配置
- 确保域名已备案
- 配置HTTPS证书
- 更新配置文件中的域名

## 🔧 权限配置

### 1. 角色权限
系统管理员需要为相关角色分配以下权限：
- `evaluation:customer:list` - 客户评价查询
- `evaluation:customer:remove` - 客户评价删除
- `evaluation:customer:export` - 客户评价导出
- `evaluation:dimension:list` - 评价维度查询
- `evaluation:dimension:add` - 评价维度新增
- `evaluation:dimension:edit` - 评价维度修改
- `evaluation:dimension:remove` - 评价维度删除
- `evaluation:qrcode:list` - 二维码查询
- `evaluation:qrcode:generate` - 二维码生成
- `evaluation:qrcode:batch` - 批量生成二维码
- `evaluation:qrcode:remove` - 二维码删除

### 2. 菜单权限
菜单权限已通过SQL脚本自动配置。

## 📊 数据验证

### 1. 检查数据库表
```sql
-- 检查表是否创建成功
SHOW TABLES LIKE '%evaluation%';

-- 检查菜单是否添加成功
SELECT * FROM sys_menu WHERE menu_name LIKE '%评价%';

-- 检查字典是否添加成功
SELECT * FROM sys_dict_type WHERE dict_type IN ('evaluation_status', 'dimension_type');
```

### 2. 检查默认数据
```sql
-- 检查评价维度默认数据
SELECT * FROM evaluation_dimension;

-- 应该看到5条默认评价维度数据
```

## 🐛 常见问题

### 1. 菜单不显示
**原因**：可能是权限问题或菜单数据未正确插入
**解决**：
- 检查用户角色权限
- 重新执行菜单SQL脚本
- 清除浏览器缓存

### 2. 二维码生成失败
**原因**：文件路径权限问题
**解决**：
- 检查 `ruoyi.profile` 配置的路径
- 确保目录有写入权限
- 检查磁盘空间

### 3. 评价提交失败
**原因**：可能是必填字段验证失败
**解决**：
- 检查评价维度配置
- 确保所有必填字段都已填写
- 查看后端日志

### 4. 微信授权失败
**原因**：微信配置问题
**解决**：
- 检查AppID和AppSecret配置
- 确认域名配置正确
- 检查HTTPS证书

## 📈 性能优化建议

### 1. 数据库优化
```sql
-- 添加索引
CREATE INDEX idx_evaluation_vehicle_time ON customer_evaluation(vehicle_no, evaluation_time);
CREATE INDEX idx_evaluation_status ON customer_evaluation(evaluation_status);
CREATE INDEX idx_evaluation_detail_evaluation ON evaluation_detail(evaluation_id);
```

### 2. 缓存配置
- 评价维度配置可以缓存
- 二维码图片使用CDN加速

### 3. 文件存储
- 考虑使用对象存储服务
- 定期清理无用的二维码文件

## 📞 技术支持

如遇到问题，请提供：
1. 错误日志
2. 操作步骤
3. 环境信息
4. 错误截图

## 🎯 功能扩展

### 1. 评价统计
可以基于现有数据开发：
- 评价趋势分析
- 车辆评价排行
- 客户满意度报告

### 2. 消息通知
- 评价提交后发送通知
- 低分评价预警
- 定期评价报告

### 3. 多语言支持
- 支持多语言评价界面
- 国际化配置

功能已全部开发完成，可以正常使用！