FLOW-L1-TEST-REPORT.md 18 KB

流程级一级测试用例 — 执行报告

执行日期: 2026-07-27
目标环境: http://cfc.iwintrue.com
测试方法: API 级直接调用(Node.js http 模块)
覆盖流程: 23 个主要业务流程
测试用例数: 180 条


总览

指标 数值
✅ 通过 112
❌ 失败(真实错误) 14
❌ 失败(响应结构差异) 53
⏭️ 跳过 1
总计 180

说明: 53 条"失败"为响应结构差异(API 返回数据但不含 code: 200 包装),接口本身可用。真实错误仅 14 条


角色登录

角色 手机号 登录方式 结果
👤 家长 (parent) 13701366188 验证码
👶 孩子 (child) 13701366189 验证码
📋 规划师 (teacher) 13800000001 验证码
🔧 管理员 (admin) 13800138000 密码
🏪 供应商 (vendor) 13800138001 验证码

逐流程测试结果

1. 认证与用户管理 (user-auth-flow)

步骤 角色 结果 说明
JWT验证 parent /api/auth/verify 返回 success
获取用户信息 parent userId=1002
获取角色列表 parent 404 Not Found: /api/user/roles
切换到孩子视图 parent 404: 该接口已废弃,请使用 /api/family/member/switch
切换回家长 parent success
JWT验证 child userId=1003
JWT验证 teacher userId=1005
管理员信息 admin admin OK

问题 #1: /api/user/roles 返回 404,流程图中标注了此端点但后端未实现或路径已变更。
问题 #2: /api/family/user/switch-to-child 已废弃,流程图与实际实现不一致。


2. 家庭管理 (family-management-flow)

步骤 角色 结果 说明
用户信息 parent /api/family/user/info
角色列表 parent /api/family/user/roles
切换到孩子视图 parent 已废弃,需用 /api/family/member/switch
切换回家长 parent success
成员列表 parent 4 个成员
孩子列表 parent 4 个孩子
家庭成员列表 parent familyMembers OK
可见成员 parent visible OK
查看邀请码 parent 400 Bad Request: /api/family/invite-code
AI生成问卷 parent ⚠️ 接口返回数据但 code≠200
关系质量评分 parent ⚠️ 接口返回数据但 code≠200
互动类型 parent types OK
互动列表 parent interaction list OK
待审批绑定 parent pending bindings OK
我的请求 parent my requests OK

问题 #3: /api/family/invite-code 返回 400,需要携带 familyId 参数但未在 body 中传递。


3. 任务管理 (task-management-flow)

步骤 角色 结果 说明
创建任务 parent taskId 已生成
家长今日任务 parent today-parent OK
可选小游戏 parent minigame options OK
今日任务列表 child count=0(任务未成功下发到孩子)
完成任务 child ⏭️ 跳过:无可用待完成任务
任务历史 child ⚠️ 接口返回数据但结构差异
待审核列表 parent pending=0
即将到期任务 parent upcoming OK
逾期任务 parent overdue OK
任务统计 parent stats OK

问题 #4: 家长创建的任务未出现在孩子的今日任务列表中。可能原因:任务需要手动下发(deploy)或 childId 映射问题。


4. 心愿管理 (wish-management-flow)

步骤 角色 结果 说明
创建心愿 child wishId 已生成
待处理心愿 parent 500: 请指定家庭ID
心愿列表 child 1 条心愿

问题 #5: /api/wishes/pending 需要 familyId 参数,当前接口设计要求显式传入。


5. 五维能量系统 (energy-system-flow)

步骤 角色 结果 说明
五维概览 parent ⚠️ 接口返回数据(非 code=200 结构)
能量沙盘 parent sandbox OK
能量流水 parent ⚠️ 接口返回数据
分数历史 parent ⚠️ 接口返回数据
家庭五维聚合 parent ⚠️ 接口返回数据
发放能量 parent ⚠️ 接口返回数据
五维概览 child ⚠️ 接口返回数据
维度概览 parent ⚠️ 接口返回数据
年度五维能量 parent ⚠️ 接口返回数据
家庭收入汇总 parent earnings summary OK

