peixue-dev/Archive/[一次性]陪伴员端数据关联检查报告.md

陪伴员端数据关联检查报告

📋 检查时间

2026-01-26

🎯 检查目的

全面检查陪伴员端与其他端（管理师端、家长端）的数据关联情况，找出未关联或关联不完整的功能点。

---

一、陪伴员端核心功能模块

1. 订单管理模块

✅ 已实现的功能

• 获取可接订单列表 (/api/teacher/available-orders)
• 获取待接单列表 (/api/teacher/pending-orders)
• 接受订单 (/api/teacher/accept-order)
• 拒绝订单 (/api/teacher/reject-order)
• 获取我的订单列表 (/api/teacher/my-orders)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师派单 → 陪伴员收到待接单通知
  • ✅ 陪伴员接单/拒单 → 管理师收到通知
  • ✅ 订单状态同步显示

• 家长端：

  • ✅ 家长下单 → 陪伴员可见订单
  • ⚠️ 待确认：陪伴员接单后，家长是否能看到陪伴员信息？
  • ⚠️ 待确认：订单状态变更时，家长是否收到通知？

---

2. 打卡签到模块

✅ 已实现的功能

• 签到打卡 (前端页面：teacher/checkin.vue)
• 签退打卡 (前端页面：teacher/checkout.vue)
• 打卡记录查询 (/api/workorder/checkin)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可查看陪伴员打卡记录 (manager/check-records.vue)
  • ✅ 打卡时长统计显示在管理师端

• 家长端：

  • ❌ 缺失：家长端无法查看陪伴员的打卡记录
  • ❌ 缺失：家长端无法看到服务时长统计
  • 💡 建议：在家长端订单详情中显示陪伴员的签到/签退时间

---

3. 成长记录模块

✅ 已实现的功能

• 创建每日反馈 (/api/growth-record/daily)
• 查看每日反馈列表 (/api/growth-record/daily/list)
• 生成周反馈 (/api/growth-record/weekly/summary)
• 生成月反馈 (/api/growth-record/monthly/summary)
• 获取周数据汇总 (/api/growth-record/weekly/data)
• 获取月数据汇总 (/api/growth-record/monthly/data)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可查看所有成长记录 (manager/feedback.vue)
  • ✅ 管理师可查看成长记录详情 (manager/feedback-detail.vue)
  • ⚠️ 待确认：管理师是否能编辑或删除成长记录？

• 家长端：

  • ✅ 家长可查看成长记录列表 (user-package/pages/growth/list.vue)
  • ✅ 家长可查看成长记录详情 (user-package/pages/growth/detail.vue)
  • ✅ 陪伴员提交成长记录后，家长收到通知
  • ⚠️ 待确认：家长是否能对成长记录进行评论或反馈？

---

4. 日程管理模块

✅ 已实现的功能

• 获取我的日程 (/api/teacher/my-schedule)
• 获取日程统计 (/api/teacher/schedule-statistics)
• 日程日历视图 (前端页面：teacher/calendar.vue)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可查看陪伴员日程 (manager/calendar.vue)
  • ✅ 管理师派单时可查看陪伴员空闲时间

• 家长端：

  • ❌ 缺失：家长端无法查看陪伴员的日程安排
  • 💡 建议：在家长端显示"我的陪伴员本周日程"

---

5. 收益管理模块

✅ 已实现的功能

• 查看收益统计 (前端页面：teacher/earnings.vue)
• 提现申请 (前端页面：teacher/withdraw.vue)
• 提现记录 (前端页面：teacher/withdraw-records.vue)

🔗 与其他端的关联

• 管理师端：

  • ⚠️ 待确认：管理师是否能查看陪伴员的收益统计？
  • ⚠️ 待确认：管理师是否能审核陪伴员的提现申请？

• 家长端：

  • ✅ 无需关联（家长不需要看到陪伴员收益）

---

6. 评价管理模块

✅ 已实现的功能

• 查看我的评价列表 (前端页面：teacher/reviews.vue)
• 查看评价详情 (前端页面：teacher/review-detail.vue)
• 查看评价统计 (前端页面：teacher/review-statistics.vue)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可查看陪伴员的评价 (manager/teacher-reviews.vue)
  • ✅ 评价统计显示在陪伴员详情页

• 家长端：

  • ✅ 家长可以提交评价 (user-package/pages/review/submit.vue)
  • ✅ 家长可以查看评价列表 (user-package/pages/review/list.vue)
  • ⚠️ 待确认：家长提交评价后，陪伴员是否收到通知？

---

7. 学生管理模块

✅ 已实现的功能

• 查看我的学生列表 (前端页面：teacher/students.vue)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可查看所有学生信息

• 家长端：

  • ✅ 家长可管理自己的学生信息 (user-package/pages/student/)
  • ⚠️ 待确认：陪伴员是否能看到学生的详细信息（年龄、年级、特殊需求等）？

---

8. 培训考试模块

✅ 已实现的功能

• 培训视频学习 (前端页面：teacher/training.vue)
• 在线考试 (前端页面：teacher/exam-test.vue)
• 等级认证 (前端页面：teacher/level/index.vue)

