xiaoli/peixue-dev

Fork 0

xiaojiang e5624c2876 feat: 快速派单功能分离 & 后端配置优化

2026-02-28 16:11:51 +08:00

5.7 KiB

Raw Blame History

家长端评价功能实现完成报告

实施日期： 2026-01-23
功能模块： 家长端服务评价功能
实施人员： Kiro AI Assistant

一、功能概述

实现了完整的家长端服务评价功能，包括：

✅ 订单完成后显示"去评价"按钮
✅ 评价提交页面（星级评分、文字评价、图片上传）
✅ "我的评价"列表页面
✅ 评价数据关联到陪伴员
✅ 后端API完整支持

二、实施内容

1. 数据库修改

文件： peidu/sql/create_review_table_2026-01-23.sql

创建 review 评价表
为 order 表添加 reviewed 字段
插入测试数据

表结构：

评分字段：服务态度、教学质量、准时性、综合评分
评价内容：文字内容、图片（JSON数组）
评价状态：是否匿名、状态
回复信息：陪伴员回复内容、回复时间

2. 后端实现

实体类：

Review.java - 评价实体
ReviewVO.java - 评价视图对象
ReviewDTO.java - 评价提交DTO

Mapper：

ReviewMapper.java - 评价数据访问层
- 查询评价详情（包含关联信息）
- 查询用户评价列表
- 查询陪伴员评价列表

Service：

ReviewService.java - 评价服务接口
ReviewServiceImpl.java - 评价服务实现
- 提交评价（自动计算综合评分）
- 检查订单是否已评价
- 陪伴员回复评价

Controller：

ReviewController.java - 评价控制器
- POST /api/review/submit - 提交评价
- GET /api/review/{id} - 查询评价详情
- GET /api/review/my-list - 查询我的评价列表
- GET /api/review/teacher/{teacherId} - 查询陪伴员评价列表
- GET /api/review/check/{orderId} - 检查订单是否已评价
- POST /api/review/reply/{reviewId} - 陪伴员回复评价

3. 前端实现

API文件：

peidu/uniapp/src/api/review.js - 评价API封装

页面文件：

评价提交页面 - peidu/uniapp/src/user-package/pages/review/submit.vue
- 订单信息展示
- 三项评分（服务态度、教学质量、准时性）
- 综合评分自动计算
- 评价内容输入（最多200字）
- 图片上传（最多9张）
- 匿名选项
我的评价列表 - peidu/uniapp/src/user-package/pages/review/list.vue
- 评价列表展示
- 评分星级显示
- 评价内容预览
- 图片预览
- 陪伴员回复显示
- 下拉刷新
订单详情页修改 - peidu/uniapp/src/order-package/pages/order/detail.vue
- 已完成订单显示"去评价"按钮
- 已评价订单显示"再次预约"按钮
- 添加 reviewed 字段判断
个人中心修改 - peidu/uniapp/src/pages/user/index.vue
- 添加"我的评价"菜单项

路由配置：

在 pages.json 中注册评价相关页面

三、功能特点

1. 评分系统

三维评分：服务态度、教学质量、准时性
综合评分自动计算（三项平均分，保留1位小数）
星级可视化展示

2. 评价内容

文字评价（最多200字）
图片上传（最多9张）
匿名评价选项

3. 数据关联

评价关联订单、用户、陪伴员、学生
订单评价状态自动更新
陪伴员可查看和回复评价

4. 用户体验

直观的星级评分界面
实时字数统计
图片预览和删除
下拉刷新
友好的空状态提示

四、测试指南

1. 数据库准备

# 执行SQL脚本
mysql -u root -p peidu < peidu/sql/create_review_table_2026-01-23.sql

2. 后端编译

cd peidu/backend
mvn clean compile

3. 前端编译

cd peidu/uniapp
npm run build:mp-weixin

4. 测试步骤

测试评价提交：

登录家长账号
进入"我的预约"
选择已完成的订单
点击"去评价"按钮
填写评分和评价内容
上传图片（可选）
选择是否匿名
提交评价

测试评价列表：

进入个人中心
点击"我的评价"
查看评价列表
下拉刷新
点击图片预览

测试陪伴员端：

登录陪伴员账号
查看评价列表
回复评价

五、API文档

1. 提交评价

POST /api/review/submit
Content-Type: application/json

{
  "orderId": 102,
  "serviceScore": 5,
  "qualityScore": 5,
  "punctualityScore": 5,
  "content": "服务很好",
  "images": ["url1", "url2"],
  "isAnonymous": false
}

2. 查询我的评价列表

GET /api/review/my-list

3. 查询陪伴员评价列表

GET /api/review/teacher/{teacherId}

4. 检查订单是否已评价

GET /api/review/check/{orderId}

六、注意事项

评价权限
- 只有已完成的订单才能评价
- 每个订单只能评价一次
- 只能评价自己的订单
图片上传
- 目前使用本地路径，生产环境需要上传到云存储
- 需要实现图片压缩和格式转换
匿名评价
- 匿名评价不显示用户昵称和头像
- 但后台仍然记录用户ID
评价回复
- 陪伴员可以回复评价
- 每条评价只能回复一次
- 回复后不可修改

七、后续优化建议

评价标签
- 添加快速评价标签（专业、耐心、准时等）
- 标签统计和展示
评价筛选
- 按评分筛选
- 按时间筛选
- 按陪伴员筛选
评价统计
- 陪伴员评价统计
- 好评率计算
- 评分趋势分析
评价提醒
- 服务完成后提醒评价
- 未评价订单提醒
评价奖励
- 评价后赠送积分
- 优质评价奖励

实施完成时间： 2026-01-23
状态： ✅ 已完成

5.7 KiB Raw Blame History Unescape Escape