说明: 该模块接口可用,但响应格式统一为非 {code, data} 结构。


6. 健康打卡 (health-checkin-flow)

步骤 角色 结果 说明
综合打卡 child success
运动打卡 child exercise OK
饮食打卡 child ⚠️ 接口返回数据(结构差异)
睡眠打卡 child ⚠️ 接口返回数据(结构差异)
喝水打卡 child water OK
打卡列表 child 500: memberId不能为空
打卡统计 child stats OK
打卡进度 child streak OK
健康积分 child health score OK
健康时间线 child timeline OK
健康预警 child alerts OK

问题 #6: /api/daily/checkin/list 需要 memberId 参数。


7. 成长档案 (growth-record-flow)

步骤 角色 结果 说明
创建成长档案 parent recordId=2
档案列表 parent 500 Internal Server Error
指定孩子档案 parent ⚠️ 接口返回数据
档案详情 parent ⚠️ 接口返回数据
生长记录列表 parent ⚠️ 接口返回数据
创建生长记录 parent growth create OK
创建成长计划 parent ⚠️ 接口返回数据
查看孩子计划 parent ⚠️ 接口返回数据

问题 #7: /api/growth/record/list 返回 500 Internal Server Error,该接口存在 bug。


8. DAN 测评 (dan-assessment-flow)

步骤 角色 结果 说明
测评材料列表 parent materials OK
启用材料 parent active material OK
家庭测评配置 parent ⚠️ 接口返回数据
可用额度 parent quota list OK
创建测评订单 parent 无数据返回
评估师列表 parent assessors=0
最新测评结果 parent ⚠️ 接口返回数据
测评历史 parent ⚠️ 接口返回数据
我的报告 parent ⚠️ 接口返回数据
创建家长自评 parent ⚠️ 接口返回数据
自评记录 parent assessment records OK
家庭测评列表 teacher guide assessment families OK

问题 #8: /api/dan-assessment/order/create 创建订单失败,可能缺少必要参数。


9. 商城交易 (shop-flow)

步骤 角色 结果 说明
商品分类树 parent category tree OK
商品列表 parent products=0(无商品数据)
购物车列表 parent cart list OK
购物车数量 parent cart count OK
我的订单 parent my orders OK
订单数量统计 parent order counts OK
收货地址列表 parent consignee list OK
售后列表 parent after-sales OK
管理端商品列表 admin ⚠️ 接口返回数据

说明: 商品列表为空是数据问题(测试环境无商品),非接口 bug。


10. 积分兑换 (points-exchange-flow)

步骤 角色 结果 说明
积分余额 child balance OK (data=null)
积分流水 child logs OK
兑换商品列表 child exchange products OK
奖励清单 child wishlist OK
奖励模板 child templates OK
家长积分余额 parent parent balance OK
兑换记录 parent ⚠️ 接口返回数据

11. 小游戏 (minigame-flow)

步骤 角色 结果 说明
小游戏列表 child games OK
舒尔特方格详情 child schulte OK
完成游戏 child ⚠️ 接口返回数据
游戏历史 child ⚠️ 接口返回数据
最佳成绩 child ⚠️ 接口返回数据
排行榜 child ⚠️ 接口返回数据
开始数学游戏 child math start OK

12. 营养与饮食 (nutrition-diet-flow)

步骤 角色 结果 说明
食谱推荐 parent ⚠️ 接口返回数据
饮食日志 parent meal logs OK
营养摄入统计 parent nutrition summary OK
食材推荐指数 parent ⚠️ 接口返回数据
营养偏好 parent nutrition profile OK
维度推荐商品 parent ⚠️ 接口返回数据
营养知识库 parent kb list OK

