966120
编辑 | blame | 历史 | 原始文档

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

📋 部署清单

1. 数据库脚本执行顺序

-- 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：执行数据库脚本

# 连接数据库
mysql -u username -p database_name

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

步骤2：编译后端项目

# 在项目根目录执行
mvn clean install

步骤3：启动后端服务

cd ruoyi-admin
mvn spring-boot:run

步骤4：编译前端项目

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. 检查数据库表

-- 检查表是否创建成功
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. 检查默认数据

-- 检查评价维度默认数据
SELECT * FROM evaluation_dimension;

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

🐛 常见问题

1. 菜单不显示

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

2. 二维码生成失败

原因：文件路径权限问题
解决：
- 检查 ruoyi.profile 配置的路径
- 确保目录有写入权限
- 检查磁盘空间

3. 评价提交失败

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

4. 微信授权失败

原因：微信配置问题
解决：
- 检查AppID和AppSecret配置
- 确认域名配置正确
- 检查HTTPS证书

📈 性能优化建议

1. 数据库优化

-- 添加索引
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. 多语言支持

  • 支持多语言评价界面
  • 国际化配置

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