# 文档用例/场景 执行报告（文档驱动执行基座）

> 生成：`tests/doc-runner/run_doc_cases.py`，对本地后端 `http://127.0.0.1:9082` 真实打点。
> 进度写回本地侧车 `.tdd/test-progress.json`（不推送）；原 markdown 用例零侵入。

## 一、总览

| 维度 | 数量 |
| --- | --- |
| 结构化 TC（md） | 784 |
| 用户场景文件 | 10 |
| 已关联 spec（文件存在） | 42 |
| 可推导端点并执行 | 253 |
| 待补脚本（纯 UI/功能） | 489 |

## 二、执行判定分布（本轮新写回侧车）

| 状态 | 数量 | 含义 |
| --- | --- | --- |
| pass | 14 | HTTP 2xx 真实成功 |
| executed | 255 | 端点真实响应（非2xx，已打到后端） |
| fail | 0 | HTTP 5xx 后端真实报错 |
| blocked | 26 | 需登录态/数据/浏览器环境（401/403/连接失败） |
| needs_script | 499 | 无可推导端点，确属待补脚本 |

> 已脱离「零执行/未跟踪」：295 / 794 (37.2%)。

## 三、典型失败/阻塞样例（供研发/测试跟进）

| 锚点 | 状态 | 说明 | 证据 |
| --- | --- | --- | --- |
| `tests/test-cases/admin.md#TC-A-01` | blocked | 已关联自动化(login.spec.js)+真实冒烟 | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/admin.md#TC-A-02` | blocked | 已关联自动化(admin-panel.spec.js)+真实冒烟 | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/admin.md#TC-A-05` | blocked | 已关联自动化(health-report-audit.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/health-report-audit.spec.js |
| `tests/test-cases/admin.md#TC-A-12` | blocked | 已关联自动化(management.spec.js)+真实冒烟 | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/admin.md#TC-A-14` | blocked | 已关联自动化(health-knowledge-base.spec.js)+真实冒烟 | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/admin.md#TC-A-16` | blocked | 已关联自动化(admin-panel.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/admin-panel.spec.js |
| `tests/test-cases/admin.md#TC-A-N04` | blocked | 已关联自动化(nonfunc-perf-compat.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-perf-compat.spec.js |
| `tests/test-cases/admin.md#TC-A-N05` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/admin.md#TC-A-N06` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/child.md#TC-C-03` | blocked | 已关联自动化(mini-games.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/roles/child/mini-games.spec.js |
| `tests/test-cases/child.md#TC-C-08` | blocked | 已关联自动化(daily-checkin.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/roles/child/daily-checkin.spec.js |
| `tests/test-cases/child.md#TC-C-N07` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/guest.md#TC-G-N02` | blocked | 已关联自动化(nonfunc-perf-compat.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-perf-compat.spec.js |
| `tests/test-cases/guest.md#TC-G-N03` | blocked | 已关联自动化(nonfunc-perf-compat.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-perf-compat.spec.js |
| `tests/test-cases/guest.md#TC-G-N04` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/parent.md#TC-P-10` | blocked | 已关联自动化(dan-report-flow.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/dan-report-flow.spec.js |
| `tests/test-cases/parent.md#TC-P-13` | blocked | 已关联自动化(ai-plan-task-flow.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/ai-plan-task-flow.spec.js |
| `tests/test-cases/parent.md#TC-P-15` | blocked | 已关联自动化(family-management.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/roles/parent/family-management.spec.js |
| `tests/test-cases/parent.md#TC-P-33` | blocked | 已关联自动化(assessment-order-flow.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/assessment-order-flow.spec.js |
| `tests/test-cases/parent.md#TC-P-52` | blocked | 已关联自动化(product-purchase.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/product-purchase.spec.js |
| `tests/test-cases/parent.md#TC-P-N09` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/parent.md#TC-P-N11` | blocked | 已关联自动化(nonfunc-security.spec.js)，执行待浏览器/前端环境 | spec=D:\cfc\tests\e2e/api/nonfunc-security.spec.js |
| `tests/test-cases/admin.md#TC-A-01-E` | blocked | 端点推导(controller): GET /api/admin-auth | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/admin.md#TC-A-02-E` | blocked | 端点推导(controller): GET /api/stats | HTTP connection_error(TimeoutError) | timed out |
| `tests/test-cases/parent.md#TC-P-18` | blocked | 端点推导(explicit): POST /api/ai/health-coach/send | HTTP needs_auth(401) | {"code":401,"message":"请先登录","data":null} |

## 四、待补脚本缺口（needs_script，按优先级）

- P0：53 条待补脚本
- P1：248 条待补脚本
- P2：171 条待补脚本
- P3：17 条待补脚本

> 下一步：对 needs_script 用例按 P0→P3 编写 Playwright e2e（参考已关联的 42 个 spec 模板），
> 接入 CI 后纳入常态化回归，即可把「待补脚本」清零。