12 KiB
12 KiB
🎯 评价系统架构图
系统架构总览
┌─────────────────────────────────────────────────────────────┐
│ 评价系统架构 │
└─────────────────────────────────────────────────────────────┘
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 家长端 │ │ 陪伴员端 │ │ 管理师端 │
│ │ │ │ │ │
│ • 提交评价 │ │ • 查看评价 │ │ • 评价统计 │
│ • 查看评价 │ │ • 回复评价 │ │ • 评价管理 │
│ • 上传图片 │ │ • 评价统计 │ │ • 数据分析 │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌───────▼────────┐
│ API Gateway │
│ (ReviewAPI) │
└───────┬────────┘
│
┌───────▼────────┐
│ ReviewController│
│ │
│ • submit │
│ • getDetail │
│ • getMyList │
│ • getTeacherList│
│ • reply │
└───────┬────────┘
│
┌───────▼────────┐
│ ReviewService │
│ │
│ • 业务逻辑 │
│ • 权限验证 │
│ • 数据处理 │
└───────┬────────┘
│
┌───────▼────────┐
│ ReviewMapper │
│ │
│ • SQL查询 │
│ • 关联查询 │
└───────┬────────┘
│
┌───────▼────────┐
│ MySQL数据库 │
│ │
│ • review表 │
│ • order表 │
│ • user表 │
│ • teacher表 │
│ • student表 │
└─────────────────┘
数据流转图
1. 评价提交流程
家长端
│
├─ 1. 点击"去评价"按钮
│ (order/detail.vue 或 order/my-orders.vue)
│
├─ 2. 跳转到评价提交页面
│ (user-package/pages/review/submit.vue)
│
├─ 3. 填写评价内容
│ • 服务态度评分 (1-5星)
│ • 教学质量评分 (1-5星)
│ • 准时性评分 (1-5星)
│ • 文字评价
│ • 上传图片 (最多9张)
│ • 是否匿名
│
├─ 4. 提交评价
│ POST /api/review/submit
│
▼
后端处理
│
├─ 5. ReviewController.submitReview()
│ • 获取用户ID
│ • 调用Service层
│
├─ 6. ReviewService.submitReview()
│ • 验证订单存在
│ • 验证订单归属
│ • 验证订单状态 (3或4)
│ • 检查是否已评价
│ • 计算综合评分
│ • 处理图片JSON
│ • 保存评价
│ • 更新订单状态
│
├─ 7. ReviewMapper.insert()
│ • 插入review表
│
├─ 8. OrderMapper.updateById()
│ • 更新order.reviewed = true
│
▼
返回结果
│
└─ 9. 前端显示成功
• 提示"评价成功"
• 跳转到评价列表
2. 评价查看流程
家长端
│
├─ 1. 点击"我的评价"
│ (pages/user/index.vue)
│
├─ 2. 跳转到评价列表
│ (user-package/pages/review/list.vue)
│
├─ 3. 加载评价列表
│ GET /api/review/my-list
│
▼
后端处理
│
├─ 4. ReviewController.getMyReviewList()
│ • 获取用户ID
│
├─ 5. ReviewService.getUserReviewList()
│ • 调用Mapper查询
│
├─ 6. ReviewMapper.getUserReviewList()
│ • 关联查询订单信息
│ • 关联查询陪伴员信息
│ • 关联查询学生信息
│ • 返回ReviewVO列表
│
▼
返回结果
│
└─ 7. 前端展示评价列表
• 显示评分
• 显示内容
• 显示图片
• 显示陪伴员回复
3. 陪伴员查看和回复流程
陪伴员端
│
├─ 1. 进入评价列表
│ (teacher-package/pages/teacher/reviews.vue)
│
├─ 2. 加载评价列表
│ GET /api/review/teacher/{teacherId}
│
├─ 3. 查看评价详情
│
├─ 4. 点击"回复"按钮
│
├─ 5. 输入回复内容
│
├─ 6. 提交回复
│ POST /api/review/reply/{reviewId}
│
▼
后端处理
│
├─ 7. ReviewController.replyReview()
│ • 获取陪伴员ID
│
├─ 8. ReviewService.replyReview()
│ • 验证评价存在
│ • 验证权限（只能回复自己的评价）
│ • 检查是否已回复
│ • 更新回复内容
│ • 设置回复时间
│
├─ 9. ReviewMapper.updateById()
│ • 更新review.replyContent
│ • 更新review.replyTime
│
▼
返回结果
│
└─ 10. 前端显示回复成功
• 刷新评价列表
• 显示回复内容
数据库关系图
┌─────────────────┐
│ order表 │
│ │
│ • id │◄────┐
│ • orderNo │ │
│ • userId │ │
│ • teacherId │ │
│ • studentId │ │
│ • status │ │
│ • reviewed │ │ 关联
└─────────────────┘ │
│
┌─────────────────┐ │
│ review表 │ │
│ │ │
│ • id │ │
│ • orderId │─────┘
│ • userId │─────┐
│ • teacherId │─────┼─┐
│ • studentId │─────┼─┼─┐
│ • serviceScore │ │ │ │
│ • qualityScore │ │ │ │
│ • punctualityScore│ │ │ │
│ • overallScore │ │ │ │
│ • content │ │ │ │
│ • images │ │ │ │
│ • isAnonymous │ │ │ │
│ • replyContent │ │ │ │
│ • replyTime │ │ │ │
└─────────────────┘ │ │ │
│ │ │
┌─────────────────┐ │ │ │
│ user表 │◄────┘ │ │
│ │ │ │
│ • id │ │ │
│ • phone │ │ │
│ • nickname │ │ │
└─────────────────┘ │ │
│ │
┌─────────────────┐ │ │
│ teacher表 │◄──────┘ │
│ │ │
│ • id │ │
│ • name │ │
│ • phone │ │
│ • rating │ │
└─────────────────┘ │
│
┌─────────────────┐ │
│ student表 │◄────────┘
│ │
│ • id │
│ • studentName │
│ • age │
└─────────────────┘
页面路由图
家长端路由
├─ /pages/user/index.vue (个人中心)
│ └─ 点击"我的评价" → /user-package/pages/review/list.vue
│
├─ /order-package/pages/order/my-orders.vue (我的订单)
│ ├─ 点击"评价" → /user-package/pages/review/submit.vue
│ └─ 点击"查看反馈" → /user-package/pages/review/list.vue
│
├─ /order-package/pages/order/detail.vue (订单详情)
│ ├─ 点击"去评价" → /user-package/pages/review/submit.vue
│ └─ 点击"查看评价" → /user-package/pages/review/list.vue
│
├─ /user-package/pages/review/submit.vue (评价提交)
│ └─ 提交成功 → /user-package/pages/review/list.vue
│
└─ /user-package/pages/review/list.vue (评价列表)
陪伴员端路由
├─ /teacher-package/pages/teacher/reviews.vue (评价列表)
│ └─ 点击"回复" → 弹窗输入回复
│
└─ /pages/teacher/detail.vue (陪伴员详情)
└─ 点击"查看评价" → /teacher-package/pages/teacher/reviews.vue
管理师端路由
├─ /manager-package/pages/manager/teacher-detail.vue (陪伴员详情)
│ └─ 点击"查看评价" → /manager-package/pages/manager/teacher-reviews.vue
│
└─ /manager-package/pages/manager/reports.vue (汇总报告)
└─ 显示评价详情
API接口清单
| 接口 | 方法 | 路径 | 说明 | 权限 |
|---|---|---|---|---|
| 提交评价 | 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} |
陪伴员回复评价 | 陪伴员 |
权限控制
家长端
├─ ✅ 可以提交评价（自己的订单）
├─ ✅ 可以查看自己的评价
├─ ✅ 可以查看陪伴员的评价
└─ ❌ 不能回复评价
陪伴员端
├─ ✅ 可以查看自己收到的评价
├─ ✅ 可以回复评价（自己的评价）
├─ ❌ 不能提交评价
└─ ❌ 不能删除评价
管理师端
├─ ✅ 可以查看所有评价
├─ ✅ 可以查看评价统计
├─ ❌ 不能提交评价
└─ ❌ 不能回复评价（可扩展）
状态流转
订单状态
├─ 0: 待支付 ❌ 不能评价
├─ 1: 待派单 ❌ 不能评价
├─ 2: 待服务 ❌ 不能评价
├─ 3: 服务中 ✅ 可以评价
├─ 4: 已完成 ✅ 可以评价
└─ 5: 已取消 ❌ 不能评价
评价状态
├─ 未评价 → 点击"去评价" → 评价提交页
├─ 已评价 → 点击"查看评价" → 评价列表页
└─ 已回复 → 显示陪伴员回复内容
创建时间：2026-01-23
系统版本：v1.0