peixue-dev/Archive/peidu-temp-files/docs/[一次性]家长端未关联功能完整检查报告-2026-01-25.md

家长端未关联功能完整检查报告

检查日期： 2026-01-25
检查范围： 家长端与陪伴员端、管理师端、分销员端、服务商端的数据流通和功能闭环
检查标准： 数据流通、功能串通、逻辑闭环

---

📋 检查方法

1. 数据流向分析 - 检查数据从产生端到消费端的完整流转
2. 功能关联检查 - 验证相关功能是否在各端都有对应实现
3. 逻辑闭环验证 - 确认业务流程能否形成完整闭环

---

✅ 已关联功能（数据流通正常）

1. 成长记录功能 ✅

数据流向： 陪伴员端 → 家长端

• 陪伴员端：

  • ✅ 创建每日反馈：teacher-package/pages/growth-record/daily-create.vue
  • ✅ 查看成长记录列表：teacher-package/pages/growth-record/list.vue
  • ✅ 上传照片和视频
  • ✅ 关联订单信息

• 家长端：

  • ✅ 查看成长记录列表：user-package/pages/growth/list.vue
  • ✅ 查看成长记录详情：user-package/pages/growth/detail.vue
  • ✅ 按类型筛选（每日/周/月反馈）
  • ✅ 查看照片和视频
  • ✅ 标记为已读

API接口：

• ✅ 陪伴员创建：POST /api/growth/record/create
• ✅ 家长查看列表：GET /api/growth/record/parent/list
• ✅ 家长查看详情：GET /api/growth/record/parent/{id}

结论： 功能完整，数据流通正常 ✅

---

2. 服务反馈功能 ✅

数据流向： 陪伴员端 → 家长端

• 陪伴员端：

  • ✅ 编辑反馈：teacher-package/pages/teacher/feedback-edit.vue
  • ✅ 提交服务反馈

• 家长端：

  • ✅ 查看服务反馈列表：user-package/pages/feedback/list.vue
  • ✅ 复用成长记录接口展示反馈内容

API接口：

• ✅ 使用成长记录接口：GET /api/growth/record/parent/list

结论： 功能完整，数据流通正常 ✅

---

3. 评价功能 ✅

数据流向： 家长端 → 陪伴员端

• 家长端：

  • ✅ 提交评价：user-package/pages/review/submit.vue
  • ✅ 查看我的评价：user-package/pages/review/list.vue
  • ✅ 多维度评分（服务态度、教学质量、准时性）
  • ✅ 上传图片
  • ✅ 匿名评价选项

• 陪伴员端：

  • ✅ 查看评价列表：teacher-package/pages/teacher/reviews.vue
  • ✅ 评价统计：teacher-package/pages/teacher/review-statistics.vue
  • ✅ 评价详情：teacher-package/pages/teacher/review-detail.vue

API接口：

• ✅ 提交评价：POST /api/review/submit
• ✅ 查看我的评价：GET /api/review/my-list
• ✅ 陪伴员查看评价：GET /api/review/teacher/list

结论： 功能完整，数据流通正常 ✅

---

❌ 未关联功能（需要实现）

1. 陪伴员回复评价功能 ❌

问题描述： 家长提交评价后，陪伴员无法回复

当前状态：

• ✅ 家长端评价列表显示了"陪伴员回复"区域
• ❌ 陪伴员端没有回复评价的功能入口
• ❌ 缺少回复评价的API接口

影响：

• 无法形成评价互动闭环
• 陪伴员无法对评价进行解释或感谢

需要实现：

1. 陪伴员端： 在评价详情页添加回复功能

   • 文件：teacher-package/pages/teacher/review-detail.vue
   • 功能：添加回复输入框和提交按钮

2. 后端API：

   • POST /api/review/reply - 陪伴员回复评价
   • 参数：{ reviewId, replyContent }

3. 家长端： 已有显示回复的UI，无需修改

优先级： P1（高）

---

2. 订单状态实时同步 ❌

问题描述： 订单状态变更时，相关方未收到通知

当前状态：

• ✅ 陪伴员可以接单、取消订单
• ✅ 管理师可以派单、查看订单
• ❌ 家长端订单状态更新不及时
• ❌ 缺少订单状态变更通知机制

影响：

• 家长不知道订单被接单或取消
• 管理师不知道陪伴员接单情况
• 需要手动刷新才能看到最新状态

需要实现：

