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

# 家长端未关联功能深度检查报告

**检查日期：** 2026-01-23  
**检查范围：** 家长端与其他端（陪伴员端、管理师端）需要关联但目前未关联的功能

---

## 一、核心功能缺失

### 1. ❌ **服务评价功能**（完全缺失）

**现状：**
- 需求文档明确要求家长可以对服务进行评价
- 评价维度：服务态度、教学质量、准时性（1-5星）
- 订单详情页有"已完成"状态，但**没有"去评价"按钮**
- **没有找到家长端的评价提交页面**

**需要实现：**
1. **订单详情页**：已完成订单显示"去评价"按钮
2. **评价提交页面**：
   - 服务态度评分（1-5星）
   - 教学质量评分（1-5星）
   - 准时性评分（1-5星）
   - 综合评分（自动计算平均分）
   - 评价内容（文本域，最多200字）
   - 评价图片（最多9张）
   - 是否匿名（复选框）
3. **我的评价页面**：查看历史评价记录
4. **数据关联**：
   - 评价数据关联到陪伴员的评价列表
   - 陪伴员端可以查看和回复评价
   - 评价影响陪伴员的综合评分和排名

**涉及文件：**
- 前端：`/user-package/pages/review/submit.vue`（需创建）
- 前端：`/user-package/pages/review/list.vue`（需创建）
- 后端：`ReviewController.java`、`ReviewService.java`
- 数据库：`review` 表

---

### 2. ⚠️ **成长记录详情查看**（部分实现，需完善）

**现状：**
- 家长端有"服务反馈"列表页（`/user-package/pages/feedback/list.vue`）
- 可以看到陪伴员提交的每日反馈内容、照片、视频
- **但缺少详细的成长记录查看功能**

**陪伴员端已有功能：**
- 每日反馈（包含服务内容、学生表现、照片、视频）
- 周反馈汇总
- 月反馈汇总
- 成长轨迹记录

**需要完善：**
1. **每日反馈详情页**：
   - 服务日期、时长
   - 服务内容
   - 学生表现
   - 陪伴员评价
   - 照片、视频记录
   - 签到签退信息
2. **周反馈查看**：
   - 本周服务汇总
   - 学习进步情况
   - 需要改进的地方
3. **月反馈查看**：
   - 本月服务汇总
   - 学习成果展示
   - 成长轨迹分析
4. **成长档案**：
   - 学生的完整成长记录
   - 按时间线展示
   - 支持筛选和搜索

**涉及文件：**
- 前端：`/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`）
- **只是文字显示，没有二维码展示**
- 陪伴员需要扫码核销

**需要实现：**
1. **订单详情页**：
   - 大号二维码展示（方便陪伴员扫码）
   - 核销码数字显示（12位）
   - 二维码下方显示"请向陪伴员出示此码"
2. **核销状态实时更新**：
   - 陪伴员扫码后，家长端订单状态实时更新
   - 显示核销时间和陪伴员信息
3. **核销记录**：
   - 显示核销时间
   - 显示核销地点（如果有GPS信息）

**涉及文件：**
- 前端：`/order-package/pages/order/detail.vue`（需修改）
- 需要引入二维码生成库（如 `uQRCode`）

---

### 4. ❌ **服务提醒功能**（完全缺失）

**现状：**
- 管理师端有提醒管理功能
- 陪伴员端有提醒查看功能
- **家长端没有服务提醒功能**

**需要实现：**
1. **我的提醒页面**：
   - 显示所有服务提醒
   - 提醒类型：服务开始前提醒、服务完成提醒、评价提醒等
   - 提醒状态：未读/已读
2. **提醒内容**：
   - 服务时间
   - 陪伴员信息
   - 服务地址
   - 学生信息
