xiaoli/peixue-dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
58df75a39f
peixue-dev/Archive/peidu-temp-files/docs/[一次性]家长端未关联功能完整分析-2026-01-23.md

13 KiB
Raw Blame History

家长端未关联功能完整分析报告

检查时间: 2026-01-23
检查人: AI助手
检查范围: 家长端与其他端（陪伴员、管理师、服务商、分销员）的所有功能关联情况

📊 执行摘要

本报告基于代码深度检查，全面分析家长端与其他端的功能关联情况。

核心统计

  • ✅ 已完整实现: 5项
  • ⚠️ 部分实现: 4项
  • ❌ 未实现: 6项

✅ 一、已完整实现的功能 (5项)

1.1 推广码注册（家长 ↔ 分销员）✅

功能描述: 家长注册时填写推广码，建立与分销员的推广关系

实现情况:

  • ✅ 前端: 注册页面有推广码输入框
  • ✅ 后端: AuthController.register() 保存推广关系
  • ✅ 数据表: user.referred_by_code 字段

数据流:

家长注册 → 填写推广码 → user.referred_by_code = 分销员推广码

1.2 订单佣金生成（家长 ↔ 分销员）✅

功能描述: 家长购买课程后，分销员自动获得佣金

实现情况:

  • ✅ 后端: 订单支付后自动创建 distributor_order 记录
  • ✅ 后端: 自动计算佣金
  • ✅ 数据表: distributor_order 表

数据流:

家长下单 → 订单支付 → 检查推广关系 → 创建分销订单 → 计算佣金

1.3 订单创建和支付（家长 ↔ 管理师）✅

功能描述: 家长创建订单后，管理师可以查看并派单

实现情况:

  • ✅ 前端: 订单创建页面
  • ✅ 后端: OrderController.create() 和 OrderController.pay()
  • ✅ 管理师端: 工单管理页面可查看订单

数据流:

家长下单 → 订单创建 → 管理师查看待派单列表 → 管理师派单

1.4 日历展示（家长端）✅

功能描述: 家长查看服务日程安排

实现情况:

  • ✅ 前端: user-package/pages/calendar/index.vue
  • ✅ 后端: CalendarController 提供日程接口
  • ✅ 功能: 日历展示、统计信息、日程查看

页面位置: user-package/pages/calendar/index.vue

1.5 聊天功能（基础实现）✅

功能描述: 家长与陪伴员/管理师聊天

实现情况:

  • ✅ 前端: pages/message/chat.vue
  • ✅ 后端: ChatController 提供聊天接口
  • ✅ 功能: 发送消息、查看历史记录

页面位置: pages/message/chat.vue

注意: 虽然聊天功能已实现，但在订单详情等页面缺少"联系陪伴员"的入口

⚠️ 二、部分实现的功能 (4项)

2.1 查看陪伴员信息 ⚠️

功能描述: 家长查看陪伴员列表、详情、评价

实现情况:

  • ✅ 前端: pages/teacher/list.vue - 陪伴员列表
  • ✅ 前端: pages/teacher/detail.vue - 陪伴员详情
  • ⚠️ 后端接口可能未完整实现

缺失部分:

  • ❓ 后端是否有 TeacherController 提供陪伴员列表接口？
  • ❓ 陪伴员列表是否支持按职位筛选（测评师、规划师、辅导老师）？
  • ❓ 陪伴员详情是否包含完整信息（经验、评分、服务次数）？

优先级: 🟡 中

2.2 服务反馈查看 ⚠️

功能描述: 家长查看陪伴员提交的服务反馈

实现情况:

  • ✅ 前端: user-package/pages/feedback/list.vue - 反馈列表页面
  • ✅ 后端: FeedbackController 提供反馈接口
  • ❌ 但这是"意见反馈"，不是"服务反馈"

问题分析:

  1. FeedbackController 提供的是"意见反馈"功能（用户对平台的反馈）
  2. 缺少专门的"服务反馈"接口（陪伴员提交的每日服务总结）
  3. 需要区分"意见反馈"和"服务反馈"

需要实现:

  • 创建 ServiceFeedbackController
  • 创建 service_feedback 表
  • 实现家长端查看服务反馈页面

优先级: 🔴 高

2.3 成长记录查看 ⚠️

功能描述: 家长查看孩子的成长记录（每日/周/月反馈）

实现情况:

  • ✅ 后端: GrowthRecordController 提供成长记录接口
  • ✅ 前端: activity-package/pages/growth/record-list.vue 存在
  • ⚠️ 但可能未完整实现家长端查看功能

需要检查:

  • 家长端是否能访问成长记录页面？
  • 成长记录页面是否支持按学生筛选？
  • 成长记录页面是否显示完整信息（每日/周/月反馈）？

优先级: 🟡 中

2.4 学习记录查看 ⚠️