1. 消息推送机制：

   • 陪伴员接单 → 通知家长和管理师
   • 陪伴员取消订单 → 通知家长和管理师
   • 管理师派单 → 通知陪伴员
   • 订单完成 → 通知家长进行评价

2. 前端轮询或WebSocket：

   • 家长端：定时轮询订单状态
   • 管理师端：定时轮询待处理工单
   • 陪伴员端：定时轮询待接单列表

3. 消息中心：

   • 已有消息中心页面：user-package/pages/message/center.vue
   • 需要完善消息推送逻辑

优先级： P0（最高）

---

3. 家长查看陪伴员排班 ❌

问题描述： 家长无法查看陪伴员的可用时间

当前状态：

• ✅ 陪伴员端有排班管理：teacher-package/pages/teacher/schedule.vue
• ✅ 陪伴员端有日历视图：teacher-package/pages/calendar/index.vue
• ❌ 家长端无法查看陪伴员排班
• ❌ 预约时无法知道陪伴员是否有空

影响：

• 家长预约时不知道陪伴员是否有空
• 可能预约到陪伴员不可用的时间
• 增加订单取消率

需要实现：

1. 家长端： 添加查看陪伴员排班功能

   • 位置：陪伴员详情页 user-package/pages/teacher/detail.vue
   • 功能：显示陪伴员未来7天的可用时间段

2. 后端API：

   • GET /api/teacher/schedule/{teacherId} - 获取陪伴员排班
   • 参数：{ startDate, endDate }
   • 返回：可用时间段列表

3. UI设计：

   • 日历视图展示可用时间
   • 标记已预约时间段
   • 支持点击时间段直接预约

优先级： P1（高）

---

4. 家长查看服务记录（签到签退） ❌

问题描述： 家长无法查看陪伴员的签到签退记录

当前状态：

• ✅ 陪伴员端有签到功能：teacher-package/pages/teacher/checkin.vue
• ✅ 陪伴员端有签退功能：teacher-package/pages/teacher/checkout.vue
• ✅ 管理师端可以查看签到记录：manager-package/pages/manager/check-records.vue
• ❌ 家长端无法查看签到签退记录
• ❌ 家长不知道陪伴员实际服务时长

影响：

• 家长无法确认陪伴员是否按时到达
• 无法核对实际服务时长
• 可能产生服务纠纷

需要实现：

1. 家长端： 添加服务记录页面

   • 新建文件：user-package/pages/service/records.vue
   • 功能：显示每次服务的签到签退时间、服务时长

2. 后端API：

   • GET /api/checkin/parent/records - 获取服务记录
   • 参数：{ studentId, page, size }
   • 返回：签到签退记录列表

3. UI设计：

   • 按订单分组显示
   • 显示签到时间、签退时间、服务时长
   • 显示签到位置（可选）

优先级： P1（高）

---

5. 家长查看陪伴员位置（服务中） ❌

问题描述： 服务进行中时，家长无法查看陪伴员位置

当前状态：

• ✅ 陪伴员签到时记录位置
• ❌ 家长端无法查看陪伴员实时位置
• ❌ 无法确认陪伴员是否在服务地点

影响：

• 家长无法确认陪伴员是否到达
• 无法追踪服务进度
• 安全性考虑不足

需要实现：

1. 家长端： 在订单详情页添加位置查看

   • 文件：order-package/pages/order/detail.vue
   • 功能：服务进行中时显示陪伴员位置

2. 后端API：

   • GET /api/order/{orderId}/location - 获取陪伴员位置
   • 返回：经纬度、地址、更新时间

3. 隐私保护：

   • 仅在服务进行中（签到后、签退前）可查看
   • 服务结束后不再显示位置

优先级： P2（中）

---

6. 家长端消息通知未完善 ❌

问题描述： 家长端消息中心功能不完整

当前状态：

• ✅ 有消息中心页面：user-package/pages/message/center.vue
• ❌ 消息类型不完整
• ❌ 缺少消息推送机制
• ❌ 未读消息提示不明显

影响：

• 家长错过重要通知
• 无法及时响应订单变更
• 用户体验差

需要实现：

1. 消息类型完善：

   • 订单通知（接单、取消、完成）
   • 成长记录通知（陪伴员提交反馈）
   • 评价通知（陪伴员回复评价）
   • 系统通知（优惠券、活动）

2. 消息推送：

   • 后端推送消息到消息中心
   • 前端轮询获取未读消息数
   • 首页显示未读消息红点

3. 消息跳转：

   • 点击消息跳转到对应页面
   • 已实现部分跳转逻辑，需完善

