cfc/tests/test-cases/cross-role-e2e.md

跨角色端到端测试用例（Cross-Role E2E · 主链路）

关联：各角色场景中的「主链路」片段；黑盒方案第 4.7 节（周五演示脚本）。 目标：验证 报告上传 → 解析入库 → 方案生成 → 审核 → 激活拆任务 → 执行打卡 → 审核统计 的跨角色闭环。 对应 e2e：../e2e/assessment-order-flow.spec.js、../e2e/dan-report-flow.spec.js、../e2e/ai-plan-task-flow.spec.js、../e2e/energy-system.spec.js、../e2e/admin-panel.spec.js。

主链路全景（角色流转）

规划师(代传报告) → 家长(生成方案) → 规划师(批准+激活) → 孩子(打卡) → 规划师(审核) → 运营(统计)
        ↑ 也可由家长直接上传报告(P-8/P-10)

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-01	报告上传解析	规划师	P0	功能	已绑定家庭+孩子 B；募极生物 PDF	1. 代上传 PDF+选 B 2. 解析预览 3. 确认入库	报告自动解析入库；七维健康评分刷新；/api/health/report/list 可查到	T-3 / P-10
TC-X-02	报告审核入库	规划师	P0	功能	X-01 草稿	1. 审核队列确认/直接入库	健康报告列表可见该报告	T-4
TC-X-03	方案生成	家长	P0	功能	孩子 B 有报告；已购会员	1. 选 B+默认目标 2. 调 LangGraph 生成并保存	方案生成成功(status=generated)并保存	P-13
TC-X-04	方案批准+激活	规划师	P0	功能	X-03 方案 generated	1. 批准(generated→reviewed) 2. 激活(reviewed→active)	孩子 B 名下出现「方案启动」引导任务+模板任务	T-6 / T-7
TC-X-05	任务打卡	孩子	P0	功能	X-04 已生成方案任务	1. 孩子打开方案任务 2. 完成并提交打卡	任务待审核；方案进度 completedDays+1	C-7 / C-2
TC-X-06	任务审核	规划师	P0	功能	X-05 已提交	1. 审核通过	孩子积分到账，流水可见	T-9 / P-06
TC-X-07	全局统计	运营	P1	功能	以上步骤已执行	1. 打开统计页	任务总量/完成数含本次演示数据	A-02
TC-X-08	幂等与回滚（主链路健壮性）	多角色	P0	异常	X-04 已 active 方案	1. 对已激活方案再次激活 2. 支付失败回滚 3. 重复打卡	重复激活不重复生成任务；支付失败订单不进入待安排；重复打卡不重复计数	T-8 / P-09a / C-8

主链路验收口径

• P0 全绿：TC-X-01~06、TC-X-08 必须 100% 通过，否则主链路不通过。
• 数据一致性：方案进度、积分流水、能量增量在闭环结束后彼此自洽（增分有流水、打卡有进度）。
• AI 可用性：TC-X-03 在 LangGraph 不可用时由 AiGateway Fallback 兜底，不得 500（属 P0 异常口径）。

---

资产自检清单（交付前）

