scriptization-map.md 4.7 KB
结构化测试用例脚本化台账
生成时间：2026-11-05 22:49:36 生成器：
tests/scripts/scriptize_tc.py｜ 数据源：tests/test-cases/*.md规格：tests/e2e/api/generated/tc-scripted.spec.js｜ 数据：cases.json
一、总账
| 口径 | 数量 | 说明 |
|---|---|---|
文档用例（\| TC- 行） |
784 | 11 个 md 文件全量解析 |
生成的 test() |
784 | 1:1，无丢弃 |
| 唯一 TC 编号 | 784 | 全部唯一，无重复编号 |
可真实执行 active-api + active-probe + auth-probe |
344 | 需 TC_LIVE=1 授权联网 |
其中 auth-probe（未授权鉴权探针） |
209 | 不带 token，断言 401/403 |
已有脚本覆盖 linked-e2e |
38 | 文档关联的 spec 文件确实存在，本条仅作锚点 |
设计态 design-* |
402 | test.fixme，不打远程、不计通过 |
| 解析告警 | 0 | 见文末 |
二、按分级
| 分级 | 用例数 |
|---|---|
| design-fixture | 265 |
| auth-probe | 209 |
| active-api | 124 |
| design-contract | 68 |
| design-ui | 38 |
| linked-e2e | 38 |
| design-env | 31 |
| active-probe | 11 |
三、按来源文件
| 文件 | 用例数 |
|---|---|
| tests/test-cases/parent.md | 292 |
| tests/test-cases/teacher.md | 104 |
| tests/test-cases/admin.md | 84 |
| tests/test-cases/child.md | 82 |
| tests/test-cases/cross-role-e2e.md | 75 |
| tests/test-cases/guest.md | 41 |
| tests/test-cases/vendor.md | 39 |
| tests/test-cases/butler.md | 30 |
| tests/test-cases/human-butler.md | 21 |
| tests/test-cases/deep-dive-assessment-appointment.md | 10 |
| tests/test-cases/deep-dive-plan-activation.md | 6 |
四、按角色
| 角色 | 用例数 |
|---|---|
| 家长 | 324 |
| 规划师 | 123 |
| 运营 | 87 |
| 孩子 | 85 |
| 游客 | 41 |
| 服务商 | 39 |
| 跨角色 | 39 |
| 真人管家 | 18 |
| 多角色 | 15 |
| 系统 | 9 |
| 家长A vs 家长B | 1 |
| 规划师×2 | 1 |
| 非 teacher | 1 |
| 非指派用户 | 1 |
五、按优先级
| 优先级 | 用例数 |
|---|---|
| P1 | 401 |
| P2 | 269 |
| P0 | 91 |
| P3 | 23 |
六、按类型
| 类型 | 用例数 |
|---|---|
| 权限 | 249 |
| 异常 | 246 |
| 功能 | 216 |
| 安全 | 27 |
| 性能 | 21 |
| 接口 | 12 |
| 兼容 | 10 |
| 并发 | 1 |
| 数据 | 1 |
| 边界 | 1 |
七、按段落类别
| 类别 | 用例数 |
|---|---|
| 正常流/其他 | 253 |
| 异常流 | 238 |
| 权限流 | 237 |
| 非功能 | 56 |
八、闭环条件（重要）
本次交付的是脚本化骨架，不是「784 条已通过」。执行状态仍全部为 0，未伪造任何通过/失败。
| 缺口 | 现状 | 闭环方式 |
|---|---|---|
| 联网授权 | 未授权，全部用例默认 fixme | 测试负责人显式 TC_LIVE=1 并确认目标环境 |
| 真实断言 | active-api 仅空 body + code 集合断言 |
按 cases.json 补请求体与业务断言 |
| 设计态 402 条 | 缺 SPA / 夹具 / 压测授权 | 部署前端、装浏览器、补夹具后重跑生成器 |
linked-e2e 38 条 |
只做文档锚点，未重复执行既有 spec | 直接执行关联 spec 并回写结果 |
| 执行回写 | test-progress.json 侧车未更新 |
真实运行后按结果回写，避免「已自动化=已通过」误判 |
九、路由证据分级
| 级别 | 条数 | 依据 | 复核要求 |
|---|---|---|---|
inline |
20 | 用例原文写出的 /api 路径 |
无需 |
inherit |
35 | 派生自正常流基用例 | 无需 |
controller |
90 | 设计列 Controller 名 → 源码 file:line |
无需 |
doc-fuzzy |
190 | 接口文档章节中文词 → 源码真实路由 | 需人工复核模块级关联 |
linked-spec |
9 | 既有 spec 实际调用过的路径 | 建议复核 |
无 |
440 | 无可靠路由证据，保持设计态 | 需人工补 API 映射 |
免鉴权公开端点（login/register/send-code/wechat-login/direct-register/config/public/media/upload） 已从探针候选中排除，避免
auth-probe出现「接口本就公开」的假失败。
十、验证记录
| 项 | 命令 | 结果 |
|---|---|---|
| JS 语法 | node --check tc-scripted.spec.js |
通过 |
| JSON 完整性 | node -e require(cases.json) |
784 条，唯一编号 784 |
| 框架识别 | npx playwright test ... --list |
Total: 784 tests in 1 file |
| 默认零联网 | node .tdd/verify-scripted.cjs |
784 fixme / 0 apiCalls |
| LIVE 分级正确 | 同上（TC_LIVE=1） | 440 fixme / 344 apiCalls |
| 真实执行 | runner | 未执行：本机 safe-delete 守卫拦截 + 未授权联网 |
结论：784 条文档用例已 1:1 转为可识别的测试定义，但执行状态仍全部为 0， 不视为「已测」或「已通过」。
十一、解析告警
无。全部表格行与表头列数一致。