xiaoli/peixue-dev

Fork 0

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

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

8.4 KiB

Raw Blame History

家长端成长记录功能测试指南

更新时间: 2026-01-23 12:16
状态: ✅ 代码已完成,数据库已修复,后端已编译,等待重启服务测试

⚡ 最新进展

✅ 已完成

✅ 后端接口开发完成
✅ 前端页面开发完成
✅ SQL字段名修复完成 (student_name, user_id)
✅ 前端参数传递修复完成
✅ Service层异常处理修复完成 (学生不存在返回空列表)
✅ 数据库deleted字段修复完成 (已执行SQL)
✅ 后端重新编译完成

⚠️ 待执行

⚠️ 重启后端服务
⚠️ 刷新小程序
⚠️ 执行测试验证

📋 测试前准备

1. 确保数据库有测试数据

-- 检查成长记录数据
SELECT 
    id,
    student_id,
    student_name,
    teacher_id,
    record_type,
    record_date,
    content,
    images,
    videos,
    status
FROM growth_record
WHERE student_id = 1
ORDER BY record_date DESC
LIMIT 10;

2. 确保后端服务运行

# 检查后端服务状态
curl http://localhost:8080/api/health

# 或访问
http://localhost:8080/swagger-ui.html

3. 确保前端已编译

cd peidu/uniapp
npm run build:mp-weixin

🧪 测试用例

测试用例 1：成长记录列表 - 全部记录

测试步骤：

打开小程序
进入家长端
点击"成长记录"菜单
默认显示"全部"标签

预期结果：

✅ 显示所有类型的成长记录（每日/周/月）
✅ 每条记录显示：日期、类型标识、学生姓名、陪伴员姓名
✅ 显示内容预览（最多80字）
✅ 显示照片预览（最多3张）
✅ 显示服务时长

测试数据：

studentId: 1
recordType: all

测试用例 2：成长记录列表 - 每日反馈

测试步骤：

在成长记录列表页面
点击"每日反馈"标签

预期结果：

✅ 只显示每日反馈记录
✅ 类型标识显示蓝色"每日反馈"
✅ 记录按日期倒序排列

测试数据：

studentId: 1
recordType: daily

测试用例 3：成长记录列表 - 周反馈

测试步骤：

在成长记录列表页面
点击"周反馈"标签

预期结果：

✅ 只显示周反馈记录
✅ 类型标识显示紫色"周反馈"
✅ 记录按日期倒序排列

测试数据：

studentId: 1
recordType: weekly

测试用例 4：成长记录列表 - 月反馈

测试步骤：

在成长记录列表页面
点击"月反馈"标签

预期结果：

✅ 只显示月反馈记录
✅ 类型标识显示橙色"月反馈"
✅ 记录按日期倒序排列

测试数据：

studentId: 1
recordType: monthly

测试用例 5：成长记录详情

测试步骤：

在成长记录列表页面
点击任意一条记录

预期结果：

✅ 跳转到详情页面
✅ 显示完整的反馈内容
✅ 显示所有照片（可点击预览）
✅ 显示所有视频（可播放）
✅ 显示陪伴员信息
✅ 自动标记为已读

测试数据：

recordId: 从列表中选择

测试用例 6：照片预览

测试步骤：

在成长记录详情页面
点击任意照片

预期结果：

✅ 打开照片预览
✅ 可以左右滑动查看所有照片
✅ 可以缩放照片
✅ 可以保存照片

测试用例 7：视频播放

测试步骤：

在成长记录详情页面
点击视频播放按钮

预期结果：

✅ 视频开始播放
✅ 可以暂停/继续
✅ 可以调整进度
✅ 可以全屏播放

测试用例 8：下拉刷新

测试步骤：

在成长记录列表页面
下拉页面

预期结果：

✅ 显示刷新动画
✅ 重新加载第一页数据
✅ 刷新完成后隐藏动画

测试用例 9：上拉加载更多

测试步骤：

在成长记录列表页面
滚动到底部

预期结果：

✅ 显示"加载中..."提示
✅ 加载下一页数据
✅ 新数据追加到列表末尾
✅ 如果没有更多数据，不再触发加载

测试用例 10：空状态

测试步骤：

使用没有成长记录的学生ID
打开成长记录列表

预期结果：

✅ 显示空状态图标 📚
✅ 显示"暂无成长记录"文字
✅ 显示"陪伴员服务后会提交成长记录"提示

测试用例 11：服务反馈列表（已更新）

测试步骤：

打开小程序
进入家长端
点击"服务反馈"菜单

预期结果：

✅ 显示每日反馈列表
✅ 数据来自成长记录接口
✅ 显示学生姓名、陪伴员姓名
✅ 显示反馈内容预览
✅ 显示照片预览
✅ 点击查看详情正常跳转