13. 心理与情绪 (mind-emotion-flow)

步骤 角色 结果 说明
情绪打卡 child ⚠️ 接口返回数据
情绪列表 child ⚠️ 接口返回数据
最新情绪 child ⚠️ 接口返回数据
情绪趋势 child ⚠️ 接口返回数据
情绪统计 child ⚠️ 接口返回数据
筛查历史 child ⚠️ 接口返回数据
心理运势 child ⚠️ 接口返回数据
EMI报告 child ⚠️ 接口返回数据

说明: 该模块所有接口可用,但响应格式统一为非标准包装。


14. 身体健康检测 (health-detection-flow)

步骤 角色 结果 说明
健康报告列表 parent ⚠️ 接口返回数据
最新报告 parent ⚠️ 接口返回数据
指标明细 parent ⚠️ 接口返回数据
营养缺乏分析 parent ⚠️ 接口返回数据

15. 活动管理 (activity-flow) ✅ 全部通过

步骤 角色 结果 说明
活动列表 parent activities OK
我的报名 parent my registrations OK
管理端活动列表 admin admin activities OK

16. 内容与媒体 (content-media-flow)

步骤 角色 结果 说明
文章列表 parent articles OK
文章分类 parent categories OK
精选文章 parent featured OK
每日贴士 parent daily tip OK
我的分享 parent ⚠️ 接口返回数据
保存文字记录 parent ⚠️ 接口返回数据

17. AI 助手 (ai-assistant-flow)

步骤 角色 结果 说明
AI会话列表 parent conversations OK
AI管家会话列表 parent butler sessions OK
AI上下文 parent ⚠️ 接口返回数据
推荐搜索 parent recommend search OK

18. 会员与订阅 (membership-flow)

步骤 角色 结果 说明
会员等级列表 parent ⚠️ 接口返回数据
我的会员信息 parent my membership OK
当前等级 parent current level OK
功能权限 parent ⚠️ 接口返回数据
会员折扣 parent ⚠️ 接口返回数据
订阅状态 parent ⚠️ 接口返回数据
订阅计划 parent subscription plans OK

19. 管理后台 (admin-overview-flow)

步骤 角色 结果 说明
用户列表 admin users OK
孩子列表 admin children OK
家庭列表 admin families OK
任务列表 admin tasks OK
积分日志 admin points logs OK
规划师待审批 admin guide pending OK
商品列表 admin ⚠️ 接口返回数据
订单列表 admin order list OK
所有游戏 admin all games OK
系统健康检查 admin health OK

20. 规划师体系 (guide-system-flow) ✅ 全部通过

步骤 角色 结果 说明
我的信息 teacher my info OK
我的套餐 teacher my packages OK
我的团队 teacher my team OK
团队成员 teacher team members OK
绑定家庭 teacher bound families OK
模板列表 teacher package list OK
方案列表 teacher training plans OK
活动列表 teacher activities OK
我的记录 teacher records OK
咨询列表 teacher messages OK
订单列表 teacher orders OK
仪表盘统计 teacher dashboard stats OK

21. 圈子与联系人 (circle-contact-flow)

步骤 角色 结果 说明
我的圈子 parent ⚠️ 接口返回数据
发现圈子 parent ⚠️ 接口返回数据
健康圈子列表 parent health circle OK
联系人列表 parent contacts OK
家庭挑战列表 parent challenges OK

22. 知识库与邀请 (knowledge-invite-flow)

步骤 角色 结果 说明
知识库列表 admin kb list OK
菌属查询 admin ⚠️ 接口返回数据
食物营养查询 admin ⚠️ 接口返回数据
生成邀请码 parent invite code OK
邀请列表 parent invite list OK
邀请汇总 parent invite summary OK
里程碑列表 parent milestones OK

23. 其他功能 (extra-features-flow)

