305 lines
9.8 KiB
Markdown
305 lines
9.8 KiB
Markdown
# 陪伴员端数据关联检查报告
|
||
|
||
## 📋 检查时间
|
||
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. 测试验证
|
||
每个功能实现后，需要进行跨端测试，确保数据同步正确。
|
||
|
||
---
|
||
|
||
## 📝 备注
|
||
- 本报告基于当前代码结构分析
|
||
- 部分功能可能已实现但未在代码中明确体现
|
||
- 建议与产品经理确认具体需求后再进行开发
|