优先级： P0（最高）

---

7. 家长查看陪伴员培训和考核记录 ❌

问题描述： 家长无法查看陪伴员的专业资质

当前状态：

• ✅ 陪伴员端有培训功能：teacher-package/pages/teacher/training.vue
• ✅ 陪伴员端有考核功能：teacher-package/pages/exam/test.vue
• ✅ 陪伴员端有等级系统：teacher-package/pages/level/index.vue
• ❌ 家长端无法查看陪伴员培训记录
• ❌ 家长端无法查看陪伴员考核成绩
• ❌ 家长端无法查看陪伴员等级

影响：

• 家长无法评估陪伴员专业能力
• 选择陪伴员时缺少参考依据
• 降低家长信任度

需要实现：

1. 家长端： 在陪伴员详情页添加资质展示

   • 文件：user-package/pages/teacher/detail.vue
   • 功能：显示陪伴员等级、培训记录、考核成绩

2. 后端API：

   • GET /api/teacher/{teacherId}/qualifications - 获取陪伴员资质
   • 返回：等级、培训课程、考核成绩、证书

3. UI设计：

   • 显示陪伴员等级徽章
   • 列出已完成的培训课程
   • 显示考核通过率
   • 展示获得的证书

优先级： P2（中）

---

8. 家长端课程学习记录未关联订单 ❌

问题描述： 课程学习记录与订单服务未关联

当前状态：

• ✅ 家长端有学习记录：user-package/pages/user/learning-record.vue
• ✅ 家长端有我的课程：user-package/pages/course/my-courses.vue
• ❌ 学习记录未关联具体订单
• ❌ 无法查看某次服务中学习了哪些课程

影响：

• 无法追踪学习进度与服务的关系
• 无法评估陪伴员的教学效果
• 数据孤立，缺少关联分析

需要实现：

1. 数据关联：

   • 学习记录表添加 orderId 字段
   • 关联订单和学习记录

2. 家长端： 在订单详情页显示学习记录

   • 文件：order-package/pages/order/detail.vue
   • 功能：显示该订单相关的学习记录

3. 后端API：

   • GET /api/learning/record/by-order/{orderId} - 获取订单相关学习记录

优先级： P2（中）

---

9. 家长端无法查看陪伴员的服务统计 ❌

问题描述： 家长无法查看陪伴员的历史服务数据

当前状态：

• ✅ 陪伴员端有收益统计：teacher-package/pages/teacher/earnings.vue
• ❌ 家长端无法查看陪伴员服务次数
• ❌ 家长端无法查看陪伴员好评率
• ❌ 家长端无法查看陪伴员服务时长

影响：

• 家长选择陪伴员时缺少数据支持
• 无法判断陪伴员经验是否丰富
• 降低选择准确性

需要实现：

1. 家长端： 在陪伴员详情页添加服务统计

   • 文件：user-package/pages/teacher/detail.vue
   • 功能：显示服务次数、好评率、服务时长、学生数量

2. 后端API：

   • GET /api/teacher/{teacherId}/statistics - 获取陪伴员统计数据
   • 返回：服务次数、好评率、总服务时长、服务学生数

3. UI设计：

   • 数据卡片展示
   • 图表可视化（可选）
   • 与其他陪伴员对比（可选）

优先级： P2（中）

---

10. 管理师端工单处理结果未通知家长 ❌

问题描述： 管理师处理工单后，家长未收到通知

当前状态：

• ✅ 管理师端有工单管理：manager-package/pages/manager/work-orders.vue
• ✅ 管理师端有工单详情：manager-package/pages/manager/work-order-detail.vue
• ✅ 管理师端有派单功能：manager-package/pages/manager/assign.vue
• ❌ 管理师处理工单后，家长未收到通知
• ❌ 家长不知道工单处理进度

影响：

• 家长不知道问题是否解决
• 需要主动询问处理结果
• 用户体验差

需要实现：

1. 消息通知：

   • 管理师派单 → 通知家长
   • 工单状态变更 → 通知家长
   • 工单完成 → 通知家长

2. 家长端： 添加工单查看功能

   • 新建文件：user-package/pages/order/work-order-status.vue
   • 功能：查看工单处理进度和结果

3. 后端API：

   • GET /api/work-order/parent/list - 获取我的工单
   • GET /api/work-order/parent/{id} - 获取工单详情

优先级： P1（高）

---

11. 分销员推广订单未关联家长 ❌

问题描述： 通过分销员推广的订单，家长端无法查看推广信息