功能描述: 家长查看学习记录

实现情况:

  • ✅ 前端: user-package/pages/user/learning-record.vue
  • ✅ 显示: 学习时长、平均评分、学习记录列表
  • ✅ 包含: 老师评价、评分

页面位置: user-package/pages/user/learning-record.vue

注意: 这个功能已实现，但需要确认数据来源是否正确

优先级: 🟢 低（已基本实现）

❌ 三、未实现的功能 (6项)

3.1 查看服务记录（打卡照片、服务时长）❌

功能描述: 家长在订单详情中查看陪伴员的打卡记录

当前状态:

  • ✅ 后端: CheckInController 已实现打卡接口
  • ✅ 数据表: check_in_record 表已存在
  • ❌ 订单详情页面未显示打卡记录
  • ❌ 订单详情页面未显示打卡照片

需要实现:

  1. 后端: 订单详情接口返回打卡记录
  2. 前端: 订单详情页面添加"服务记录"区域
  3. 前端: 显示签到/签退照片、时间、地点、服务时长

详细方案: 见 家长端服务记录功能检查补充-2026-01-23.md

优先级: 🔴 高

3.2 评价陪伴员服务 ❌

功能描述: 家长评价服务后，陪伴员可以查看评价

当前状态:

  • ✅ 后端: ReviewController 已实现评价接口
  • ❌ 订单详情页面未显示"评价"按钮
  • ❌ 未实现评价表单页面

需要实现:

  1. 前端: 订单详情页面添加"评价"按钮（订单完成后显示）
  2. 前端: 创建评价页面
    • 多维度评分（服务态度、专业能力、效果）
    • 评价内容输入
    • 评价标签选择
  3. 前端: 陪伴员端添加查看和回复评价功能

优先级: 🔴 高

3.3 选择指定陪伴员 ❌

功能描述: 家长预约服务时，可以选择指定的陪伴员

当前状态:

  • ✅ 前端: pages/teacher/list.vue 陪伴员列表已存在
  • ❌ 预约页面未实现选择陪伴员功能
  • ❌ 订单表可能缺少 preferred_teacher_id 字段

需要实现:

  1. 前端: 在预约页面添加"选择陪伴员"功能
  2. 后端: 修改订单创建接口，支持指定陪伴员
  3. 数据库: 添加 preferred_teacher_id 字段
  4. 后端: 管理师派单时优先使用家长指定的陪伴员

优先级: 🟡 中

3.4 联系陪伴员入口 ❌

功能描述: 在订单详情页面添加"联系陪伴员"按钮

当前状态:

  • ✅ 聊天功能已实现 (pages/message/chat.vue)
  • ❌ 订单详情页面未实现"联系陪伴员"按钮

需要实现:

  1. 前端: 在订单详情页面添加"联系陪伴员"按钮 
    contactTeacher() {
  uni.navigateTo({
    url: `/pages/message/chat?userId=${this.order.teacherId}&userName=${this.order.teacherName}`
  })
}

优先级: 🟡 中

3.5 联系客服功能 ❌

功能描述: 家长遇到问题，联系管理师咨询

当前状态:

  • ✅ 聊天功能已实现
  • ❌ 缺少"联系客服"入口
  • ❌ 缺少客服分配逻辑

需要实现:

  1. 前端: 在个人中心添加"联系客服"入口
  2. 前端: 点击后跳转到聊天页面，自动创建与客服的会话
  3. 后端: 实现客服分配逻辑

优先级: 🟡 中

3.6 查看课程评价 ❌

功能描述: 家长查看课程的评价，服务商可以看到评价

当前状态:

  • ✅ 后端: ReviewController 已实现评价接口
  • ⚠️ 前端部分实现（只在课程详情页显示）
  • ❌ 服务商端未实现查看评价功能

需要实现:

  1. 后端: 区分"陪伴员评价"和"课程评价"
  2. 前端: 课程详情页显示课程评价列表
  3. 前端: 服务商端添加查看课程评价功能

优先级: 🟢 低

📋 四、功能关联矩阵

功能 家长端 陪伴员端 管理师端 服务商端 分销员端 状态
推广码注册 ✅ - - - ✅ ✅ 已实现
订单佣金 ✅ - - - ✅ ✅ 已实现
订单创建 ✅ - ✅ - - ✅ 已实现
日历展示 ✅ ✅ ✅ - - ✅ 已实现
聊天功能 ✅ ✅ ✅ - - ✅ 已实现
查看陪伴员 ⚠️ - - - - ⚠️ 部分实现
服务反馈 ⚠️ ✅ ✅ - - ⚠️ 部分实现
成长记录 ⚠️ ✅ ✅ - - ⚠️ 部分实现
学习记录 ⚠️ ✅ - - - ⚠️ 部分实现
服务记录 ❌ ✅ ✅ - - ❌ 未实现
评价服务 ❌ ⚠️ - - - ❌ 未实现
选择陪伴员 ❌ - ⚠️ - - ❌ 未实现
联系陪伴员 ❌ - - - - ❌ 未实现
联系客服 ❌ - ⚠️ - - ❌ 未实现
课程评价 ❌ - - ❌ - ❌ 未实现

