10 KiB
10 KiB
家长端未关联功能深度检查报告
检查日期： 2026-01-23
检查范围： 家长端与其他端（陪伴员端、管理师端）需要关联但目前未关联的功能
一、核心功能缺失
1. ❌ 服务评价功能（完全缺失）
现状：
- 需求文档明确要求家长可以对服务进行评价
- 评价维度：服务态度、教学质量、准时性（1-5星）
- 订单详情页有"已完成"状态，但没有"去评价"按钮
- 没有找到家长端的评价提交页面
需要实现：
- 订单详情页：已完成订单显示"去评价"按钮
- 评价提交页面：
- 服务态度评分（1-5星）
- 教学质量评分（1-5星）
- 准时性评分（1-5星）
- 综合评分（自动计算平均分）
- 评价内容（文本域，最多200字）
- 评价图片（最多9张）
- 是否匿名（复选框）
- 我的评价页面：查看历史评价记录
- 数据关联：
- 评价数据关联到陪伴员的评价列表
- 陪伴员端可以查看和回复评价
- 评价影响陪伴员的综合评分和排名
涉及文件：
- 前端：
/user-package/pages/review/submit.vue（需创建） - 前端：
/user-package/pages/review/list.vue（需创建） - 后端：
ReviewController.java、ReviewService.java - 数据库：
review表
2. ⚠️ 成长记录详情查看（部分实现，需完善）
现状：
- 家长端有"服务反馈"列表页（
/user-package/pages/feedback/list.vue） - 可以看到陪伴员提交的每日反馈内容、照片、视频
- 但缺少详细的成长记录查看功能
陪伴员端已有功能：
- 每日反馈（包含服务内容、学生表现、照片、视频）
- 周反馈汇总
- 月反馈汇总
- 成长轨迹记录
需要完善：
- 每日反馈详情页：
- 服务日期、时长
- 服务内容
- 学生表现
- 陪伴员评价
- 照片、视频记录
- 签到签退信息
- 周反馈查看：
- 本周服务汇总
- 学习进步情况
- 需要改进的地方
- 月反馈查看：
- 本月服务汇总
- 学习成果展示
- 成长轨迹分析
- 成长档案：
- 学生的完整成长记录
- 按时间线展示
- 支持筛选和搜索
涉及文件：
- 前端：
/user-package/pages/feedback/list.vue（已有，需完善） - 前端：
/user-package/pages/feedback/detail.vue（需创建） - 前端：
/user-package/pages/growth/weekly.vue（需创建） - 前端：
/user-package/pages/growth/monthly.vue（需创建） - 后端：
GrowthRecordController.java（已有，需添加家长端查询接口）
3. ⚠️ 订单核销码二维码展示（只有文字，缺少二维码）
现状：
- 订单详情页有核销码字段（
verifyCode） - 只是文字显示，没有二维码展示
- 陪伴员需要扫码核销
需要实现：
- 订单详情页：
- 大号二维码展示（方便陪伴员扫码）
- 核销码数字显示（12位）
- 二维码下方显示"请向陪伴员出示此码"
- 核销状态实时更新：
- 陪伴员扫码后，家长端订单状态实时更新
- 显示核销时间和陪伴员信息
- 核销记录：
- 显示核销时间
- 显示核销地点（如果有GPS信息）
涉及文件：
- 前端：
/order-package/pages/order/detail.vue（需修改） - 需要引入二维码生成库（如
uQRCode）
4. ❌ 服务提醒功能（完全缺失）
现状：
- 管理师端有提醒管理功能
- 陪伴员端有提醒查看功能
- 家长端没有服务提醒功能
需要实现：
- 我的提醒页面：
- 显示所有服务提醒
- 提醒类型：服务开始前提醒、服务完成提醒、评价提醒等
- 提醒状态：未读/已读
- 提醒内容：
- 服务时间
- 陪伴员信息
- 服务地址
- 学生信息
- 提醒方式：
- 小程序消息通知
- 短信通知（重要提醒）
- 站内消息
- 提醒设置：
- 提前多久提醒（30分钟、1小时、2小时）
- 是否接收短信提醒
涉及文件：
- 前端：
/user-package/pages/reminder/list.vue（需创建） - 前端：
/user-package/pages/reminder/settings.vue（需创建） - 后端：
ReminderController.java（已有，需添加家长端接口）
5. ❌ 消息通知中心（完全缺失）
现状：
- 没有找到家长端的消息中心页面
- 管理师端有消息中心（
/manager-package/pages/manager/message-center.vue）
需要实现：
- 消息中心页面：
- 系统通知（订单状态变更、活动通知等）
- 陪伴员消息（反馈提交、评价回复等）
- 平台公告
- 消息分类：
- 订单消息
- 服务消息
- 系统消息
- 活动消息
- 消息状态：
- 未读/已读标记
- 未读消息数量角标
- 消息操作：
- 标记已读
- 删除消息
- 跳转到相关页面
涉及文件：
- 前端：
/user-package/pages/message/center.vue（需创建） - 后端：
MessageController.java（需创建） - 数据库：
message表
二、功能不完整
6. ⚠️ 学习记录功能不完整
现状：
- 有学习记录列表页（
/user-package/pages/user/learning-record.vue） - 有学习记录详情页（
/user-package/pages/user/learning-record-detail.vue） - 但数据来源不明确，与陪伴员填写的成长记录关联不清晰
需要完善：
- 数据来源明确：
- 学习记录应该来自陪伴员填写的成长记录
- 每次服务完成后自动生成学习记录
- 学习记录内容：
- 服务时间、时长
- 学习科目
- 学习内容
- 陪伴员评价
- 学生表现
- 照片记录
- 学习统计：
- 总服务次数
- 总服务时长
- 学习科目分布
- 学习进步趋势
涉及文件：
- 前端：
/user-package/pages/user/learning-record.vue（需完善） - 后端：需要将成长记录数据映射到学习记录
7. ⚠️ 课时管理/套餐使用记录
现状：
- 有"我的套餐"页面（
/user-package/pages/user/package.vue） - 有套餐使用记录页面（
/user-package/pages/package/usage-list.vue） - 但与订单的关联不清晰
需要完善：
- 套餐详情页：
- 套餐名称、类型
- 总课时、已用课时、剩余课时
- 有效期
- 使用记录
- 课时扣减规则：
- 每次服务完成后自动扣减课时
- 扣减记录关联到具体订单
- 显示扣减时间、扣减课时、剩余课时
- 课时预警：
- 课时不足提醒（剩余课时<3）
- 套餐即将过期提醒（有效期<7天）
- 套餐续费：
- 套餐到期后可以续费
- 显示续费优惠
涉及文件：
- 前端：
/user-package/pages/package/usage-list.vue（已有，需完善） - 后端：
PackageUsageController.java（已有） - 数据库：
package_usage表（已有）
8. ⚠️ 订单取消和退款流程
现状：
- 订单详情页有"取消订单"按钮
- 但取消规则和退款流程不完整
需要完善：
- 取消规则明确：
- 服务前24小时：全额退款
- 服务前12-24小时：退款80%
- 服务前12小时内：不可取消
- 取消原因选择：
- 时间冲突
- 陪伴员不合适
- 其他原因（需填写）
- 退款流程：
- 提交取消申请
- 管理师审核
- 退款到账（1-3个工作日）
- 退款记录：
- 查看退款状态
- 查看退款金额
- 查看退款时间
涉及文件：
- 前端：
/order-package/pages/order/cancel.vue（需创建） - 前端：
/user-package/pages/refund/list.vue（需创建） - 后端：
RefundController.java（需创建）
9. ⚠️ 服务地址管理
现状：
- 有地址管理页面（
/user-package/pages/address/list.vue） - 下单时需要填写服务地址
- 但地址与订单的关联不够紧密
需要完善：
- 下单时选择地址：
- 显示已保存的地址列表
- 可以选择默认地址
- 可以新增地址
- 地址详情：
- 联系人、电话
- 详细地址
- 地址标签（家、公司、学校等）
- 是否默认地址
- 地图导航：
- 陪伴员可以查看服务地址
- 支持地图导航功能
- 显示距离和预计到达时间
涉及文件：
- 前端：
/user-package/pages/address/list.vue（已有） - 前端：
/order-package/pages/order/create.vue（需完善地址选择）
三、优先级排序
🔴 高优先级（核心功能，必须实现）
- 服务评价功能 - 完整的评价闭环
- 订单核销码二维码展示 - 核销流程必需
- 成长记录详情查看 - 家长核心诉求
🟡 中优先级（重要功能，建议实现）
- 服务提醒功能 - 提升用户体验
- 消息通知中心 - 信息传达必需
- 订单取消和退款流程 - 完善订单流程
🟢 低优先级（优化功能，可后续实现）
- 学习记录功能完善 - 数据展示优化
- 课时管理完善 - 套餐管理优化
- 服务地址管理完善 - 地址选择优化
四、实施建议
第一阶段（核心功能）
- 实现服务评价功能（评价提交、评价列表、评价详情）
- 实现订单核销码二维码展示
- 完善成长记录详情查看（每日反馈、周反馈、月反馈）
第二阶段（重要功能）
- 实现服务提醒功能
- 实现消息通知中心
- 完善订单取消和退款流程
第三阶段（优化功能）
- 完善学习记录功能
- 完善课时管理功能
- 完善服务地址管理
五、技术要点
1. 数据同步
- 家长端、陪伴员端、管理师端的数据需要实时同步
- 使用 WebSocket 或轮询实现实时更新
2. 权限控制
- 家长只能查看自己的订单和学生的记录
- 陪伴员只能查看分配给自己的订单
- 管理师可以查看所有数据
3. 消息推送
- 使用小程序订阅消息
- 重要通知使用短信推送
- 站内消息作为补充
4. 图片处理
- 评价图片、反馈图片需要压缩上传
- 支持图片预览和下载
- 图片存储使用云存储
报告生成时间： 2026-01-23
检查人员： Kiro AI Assistant