3. **提醒方式**：
   - 小程序消息通知
   - 短信通知（重要提醒）
   - 站内消息
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`）

**需要实现：**
1. **消息中心页面**：
   - 系统通知（订单状态变更、活动通知等）
   - 陪伴员消息（反馈提交、评价回复等）
   - 平台公告
2. **消息分类**：
   - 订单消息
   - 服务消息
   - 系统消息
   - 活动消息
3. **消息状态**：
   - 未读/已读标记
   - 未读消息数量角标
4. **消息操作**：
   - 标记已读
   - 删除消息
   - 跳转到相关页面

**涉及文件：**
- 前端：`/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`）
- **但数据来源不明确，与陪伴员填写的成长记录关联不清晰**

**需要完善：**
1. **数据来源明确**：
   - 学习记录应该来自陪伴员填写的成长记录
   - 每次服务完成后自动生成学习记录
2. **学习记录内容**：
   - 服务时间、时长
   - 学习科目
   - 学习内容
   - 陪伴员评价
   - 学生表现
   - 照片记录
3. **学习统计**：
   - 总服务次数
   - 总服务时长
   - 学习科目分布
   - 学习进步趋势

**涉及文件：**
- 前端：`/user-package/pages/user/learning-record.vue`（需完善）
- 后端：需要将成长记录数据映射到学习记录

---

### 7. ⚠️ **课时管理/套餐使用记录**

**现状：**
- 有"我的套餐"页面（`/user-package/pages/user/package.vue`）
- 有套餐使用记录页面（`/user-package/pages/package/usage-list.vue`）
- **但与订单的关联不清晰**

**需要完善：**
1. **套餐详情页**：
   - 套餐名称、类型
   - 总课时、已用课时、剩余课时
   - 有效期
   - 使用记录
2. **课时扣减规则**：
   - 每次服务完成后自动扣减课时
   - 扣减记录关联到具体订单
   - 显示扣减时间、扣减课时、剩余课时
3. **课时预警**：
   - 课时不足提醒（剩余课时<3）
   - 套餐即将过期提醒（有效期<7天）
4. **套餐续费**：
   - 套餐到期后可以续费
   - 显示续费优惠

**涉及文件：**
- 前端：`/user-package/pages/package/usage-list.vue`（已有，需完善）
- 后端：`PackageUsageController.java`（已有）
- 数据库：`package_usage` 表（已有）

---

### 8. ⚠️ **订单取消和退款流程**

**现状：**
- 订单详情页有"取消订单"按钮
- **但取消规则和退款流程不完整**

**需要完善：**
1. **取消规则明确**：
   - 服务前24小时：全额退款
   - 服务前12-24小时：退款80%
   - 服务前12小时内：不可取消
2. **取消原因选择**：
   - 时间冲突
   - 陪伴员不合适
   - 其他原因（需填写）
3. **退款流程**：
   - 提交取消申请
   - 管理师审核
   - 退款到账（1-3个工作日）
4. **退款记录**：
   - 查看退款状态
   - 查看退款金额
   - 查看退款时间

**涉及文件：**
- 前端：`/order-package/pages/order/cancel.vue`（需创建）
- 前端：`/user-package/pages/refund/list.vue`（需创建）
- 后端：`RefundController.java`（需创建）

---

### 9. ⚠️ **服务地址管理**

**现状：**
- 有地址管理页面（`/user-package/pages/address/list.vue`）
- 下单时需要填写服务地址
- **但地址与订单的关联不够紧密**

**需要完善：**
1. **下单时选择地址**：
   - 显示已保存的地址列表
   - 可以选择默认地址
   - 可以新增地址
2. **地址详情**：
   - 联系人、电话
   - 详细地址
   - 地址标签（家、公司、学校等）
   - 是否默认地址
3. **地图导航**：
   - 陪伴员可以查看服务地址
   - 支持地图导航功能
   - 显示距离和预计到达时间

**涉及文件：**
- 前端：`/user-package/pages/address/list.vue`（已有）
- 前端：`/order-package/pages/order/create.vue`（需完善地址选择）

---

## 三、优先级排序

### 🔴 高优先级（核心功能，必须实现）

1. **服务评价功能** - 完整的评价闭环
2. **订单核销码二维码展示** - 核销流程必需
3. **成长记录详情查看** - 家长核心诉求

### 🟡 中优先级（重要功能，建议实现）

4. **服务提醒功能** - 提升用户体验
5. **消息通知中心** - 信息传达必需
6. **订单取消和退款流程** - 完善订单流程

### 🟢 低优先级（优化功能，可后续实现）

7. **学习记录功能完善** - 数据展示优化
8. **课时管理完善** - 套餐管理优化
9. **服务地址管理完善** - 地址选择优化

---

## 四、实施建议

### 第一阶段（核心功能）
1. 实现服务评价功能（评价提交、评价列表、评价详情）
2. 实现订单核销码二维码展示
3. 完善成长记录详情查看（每日反馈、周反馈、月反馈）

### 第二阶段（重要功能）
4. 实现服务提醒功能
5. 实现消息通知中心
6. 完善订单取消和退款流程

### 第三阶段（优化功能）
7. 完善学习记录功能
8. 完善课时管理功能
9. 完善服务地址管理

---

## 五、技术要点

### 1. 数据同步
- 家长端、陪伴员端、管理师端的数据需要实时同步
- 使用 WebSocket 或轮询实现实时更新

### 2. 权限控制
- 家长只能查看自己的订单和学生的记录
- 陪伴员只能查看分配给自己的订单
- 管理师可以查看所有数据

### 3. 消息推送
- 使用小程序订阅消息
- 重要通知使用短信推送
- 站内消息作为补充

### 4. 图片处理
- 评价图片、反馈图片需要压缩上传
- 支持图片预览和下载
- 图片存储使用云存储

---

**报告生成时间：** 2026-01-23  
**检查人员：** Kiro AI Assistant