当前状态：

• ✅ 分销员端有推广功能：distributor-package/pages/distributor/
• ✅ 分销员端有推广码：distributor-package/pages/distributor/promotion-code.vue
• ✅ 分销员端有成交记录：distributor-package/pages/distributor/order-list.vue
• ❌ 家长端订单未显示推广来源
• ❌ 家长不知道是通过哪个分销员注册的

影响：

• 无法追踪推广效果
• 家长无法联系推荐人
• 分销关系不透明

需要实现：

1. 数据关联：

   • 订单表添加 distributorId 字段
   • 用户表添加 referrerId 字段

2. 家长端： 在订单详情页显示推广信息

   • 文件：order-package/pages/order/detail.vue
   • 功能：显示推荐人信息（如果有）

3. 后端API：

   • 注册时记录推广来源
   • 下单时关联分销员

优先级： P3（低）

---

12. 服务商发布的课程未在家长端展示 ❌

问题描述： 服务商发布的专项课程，家长端无法查看

当前状态：

• ✅ 服务商端有课程管理：provider-package/pages/provider/course-manage.vue
• ✅ 服务商端有课程发布：provider-package/pages/provider/course-publish.vue
• ✅ 服务商端有专项课程：provider-package/pages/provider/special-course-list.vue
• ❌ 家长端课程列表未包含服务商课程
• ❌ 家长无法预约服务商课程

影响：

• 服务商课程无法触达家长
• 课程资源浪费
• 服务商收益受影响

需要实现：

1. 家长端： 在课程列表中展示服务商课程

   • 文件：pages/course/list.vue
   • 功能：显示所有可用课程（包括服务商课程）

2. 后端API：

   • GET /api/course/list - 获取所有课程（包括服务商课程）
   • 添加课程来源标识

3. UI设计：

   • 标记课程来源（平台/服务商）
   • 显示服务商信息
   • 支持筛选课程来源

优先级： P2（中）

---

📊 优先级汇总

P0（最高优先级）- 立即实现

1. ✅ 订单状态实时同步
2. ✅ 家长端消息通知完善

P1（高优先级）- 近期实现

3. ✅ 陪伴员回复评价功能
4. ✅ 家长查看陪伴员排班
5. ✅ 家长查看服务记录（签到签退）
6. ✅ 管理师端工单处理结果通知家长

P2（中优先级）- 中期实现

7. ✅ 家长查看陪伴员位置（服务中）
8. ✅ 家长查看陪伴员培训和考核记录
9. ✅ 家长端课程学习记录关联订单
10. ✅ 家长端查看陪伴员服务统计
11. ✅ 服务商课程在家长端展示

P3（低优先级）- 长期优化

12. ✅ 分销员推广订单关联家长

---

🎯 实施建议

第一阶段（本周）- P0功能

1. 订单状态实时同步

   • 实现消息推送机制
   • 前端添加轮询逻辑
   • 测试订单状态变更通知

2. 消息通知完善

   • 完善消息类型
   • 实现消息推送
   • 添加未读消息提示

第二阶段（下周）- P1功能

1. 陪伴员回复评价

   • 陪伴员端添加回复功能
   • 后端实现回复API
   • 家长端显示回复内容

2. 家长查看陪伴员排班

   • 家长端添加排班查看页面
   • 后端提供排班查询API
   • 预约时显示可用时间

3. 家长查看服务记录

   • 家长端添加服务记录页面
   • 后端提供签到签退记录API
   • 显示服务时长统计

4. 工单处理结果通知

   • 管理师处理工单时发送通知
   • 家长端添加工单查看功能
   • 实现工单状态追踪

第三阶段（下下周）- P2功能

按优先级逐步实现P2功能

---

📝 总结

已关联功能：3个 ✅

• 成长记录功能
• 服务反馈功能
• 评价功能

未关联功能：12个 ❌

• P0：2个（最高优先级）
• P1：4个（高优先级）
• P2：5个（中优先级）
• P3：1个（低优先级）

核心问题

1. 消息通知机制不完善 - 导致信息不对称
2. 数据展示不完整 - 家长无法全面了解服务情况
3. 功能闭环不完整 - 部分业务流程无法形成闭环

建议

优先实现P0和P1功能，确保核心业务流程的数据流通和逻辑闭环。P2和P3功能可以根据用户反馈和业务需求逐步实现。

---

报告生成时间： 2026-01-25
检查人员： Kiro AI
下一步行动： 按优先级实施功能开发