cfc/tests/test-cases

结构化测试用例（Test Cases）

本目录是 user-scenarios/ 的下游：每个场景派生为「正常流 + 异常流 + 权限流」多条用例。 用例可直接由手工 QA 执行，也与 ../e2e/roles/<role>/*.spec.js 的可执行规格一一对应。

字段规范

字段	说明
TC 编号	全局唯一，格式 TC-<角色前缀>-<序号>（G 游客 / P 家长 / C 孩子 / T 规划师 / A 运营 / S 服务商 / X 跨角色）。
所属场景	对应的 user-scenarios/<role>.md 场景编号（如 P-8）。
模块	业务域（家庭/任务/能量/测评/健康报告/方案/AI/商城/管理端…）。
角色	执行该用例的用户角色。
优先级	P0 主链路必过 · P1 重要功能 · P2 一般 · P3 边缘/异常。
类型	功能 / 接口 / 权限 / 异常 / 性能 / 兼容 / 安全。
前置条件	数据/状态/账号准备。
测试步骤	编号步骤，必要时含接口/操作。
预期结果	可判定的断言；含状态码/数据/UI 表现。
关联需求/设计	对应 AGENTS.md / API_REFERENCE.md 条款或控制器。
对应 e2e	已落地的 Playwright 规格路径（如有）。

通用前置

• 测试环境部署最新后端（含种子迁移）；管理端 http://<host>/admin/；小程序测试号 + wechat.test-mode: true。
• 六类账号：游客、家长 A、孩子 B（A 子账号）、规划师 T、运营 M、服务商 V；家庭「测试家庭1」含 A + B + 爷爷 C。
• 测试报告 PDF：募极生物肠道菌群报告样例（tests/data/ 下对应文件）。
• 每次用例前按 tests/e2e/reset-db.sh 或管理端还原数据，避免脏数据串扰。

通过标准（汇总门禁）

1. 所有 P0 用例（主链路、方案管理、报告上传、双角色边界）100% 通过。
2. 其余用例通过率 ≥ 95%，未通过项均有明确缺陷描述与可复现步骤。
3. 近期修复回归项（见黑盒方案第 5 节）全部通过：方案管理页白屏、成长计划页、勋章创建、供应商创建、活动审核撤回、知识库删除、长文文章、接口参数校验。
4. 双角色边界（家长↔孩子可切；孩子端不可切回家长；规划师可切回家长）必须全部通过，否则整体不通过。

文件索引

三类用例结构：每个角色文件在原有「正常流」用例之后，均追加了 ## 异常流用例（派生自正常流） 与 ## 权限流用例（派生自正常流） 两段。异常流编号后缀 -E、权限流后缀 -P，分别从每条正常流用例派生，实现「正常流 + 异常流 + 权限流」三类闭环。 当前三类（功能向）合计：正常流 202 + 异常流 202 + 权限流 202 = 606 条；外加非功能用例 56 条（## 非功能测试用例（性能/兼容/安全） 段，编号后缀 -N：性能 21 / 兼容 10 / 安全 25），全仓用例总计 662 条（截至 2026-10-31）。非功能用例已落地两枚接口冒烟规格：

• tests/e2e/api/nonfunc-security.spec.js（安全类 11 用例，覆盖 TC-G-N04 / TC-P-N09·N10·N11 / TC-A-N05·N06 / TC-C-N07 / TC-X-N05·N08）：鉴权/IDOR/权限提升/XSS/上传校验。
• tests/e2e/api/nonfunc-perf-compat.spec.js（性能/兼容类 5 活动用例 + 2 跳过待业务夹具/压测授权，覆盖 TC-G-N02·N03 / TC-A-N04 / TC-P-N02 / TC-X-N01·N02·N07）：限流稳定性/多端 UA 兼容/并发隔离/响应时间基线。 可直接 npx playwright test -c playwright.config.api.js --project=desktop 执行，提升接口层可执行覆盖率。剩余性能/兼容类用例（前端渲染、真实压测）因 CFC-ENV-001 远程无 SPA 与需 execute 档联网授权，保留为文档化设计。

文件	覆盖角色	正常流范围	异常流 / 权限流
guest.md	游客	TC-G-01~12	TC-G-NN-E / TC-G-NN-P（各 12 条）
parent.md	家长	TC-P-01~86	TC-P-NN-E / TC-P-NN-P（各 86 条）
child.md	孩子	TC-C-01~23	TC-C-NN-E / TC-C-NN-P（各 23 条）
teacher.md	规划师	TC-T-01~29	TC-T-NN-E / TC-T-NN-P（各 29 条）
admin.md	运营	TC-A-01~23	TC-A-NN-E / TC-A-NN-P（各 23 条）
vendor.md	服务商	TC-S-01~11	TC-S-NN-E / TC-S-NN-P（各 11 条）
cross-role-e2e.md	跨角色	TC-X-01~18	TC-X-NN-E / TC-X-NN-P（各 18 条，9 列格式）