# 结构化测试用例脚本化台账

> 生成时间：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**，
> 不视为「已测」或「已通过」。

## 十一、解析告警

无。全部表格行与表头列数一致。