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 错误需要排查服务端异常日志