xiaoli/peixue-dev

Fork 0

xiaojiang e5624c2876 feat: 快速派单功能分离 & 后端配置优化

2026-02-28 16:11:51 +08:00

5.8 KiB

Raw Permalink Blame History

家长端成长记录功能实现完成报告

📋 功能概述

家长端现在可以完整查看孩子的成长记录，包括：

✅ 每日反馈（陪伴员每天提交的服务反馈）
✅ 周反馈（每周汇总）
✅ 月反馈（每月汇总）
✅ 成长轨迹和进步情况

🎯 实现内容

1. 后端接口（已完成）

新增家长端专用接口

文件： peidu/backend/src/main/java/com/peidu/controller/GrowthRecordController.java

新增以下接口：

// 1. 获取成长记录列表（支持筛选）
GET /api/growth-record/parent/list
参数：
- studentId: 学生ID（必填）
- recordType: 记录类型（可选：daily/weekly/monthly）
- startDate: 开始日期（可选）
- endDate: 结束日期（可选）
- page: 页码
- size: 每页数量

// 2. 获取成长记录详情
GET /api/growth-record/parent/{id}
参数：
- id: 记录ID

// 3. 标记为已读
POST /api/growth-record/parent/{id}/read
参数：
- id: 记录ID

// 4. 获取周反馈列表
GET /api/growth-record/parent/weekly/list
参数：
- studentId: 学生ID
- startDate: 开始日期（可选）
- endDate: 结束日期（可选）
- page: 页码
- size: 每页数量

// 5. 获取月反馈列表
GET /api/growth-record/parent/monthly/list
参数：
- studentId: 学生ID
- startDate: 开始日期（可选）
- endDate: 结束日期（可选）
- page: 页码
- size: 每页数量

2. 前端页面（已完成）

2.1 成长记录列表页面

文件： peidu/uniapp/src/user-package/pages/growth/list.vue

功能：

顶部标题和说明
筛选标签（全部/每日反馈/周反馈/月反馈）
记录卡片展示
- 日期和类型标识
- 学生和陪伴员信息
- 服务时长
- 内容预览
- 照片预览（最多显示3张）
下拉刷新
上拉加载更多
空状态提示

2.2 成长记录详情页面

文件： peidu/uniapp/src/user-package/pages/growth/detail.vue

功能：

返回按钮
顶部信息卡片
- 记录类型图标
- 日期
- 学生和陪伴员信息
- 服务时长
反馈内容展示
照片展示（支持预览）
视频展示（支持播放）
陪伴员信息和联系按钮
自动标记为已读

2.3 服务反馈列表页面（已更新）

文件： peidu/uniapp/src/user-package/pages/feedback/list.vue

更新内容：

✅ 调用新的成长记录接口 /api/growth-record/parent/list
✅ 只显示每日反馈（recordType: 'daily'）
✅ 数据格式转换以适配现有UI
✅ 启用真实接口调用

📊 数据流程

家长端 → 后端Controller → Service层 → 数据库
  ↓
查询条件：
- studentId（学生ID）
- recordType（记录类型）
- 日期范围
  ↓
返回数据：
- 记录列表（分页）
- 记录详情
- 图片列表
- 视频列表
- 服务时长

🔗 页面路由配置

需要在 pages.json 中添加以下路由：

{
  "path": "user-package/pages/growth/list",
  "style": {
    "navigationBarTitleText": "成长记录",
    "enablePullDownRefresh": true
  }
},
{
  "path": "user-package/pages/growth/detail",
  "style": {
    "navigationBarTitleText": "成长记录详情"
  }
}

🎨 UI设计特点

颜色方案

主色调：#2d9687（绿色）
文字颜色：#333（黑色）、#666（灰色）
背景色：#f5f5f5（浅灰）
白色：#fff

类型标识

每日反馈：蓝色 #2196f3
周反馈：紫色 #9c27b0
月反馈：橙色 #ff9800

图标

每日反馈：📝
周反馈：📊
月反馈：📈
照片：📷
视频：🎬
陪伴员：👨‍🏫

🧪 测试指南

1. 测试成长记录列表

# 访问页面
/user-package/pages/growth/list?studentId=1

# 测试筛选
- 点击"全部"标签 → 显示所有类型记录
- 点击"每日反馈"标签 → 只显示每日反馈
- 点击"周反馈"标签 → 只显示周反馈
- 点击"月反馈"标签 → 只显示月反馈

# 测试加载
- 下拉刷新 → 重新加载第一页
- 上拉加载 → 加载下一页

2. 测试成长记录详情

# 从列表点击任意记录
→ 跳转到详情页
→ 显示完整内容
→ 照片可以预览
→ 视频可以播放
→ 自动标记为已读

3. 测试服务反馈列表

# 访问页面
/user-package/pages/feedback/list

# 验证
- 显示每日反馈列表
- 数据来自成长记录接口
- 点击查看详情正常跳转

📝 数据库要求

确保 growth_record 表包含以下字段：

- id: 记录ID
- order_id: 订单ID
- teacher_id: 陪伴员ID
- student_id: 学生ID
- student_name: 学生姓名（冗余字段）
- record_date: 记录日期
- record_type: 记录类型（daily/weekly/monthly）
- content: 反馈内容
- images: 图片列表（JSON）
- videos: 视频列表（JSON）
- status: 状态（1=已提交，0=草稿）
- is_archived: 是否已归档
- create_time: 创建时间
- update_time: 更新时间

✅ 完成清单

后端Controller层添加家长端接口
创建成长记录列表页面
创建成长记录详情页面
更新服务反馈列表页面
实现筛选功能（全部/每日/周/月）
实现分页加载
实现照片预览
实现视频播放
实现标记已读
编写测试指南
编写实施文档

🚀 部署步骤

1. 编译后端

cd peidu/backend
mvn clean package -DskipTests

2. 重启后端服务

# 停止服务
./stop.sh

# 启动服务
./deploy.sh

3. 编译前端

cd peidu/uniapp
npm run build:mp-weixin

4. 上传小程序

使用微信开发者工具上传编译后的代码

📞 联系方式

如有问题，请联系开发团队。

实施日期： 2026-01-23
实施人员： Kiro AI Assistant
状态： ✅ 已完成

5.8 KiB Raw Permalink Blame History Unescape Escape