• user-scenarios/ 6 角色场景齐全（guest/parent/child/teacher/admin/vendor）
• test-cases/ 6 角色 + 跨角色 E2E 用例齐全
• 双角色边界（家长↔孩子可切 / 孩子端不可切回 / 规划师可切回）在 P/C/T 用例中显式覆盖
• 五维能量、测评订单闭环、健康报告主链路、LangGraph AI、文章审核、数据迁移等关键设计点均有场景+用例映射
• 与既有 BLACKBOX-TEST-PLAN.md、e2e/*.spec.js 口径一致、互不冲突
• 执行侧：用例需在测试环境跑通并回填结果（本批仅交付设计资产，执行需另行按双档授权）

补齐用例（缺口场景 SC-X-09~12）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-09	AI 方案送审闭环	多角色	P0	功能	家长已生成方案(generated)	1. 家长送审 2. 规划师批准(reviewed) 3. 激活(active)	未确认不可激活；全链路状态正确流转	P-44 / T-06 / T-07
TC-X-10	报告对比趋势闭环	多角色	P2	功能	同一孩子多次上传同类型报告	1. 多次上传 2. 对比 3. 趋势 4. 方案调整	类型一致才可比；趋势方向正确	P-25 / T-21
TC-X-11	消息通知闭环	多角色	P1	功能	跨角色消息配置就绪	1. 规划师发消息 2. 家长/孩子收 3. 已读	仅目标角色可见；免打扰设置生效	P-65 / T-19 / C-15
TC-X-12	会员权益闭环	多角色	P1	功能	家长未购会员	1. 购会员 2. 权益生效 3. AI/高级报告解锁 4. 过期回收	购后解锁付费能力；过期权益回收	P-58 / P-16

---

本轮扩展场景用例（新增 SC-X）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-13	报告代传跨角色闭环	跨角色	P1	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：发起代传 → 对方上传 → 孩子档案更新 2. 观察结果	达成目标：代传贯通；边界：授权校验；越权代传拒	X-13
TC-X-14	解绑/重分配跨角色协	跨角色	P1	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：家长解绑 ↔ 规划师侧更新 2. 观察结果	达成目标：解绑一致；边界：在途数据交接；状态同步	X-14
TC-X-15	注销/数据导出跨角色	跨角色	P1	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：家长申请 → 运营处理 → 规划师档案解绑 2. 观察结果	达成目标：注销贯通；边界：审计；冷静期	X-15
TC-X-16	活动名额并发 E2E	跨角色	P0	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：多家长同时报名抢名额 2. 观察结果	达成目标：并发报名；边界：并发超卖拦截（真实 bug）	X-16
TC-X-17	多端登录会话互斥跨端	跨角色	P1	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：A 端登录 → B 端被踢/验证 2. 观察结果	达成目标：会话安全；边界：异常设备风控	X-17
TC-X-18	推送跨端送达	跨角色	P1	功能	已登录(默认 跨角色)；相关前置数据就绪	1. 按场景流程执行：家长设提醒 → 孩子端收到 2. 观察结果	达成目标：提醒触达；边界：免打扰生效	X-18

异常流用例（派生自正常流）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-01-E	报告上传解析	规划师	P2	异常	已绑定家庭+孩子 B；募极生物 PDF	1. 上传损坏PDF/非募极/超大 2. 解析服务超时 3. 上传非绑定家庭孩子报告	损坏/非募极明确提示(非募极提示请确认募极生物)；超大超限提示；超时进草稿非500；非绑定孩子 403	T-3 / P-10
TC-X-02-E	报告审核入库	规划师	P2	异常	X-01 草稿	1. 确认一个已被他人确认/删除的草稿 2. 解析超时草稿点确认	已删草稿提示『不存在』；解析中确认提示稍候；非绑定家庭草稿 403	T-4
TC-X-03-E	方案生成	家长	P2	异常	孩子 B 有报告；已购会员	1. 生成时 LangGraph 超时/不可用 2. 未购会员却请求付费板块 3. 并发双生成同一目标	Fallback 兜底方案+提示非500；未购会员拦截『请先开通会员』；并发幂等仅 1 个 generated	P-13
TC-X-04-E	方案批准+激活	规划师	P2	异常	X-03 方案 generated	1. 激活时任务分解超时 2. 对已激活方案再激活 3. 激活非 reviewed 方案	超时回滚不残半任务；已激活再激活幂等不重复生成任务；非 reviewed 拦截	T-6 / T-7
TC-X-05-E	任务打卡	孩子	P2	异常	X-04 已生成方案任务	1. 同任务重复打卡 2. 逾期限打卡 3. 打卡非本人方案任务	重复打卡幂等不重复计数；逾期按业务拒/允一致；非本人任务 403	C-7 / C-2
TC-X-06-E	任务审核	规划师	P2	异常	X-05 已提交	1. 审核非绑定家庭孩子任务 2. 同任务并发双审 3. 超期任务审核	非绑定家庭 403；并发双审幂等仅计 1 次积分；超期审核被拒	T-9 / P-06
TC-X-07-E	全局统计	运营	P2	异常	以上步骤已执行	1. 统计接口超时/无数据 2. 时间范围非法	超时降级非500；无数据显示『暂无数据』；时间非法 400	A-02
TC-X-08-E	幂等与回滚（主链路健壮性）	多角色	P2	异常	X-04 已 active 方案	1. 对已 active 方案并发再激活 2. 支付失败回滚 3. 重复打卡	并发再激活幂等仅生成 1 次任务；支付失败订单不进待安排；重复打卡不重复计数	T-8 / P-09a / C-8
TC-X-09-E	AI 方案送审闭环	多角色	P2	异常	家长已生成方案(generated)	1. 送审时 LangGraph 超时 2. 未确认直接激活 3. 重复送审	超时 Fallback 提示非500；未确认激活拦截『请先确认』；重复送审幂等	P-44 / T-06 / T-07
TC-X-10-E	报告对比趋势闭环	多角色	P3	异常	同一孩子多次上传同类型报告	1. 对比不同类型报告 2. 仅 1 份报告看趋势 3. 趋势时间倒挂	类型不一致提示不可比；单报告提示需≥2份；时间轴按真实升序不倒挂	P-25 / T-21
TC-X-11-E	消息通知闭环	多角色	P2	异常	跨角色消息配置就绪	1. 消息内容含 XSS 载荷 2. 越权读他人消息 3. 标记已读时 id 不存在	XSS 转义不执行；越权消息 403；不存在 id 404	P-65 / T-19 / C-15
TC-X-12-E	会员权益闭环	多角色	P2	异常	家长未购会员	1. 支付失败 2. 重复购买同档位 3. 过期后权益回收时机	失败回滚不解锁；重复购买幂等仅 1 次；过期回收断言一致	P-58 / P-16

本轮扩展异常流（派生自新增场景）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-13-E	报告代传跨角色闭环	跨角色	P2	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 越权代传他人孩子 2. 上传损坏/非募极 3. 授权令牌失效	越权代传 403；损坏/非募极明确提示；令牌失效提示重发	X-13
TC-X-14-E	解绑/重分配跨角色协	跨角色	P2	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 解绑时有在途方案/预约未交接 2. 并发解绑+重分配	在途未完成提示先交接；并发操作乐观锁不互相覆盖	X-14
TC-X-15-E	注销/数据导出跨角色	跨角色	P2	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 注销未完成却触发导出 2. 越权导出他人 3. 冷静期内再次注销	注销未完成导出提示先完成；越权导出 403；冷静期内重复注销幂等	X-15
TC-X-16-E	活动名额并发 E2E	跨角色	P1	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 名额仅剩 1 时 500 并发报名 2. 名额已满再报名	并发超卖拦截仅 1 人成功(真实 bug 回归)；满额拒『名额已满』；重复报名幂等	X-16
TC-X-17-E	多端登录会话互斥跨端	跨角色	P2	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 异地/新设备登录触发风控 2. 旧设备 token 仍调用	异常设备二次验证/拦截；旧设备 token 失效 401	X-17
TC-X-18-E	推送跨端送达	跨角色	P2	异常	已登录(默认 跨角色)；相关前置数据就绪	1. 推送内容含 XSS 载荷 2. 目标已设免打扰 3. 非目标角色收到	XSS 转义不执行；免打扰不推送；非目标角色不可见	X-18

权限流用例（派生自正常流）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-01-P	报告上传解析	规划师	P1	权限	已绑定家庭+孩子 B；募极生物 PDF	1. 访问非绑定家庭的数据(报告/任务/方案/订单) 2. 对非指派预约 confirm/cancel 3. 观察	非绑定家庭数据统一 403；confirm/cancel 增加归属校验，非指派调用被拒(高危越权修复)	T-3 / P-10
TC-X-02-P	报告审核入库	规划师	P1	权限	X-01 草稿	1. 访问非绑定家庭的数据(报告/任务/方案/订单) 2. 对非指派预约 confirm/cancel 3. 观察	非绑定家庭数据统一 403；confirm/cancel 增加归属校验，非指派调用被拒(高危越权修复)	T-4
TC-X-03-P	方案生成	家长	P1	权限	孩子 B 有报告；已购会员	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	P-13
TC-X-04-P	方案批准+激活	规划师	P1	权限	X-03 方案 generated	1. 访问非绑定家庭的数据(报告/任务/方案/订单) 2. 对非指派预约 confirm/cancel 3. 观察	非绑定家庭数据统一 403；confirm/cancel 增加归属校验，非指派调用被拒(高危越权修复)	T-6 / T-7
TC-X-05-P	任务打卡	孩子	P1	权限	X-04 已生成方案任务	1. 孩子端调用编辑/删除/切家长接口或拼家长路由 2. 观察拦截	孩子端无编辑/删除/切家长入口；直接调用被 role 校验拒绝(403/401)，不越权操作家庭数据	C-7 / C-2
TC-X-06-P	任务审核	规划师	P1	权限	X-05 已提交	1. 访问非绑定家庭的数据(报告/任务/方案/订单) 2. 对非指派预约 confirm/cancel 3. 观察	非绑定家庭数据统一 403；confirm/cancel 增加归属校验，非指派调用被拒(高危越权修复)	T-9 / P-06
TC-X-07-P	全局统计	运营	P1	权限	以上步骤已执行	1. 非 admin 角色访问管理端接口(统计/方案/报告解析/商品/勋章/供应商/活动/知识库) 2. 观察	非 admin 角色访问管理端接口统一 401/403，不泄露后台数据	A-02
TC-X-08-P	幂等与回滚（主链路健壮性）	多角色	P1	权限	X-04 已 active 方案	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	T-8 / P-09a / C-8
TC-X-09-P	AI 方案送审闭环	多角色	P1	权限	家长已生成方案(generated)	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	P-44 / T-06 / T-07
TC-X-10-P	报告对比趋势闭环	多角色	P2	权限	同一孩子多次上传同类型报告	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	P-25 / T-21
TC-X-11-P	消息通知闭环	多角色	P1	权限	跨角色消息配置就绪	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	P-65 / T-19 / C-15
TC-X-12-P	会员权益闭环	多角色	P1	权限	家长未购会员	1. 以当前角色调用他人/非绑定家庭数据接口(报告/任务/方案/订单/能量) 2. 观察	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	P-58 / P-16

本轮扩展权限流（派生自新增场景）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-13-P	报告代传跨角色闭环	跨角色	P1	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-13
TC-X-14-P	解绑/重分配跨角色协	跨角色	P1	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-14
TC-X-15-P	注销/数据导出跨角色	跨角色	P1	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-15
TC-X-16-P	活动名额并发 E2E	跨角色	P0	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-16
TC-X-17-P	多端登录会话互斥跨端	跨角色	P1	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-17
TC-X-18-P	推送跨端送达	跨角色	P1	权限	已登录(默认 跨角色)；相关前置数据就绪	1. 跨角色调用他人/非绑定家庭数据接口 2. 观察拦截	非归属数据访问统一 403/401，不泄露他人数据；横向越权被拒	X-18

五维指标变化专项用例（本轮新增 SC-X-19~21）

完整用户故事见 ../user-scenarios/07-five-dimension.md（ED-15~17）。每条含正常流 + 具体异常流(-E) + 权限流(-P)。

正常流

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-19	五维能量跨角色数据隔离	跨角色	P0	功能	家庭1（A+B+C）、绑定家庭 F2（T）、无关家庭 F9	1. 各方查自身/归属成员能量概览/流水/评分历史 2. 越权查他人/非绑定家庭	归属数据可见；越权查他人/非绑定 401/403	X-19
TC-X-20	五维能量流水溯源一致性	跨角色	P0	功能	成员 B 混合来源流水（任务/打卡/心愿扣减/手动）	1. 拉 EnergyLog 按时间排序 2. 逐条校验 balanceAfter==prev+amount 3. 校验 totalEarned-totalSpent==balance	全部一致；任一不一致报警并定位	X-20
TC-X-21	多来源并发同成员能量变动	跨角色	P0	功能	B 某维度当日未触顶；多触发同时到达	1. 并发提交任务审批+打卡+小游戏+活动 2. 校验总额/流水	每笔原子加、不超 DailyLimit、无重复加、最终 balance 与流水合计一致	X-21

异常流（-E，具体故障注入）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-19-E	五维能量跨角色隔离	跨角色	P1	异常	家庭1 / F2 / F9	1. 孩子 token 查家长/规划师/运营接口 2. 家长查其他家庭成员 3. 规划师查 F9 4. 运营无工单导出	1. 401/403 2. 403 3. 403 4. 越权导出拒	X-19
TC-X-20-E	五维能量对账	跨角色	P1	异常	B 混合流水 + 造"不一致断点""负流水无对应"	1. 人为制造 balanceAfter≠prev+amount 的断点 2. 删除负流水对应记录	1. 报警并定位断点（不静默通过）2. 负流水必有对应负记录、余额不为负；不一致报警	X-20
TC-X-21-E	多来源并发能量	跨角色	P1	异常	B 维度当日接近上限	1. 并发触顶 2. 部分触发失败 3. 网络重试	1. 最后到达被拒/截断、总额不超上限 2. 已成功保留、失败回滚不残半笔 3. 重试幂等不因重试多加	X-21

权限流（-P）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-19-P	五维能量跨角色隔离	跨角色	P0	权限	家庭1 / F2 / F9	1. 横向越权查他人/非绑定家庭能量接口	横向越权统一 403/401、不泄露他人数据	X-19
TC-X-20-P	五维能量对账	跨角色	P1	权限	家庭1 + F9	1. 家长 A 对 F9 成员做能量对账/导出	非本家庭数据 403、不泄露	X-20
TC-X-21-P	多来源并发能量	跨角色	P1	权限	家庭1 + F9	1. 家长 A 触发 F9 成员并发能量变更	非本家庭成员变更 403	X-21

非功能测试用例（性能 / 兼容 / 安全）

非功能维度覆盖主链路并发/限流、跨角色越权与隔离、多端会话互斥、文件上传统一校验。（越权/上传拒绝/权限提升等见 e2e/api/nonfunc-security.spec.js；并发隔离 TC-X-N01、限流稳定性 TC-X-N02、多端 UA 兼容 TC-X-N07 见 e2e/api/nonfunc-perf-compat.spec.js；TC-X-N05、TC-X-N08 参见 security 规格）

TC 编号	环节	角色	优先级	类型	前置条件	测试步骤	预期结果	关联场景/用例
TC-X-N01	报告上传解析	跨角色	P0	性能	多家庭并发(≥10 家庭)	1. 并发执行 上传→解析 2. 观察结果	无串报告；解析队列不堵；单链路 P95 ≤ 40s	X-01
TC-X-N02	方案生成	跨角色	P0	性能	多家庭同时生成方案	1. 并发 LangGraph 生成 2. 观察限流	触发 429 友好降级；不雪崩；恢复后继续	X-03
TC-X-N03	活动并发名额	跨角色	P0	性能	活动名额 100，瞬时 500 请求	1. 压测报名接口 2. 检查名额	不超卖；名额精准扣减；并发安全(对应真实超卖修复)	X-15
TC-X-N04	任务打卡	跨角色	P1	性能	全平台打卡高峰	1. 模拟高峰打卡并发	幂等不重复计分；响应稳定 ≤ 1s	X-05
TC-X-N05	主链路	跨角色	P0	安全	跨角色越权	1. 孩子 token 调家长/规划师接口 2. 家长调其他家庭	一律 401/403；数据隔离	X-01~X-06
TC-X-N06	数据导出	跨角色	P0	安全	导出授权	1. 用户 A 导出 2. 篡改 userId 导出 B	仅本人可导出；篡改 403；留痕	X-17
TC-X-N07	多端会话	跨角色	P1	兼容	iOS/Android/小程序/Web 同时在线	1. 多端登录同账号 2. 操作	会话互斥/同步正确；无状态错乱	X-18
TC-X-N08	主链路	跨角色	P0	安全	文件上传链路	1. 上传恶意/超大报告文件 2. 各端入口	全端统一校验拒绝；不执行	X-01