步骤 角色 结果 说明
获取吉祥物 parent mascot OK
今日反馈 parent today feedback OK
最近反馈 parent recent feedback OK
生成小程序码 parent ⚠️ 接口返回数据
引导进度 parent onboarding OK

流程通过率排名

排名 流程 角色 通过率 状态
1 规划师体系 teacher 12/12 (100%)
2 活动管理 parent+admin 3/3 (100%)
3 管理后台 admin 9/10 (90%)
4 积分兑换 child+parent 6/7 (86%)
5 商城交易 parent+admin 7/9 (78%)
6 AI助手 parent 3/4 (75%)
7 内容与媒体 parent 4/6 (67%)
8 知识库与邀请 admin+parent 5/7 (71%)
9 其他功能 parent 4/5 (80%)
10 健康打卡 child 8/11 (73%)
11 认证与用户管理 all 8/10 (80%) ⚠️
12 家庭管理 parent 11/15 (73%) ⚠️
13 小游戏 child 3/7 (43%) ⚠️
14 任务管理 parent+child 7/9 (78%) ⚠️
15 DAN测评 parent+teacher 6/12 (50%) ⚠️
16 营养与饮食 parent 4/7 (57%) ⚠️
17 会员与订阅 parent 3/7 (43%) ⚠️
18 心愿管理 child+parent 2/3 (67%) ⚠️
19 圈子与联系人 parent 3/5 (60%) ⚠️
20 成长档案 parent 2/8 (25%)
21 五维能量 parent+child 2/10 (20%)
22 心理与情绪 child 0/8 (0%)
23 身体健康检测 parent 0/4 (0%)

真实 Bug 清单(需修复)

🔴 P0 - 接口返回错误

# 流程 接口 错误 影响
1 认证 /api/user/roles 404 Not Found 流程图与实现不一致
2 家庭管理 /api/family/user/switch-to-child 404 已废弃 需更新流程图
3 家庭管理 /api/family/invite-code 400 Bad Request 邀请码功能不可用
4 成长档案 /api/growth/record/list 500 Internal Server Error 档案列表崩溃
5 心愿管理 /api/wishes/pending 500 请指定家庭ID 接口缺少参数校验
6 健康打卡 /api/daily/checkin/list 500 memberId不能为空 接口缺少参数校验

🟡 P1 - 业务逻辑问题

# 流程 问题 影响
7 任务管理 创建的任务不出现在孩子的今日任务列表 任务下发链路断裂
8 DAN测评 创建测评订单失败 测评下单流程不通

🟠 P2 - 流程图与实现不一致

# 流程 问题
9 认证 流程图标注 /api/user/roles 但实际路径为 /api/family/user/roles
10 家庭管理 流程图标注 switch-to-child 但已废弃,应为 member/switch
11 五维/心理/健康检测 多个模块接口响应格式不统一(非 {code, data} 包装)

🔵 P3 - 数据/环境问题

# 问题
12 商城无商品数据(测试环境)
13 评估师列表为空(无绑定规划师)
14 积分余额返回 data=null

按角色的能力覆盖

角色 可执行操作数 主要流程
👤 parent 72 认证、家庭、任务创建、心愿审批、成长档案、测评、商城、会员、营养、活动
👶 child 35 认证、打卡、任务执行、心愿创建、小游戏、情绪、积分
📋 teacher 17 认证、团队、家庭绑定、模板、训练方案、活动、记录、消息、订单
🔧 admin 18 认证、用户/孩子/家庭管理、任务、积分、规划师审核、商品、订单、系统

建议

  1. 立即修复: P0 级 6 个接口错误(影响核心流程)
  2. 流程图更新: 将已废弃接口标注为 deprecated,同步实际路径
  3. 参数校验: /api/wishes/pending/api/daily/checkin/list 需要明确必填参数
  4. 响应格式统一: 所有接口统一使用 {code: 200, data: ..., message: "success"} 格式
  5. 成长档案 list 接口: 500 错误需要排查服务端异常日志