🔗 与其他端的关联

• 管理师端：

  • ⚠️ 待确认：管理师是否能查看陪伴员的培训进度？
  • ⚠️ 待确认：管理师是否能查看陪伴员的考试成绩？

• 家长端：

  • ✅ 无需关联（家长不需要看到培训信息）

---

9. 提醒事项模块

✅ 已实现的功能

• 查看提醒事项 (前端页面：teacher/reminder/index.vue)

🔗 与其他端的关联

• 管理师端：

  • ✅ 管理师可创建提醒事项 (manager/reminder-edit.vue)
  • ✅ 管理师可查看提醒列表 (manager/reminders.vue)

• 家长端：

  • ❌ 缺失：家长端无提醒功能
  • 💡 建议：家长端可以创建提醒（如"记得带教材"）

---

二、关键数据流分析

1. 订单流程

家长下单 → 管理师派单 → 陪伴员接单 → 服务执行 → 完成订单 → 家长评价

数据关联检查

• ✅ 家长下单 → 订单创建
• ✅ 管理师派单 → 订单分配给陪伴员
• ✅ 陪伴员接单 → 订单状态更新
• ⚠️ 待确认：陪伴员拒单后，管理师是否收到通知？
• ⚠️ 待确认：订单完成后，家长是否自动收到评价提醒？

---

2. 服务流程

陪伴员签到 → 服务进行中 → 陪伴员签退 → 时长统计 → 收益结算

数据关联检查

• ✅ 签到/签退记录保存
• ✅ 时长自动计算
• ⚠️ 待确认：签到/签退时，家长是否收到通知？
• ⚠️ 待确认：服务时长是否自动同步到家长端？
• ❌ 缺失：收益结算逻辑未完全实现

---

3. 成长记录流程

陪伴员创建每日反馈 → 家长查看 → 周反馈汇总 → 月反馈汇总

数据关联检查

• ✅ 每日反馈创建
• ✅ 家长可查看
• ✅ 陪伴员提交后，家长收到通知
• ⚠️ 待确认：家长是否能对反馈进行回复或评论？
• ⚠️ 待确认：管理师是否能查看所有成长记录？

---

4. 评价流程

订单完成 → 家长提交评价 → 陪伴员查看评价 → 评价统计更新

数据关联检查

• ✅ 家长可提交评价
• ✅ 陪伴员可查看评价
• ⚠️ 待确认：陪伴员收到新评价时，是否有通知？
• ⚠️ 待确认：评价是否影响陪伴员的等级或推荐排序？

---

三、发现的问题汇总

❌ 缺失的功能

1. 家长端缺失

• 家长无法查看陪伴员的打卡记录
• 家长无法查看陪伴员的日程安排
• 家长无法对成长记录进行评论或反馈
• 家长无提醒事项功能

2. 管理师端缺失

• 管理师无法查看陪伴员的培训进度
• 管理师无法查看陪伴员的考试成绩
• 管理师无法审核陪伴员的提现申请（待确认）

3. 陪伴员端缺失

• 陪伴员无法查看学生的详细信息（待确认）
• 陪伴员无法回复家长的评价或反馈

---

⚠️ 待确认的功能

1. 通知机制

• 陪伴员拒单后，管理师是否收到通知？
• 签到/签退时，家长是否收到通知？
• 订单完成后，家长是否自动收到评价提醒？
• 陪伴员收到新评价时，是否有通知？

2. 权限控制

• 管理师是否能编辑或删除成长记录？
• 家长是否能对成长记录进行评论或反馈？
• 陪伴员是否能看到学生的详细信息？

3. 数据同步

• 服务时长是否自动同步到家长端？
• 评价是否影响陪伴员的等级或推荐排序？
• 收益结算逻辑是否完整？

---

四、优先级建议

🔴 高优先级（影响核心业务流程）

1. 家长端显示打卡记录：家长需要知道陪伴员的服务时间
2. 完善通知机制：确保各端及时收到关键操作的通知
3. 收益结算逻辑：确保陪伴员的收益计算准确

🟡 中优先级（提升用户体验）

4. 家长端显示陪伴员日程：让家长了解陪伴员的工作安排
5. 成长记录互动功能：家长可以对反馈进行评论
6. 陪伴员查看学生详情：帮助陪伴员更好地了解学生

🟢 低优先级（锦上添花）

7. 家长端提醒功能：方便家长创建服务提醒
8. 管理师查看培训进度：便于管理师监督陪伴员培训
9. 陪伴员回复评价：增强陪伴员与家长的互动

---

五、下一步行动建议

1. 确认需求

请确认以上"待确认"的功能点，明确业务需求。

2. 优先实现

根据优先级，先实现高优先级的功能。

3. 测试验证

每个功能实现后，需要进行跨端测试，确保数据同步正确。

---

📝 备注

• 本报告基于当前代码结构分析
• 部分功能可能已实现但未在代码中明确体现
• 建议与产品经理确认具体需求后再进行开发