🔍 接口测试

1. 测试获取成长记录列表

# 使用curl测试
curl -X GET "http://localhost:8080/api/growth-record/parent/list?studentId=1&recordType=daily&page=1&size=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 预期返回
{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "id": 1,
        "studentId": 1,
        "studentName": "小明",
        "teacherId": 1,
        "teacherName": "张老师",
        "recordDate": "2026-01-23",
        "recordType": "daily",
        "recordTypeName": "每日反馈",
        "content": "今天学习状态很好...",
        "imageList": ["url1", "url2"],
        "videoList": ["url1"],
        "durationText": "120分钟"
      }
    ],
    "total": 10,
    "size": 10,
    "current": 1,
    "pages": 1
  }
}

2. 测试获取成长记录详情

# 使用curl测试
curl -X GET "http://localhost:8080/api/growth-record/parent/1" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 预期返回
{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "studentId": 1,
    "studentName": "小明",
    "teacherId": 1,
    "teacherName": "张老师",
    "recordDate": "2026-01-23",
    "recordType": "daily",
    "recordTypeName": "每日反馈",
    "content": "今天学习状态很好，完成了所有作业...",
    "imageList": ["url1", "url2", "url3"],
    "videoList": ["url1"],
    "durationText": "120分钟"
  }
}

3. 测试标记为已读

# 使用curl测试
curl -X POST "http://localhost:8080/api/growth-record/parent/1/read" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 预期返回
{
  "code": 200,
  "message": "标记成功",
  "data": true
}

📊 性能测试

1. 列表加载性能

测试指标：

首次加载时间 < 2秒
翻页加载时间 < 1秒
下拉刷新时间 < 1.5秒

2. 详情加载性能

测试指标：

详情页加载时间 < 1.5秒
照片加载时间 < 1秒/张
视频加载时间 < 3秒

3. 照片预览性能

测试指标：

预览打开时间 < 0.5秒
切换照片时间 < 0.3秒

🐛 常见问题排查

问题 1：列表显示为空

排查步骤：

检查数据库是否有数据
检查studentId是否正确
检查后端日志是否有错误
检查前端控制台是否有错误

问题 2：照片无法显示

排查步骤：

检查图片URL是否正确
检查图片服务器是否可访问
检查小程序域名白名单配置

问题 3：视频无法播放

排查步骤：

检查视频URL是否正确
检查视频格式是否支持
检查小程序域名白名单配置

问题 4：接口返回401

排查步骤：

检查token是否过期
检查用户是否已登录
重新登录获取新token

✅ 测试检查清单

成长记录列表 - 全部记录
成长记录列表 - 每日反馈
成长记录列表 - 周反馈
成长记录列表 - 月反馈
成长记录详情
照片预览
视频播放
下拉刷新
上拉加载更多
空状态显示
服务反馈列表
接口测试 - 列表
接口测试 - 详情
接口测试 - 标记已读
性能测试
常见问题排查

📝 测试报告模板

测试日期：2026-01-23
测试人员：[姓名]
测试环境：[开发/测试/生产]

测试结果：
✅ 通过：[数量]
❌ 失败：[数量]
⚠️ 警告：[数量]

详细说明：
1. [测试用例名称] - [通过/失败] - [备注]
2. ...

问题列表：
1. [问题描述] - [严重程度] - [解决方案]
2. ...

总结：
[测试总结]

编写日期： 2026-01-23
编写人员： Kiro AI Assistant

8.4 KiB Raw Blame History Unescape Escape

家长端成长记录功能测试指南

⚡ 最新进展

✅ 已完成

⚠️ 待执行

📋 测试前准备

1. 确保数据库有测试数据

2. 确保后端服务运行

3. 确保前端已编译

🧪 测试用例

测试用例 1：成长记录列表 - 全部记录

测试用例 2：成长记录列表 - 每日反馈

测试用例 3：成长记录列表 - 周反馈

测试用例 4：成长记录列表 - 月反馈

测试用例 5：成长记录详情

测试用例 6：照片预览

测试用例 7：视频播放

测试用例 8：下拉刷新

测试用例 9：上拉加载更多

测试用例 10：空状态

测试用例 11：服务反馈列表（已更新）

🔍 接口测试

1. 测试获取成长记录列表

2. 测试获取成长记录详情

3. 测试标记为已读

📊 性能测试

1. 列表加载性能

2. 详情加载性能

3. 照片预览性能

🐛 常见问题排查

问题 1：列表显示为空

问题 2：照片无法显示

问题 3：视频无法播放

问题 4：接口返回401

✅ 测试检查清单

📝 测试报告模板

8.4 KiB

Raw Blame History