🎯 五、优先级排序

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

  1. 查看服务记录（打卡照片、服务时长）

    • 影响: 家长无法了解服务进度和质量
    • 工作量: 中（后端+前端）
    • 预计时间: 2-3天

  2. 服务反馈查看（陪伴员提交的每日反馈）

    • 影响: 家长无法了解孩子的学习情况
    • 工作量: 中（后端+前端）
    • 预计时间: 2-3天

  3. 评价陪伴员服务

    • 影响: 无法收集用户反馈，影响服务质量提升
    • 工作量: 小（前端为主）
    • 预计时间: 1-2天

🟡 中优先级（增强功能，建议实现）

  1. 查看陪伴员信息

    • 影响: 家长无法了解陪伴员资质
    • 工作量: 小（检查和完善）
    • 预计时间: 1天

  2. 成长记录查看

    • 影响: 家长无法查看孩子的成长轨迹
    • 工作量: 小（检查和完善）
    • 预计时间: 1天

  3. 选择指定陪伴员

    • 影响: 无法选择信任的陪伴员
    • 工作量: 中（前后端）
    • 预计时间: 2-3天

  4. 联系陪伴员入口

    • 影响: 沟通不便
    • 工作量: 小（前端）
    • 预计时间: 0.5天

  5. 联系客服功能

    • 影响: 问题无法及时解决
    • 工作量: 中（前后端）
    • 预计时间: 2-3天

🟢 低优先级（扩展功能，可暂缓实现）

  1. 查看课程评价
    • 影响: 无法了解课程质量
    • 工作量: 小（前端为主）
    • 预计时间: 1-2天

📅 六、实施计划

第一阶段（立即实施）- 1-2周

目标: 完善核心功能，提升用户体验

任务清单:

  1. 查看服务记录（打卡照片、服务时长）
  2. 服务反馈查看（陪伴员提交的每日反馈）
  3. 评价陪伴员服务

预计工作量: 5-8天

第二阶段（后续实施）- 2-3周

目标: 增强沟通功能，完善用户体验

任务清单:

  1. 查看陪伴员信息（检查和完善）
  2. 成长记录查看（检查和完善）
  3. 选择指定陪伴员
  4. 联系陪伴员入口
  5. 联系客服功能

预计工作量: 7-11天

第三阶段（可选实施）- 1周

目标: 完善辅助功能

任务清单:

  1. 查看课程评价

预计工作量: 1-2天

📊 七、总结

已完整实现 ✅ (5项)

  1. ✅ 推广码注册（家长 ↔ 分销员）
  2. ✅ 订单佣金生成（家长 ↔ 分销员）
  3. ✅ 订单创建和支付（家长 ↔ 管理师）
  4. ✅ 日历展示（家长端）
  5. ✅ 聊天功能（基础实现）

部分实现 ⚠️ (4项)

  1. ⚠️ 查看陪伴员信息
  2. ⚠️ 服务反馈查看
  3. ⚠️ 成长记录查看
  4. ⚠️ 学习记录查看

未实现 ❌ (6项)

高优先级 (3项)

  1. ❌ 查看服务记录（打卡照片、服务时长）
  2. ❌ 服务反馈查看（陪伴员提交的每日反馈）
  3. ❌ 评价陪伴员服务

中优先级 (4项)

  1. ❌ 选择指定陪伴员
  2. ❌ 联系陪伴员入口
  3. ❌ 联系客服功能

低优先级 (1项)

  1. ❌ 查看课程评价

🔍 八、关键发现

  1. 聊天功能已实现，但缺少入口

    • 聊天页面 pages/message/chat.vue 已完整实现
    • 但在订单详情、个人中心等页面缺少"联系陪伴员"、"联系客服"的入口

  2. 服务反馈功能混淆

    • 现有的 FeedbackController 是"意见反馈"（用户对平台的反馈）
    • 缺少"服务反馈"（陪伴员提交的每日服务总结）
    • 需要创建专门的 ServiceFeedbackController

  3. 订单详情页面功能不完整

    • 缺少服务记录展示
    • 缺少服务反馈展示
    • 缺少评价功能入口
    • 缺少联系陪伴员入口

  4. 数据表需要完善

    • check_in_record 表可能缺少 order_id 字段
    • 需要创建 service_feedback 表
    • order 表可能缺少 preferred_teacher_id 字段

报告完成时间: 2026-01-23
检查人: AI助手
下一步行动: 根据优先级逐步实现未关联的功能