# 04_test 测试目录说明

本目录用于存放每次需求对应的测试资料。每个需求必须创建一个与计划书同名的子目录。

文件名必须使用 ASCII，中文写在文件标题和正文中。AI 研发闭环不记录人工组织字段，只记录测试依据、范围、环境、命令、结果、缺陷、风险和结论。

## 推荐结构

```text
04_test/<requirement-id>/
├── test-plan.md
├── test-cases.md
├── test-run-record.md
├── defect-log.md
├── regression-verification.md
├── test-summary-report.md
├── uat-acceptance-report.md
├── smoke-test-report.md
├── test-design.md                # 可选：复杂需求使用
├── traceability-matrix.md        # 可选：复杂需求或高风险需求使用
└── evidence/
```

## 核心 8 个测试文档

| 编号 | 文件 | 用途 |
| --- | --- | --- |
| TD-01 | `test-plan.md` | 测试总纲：范围、目标、类型、环境、准入准出、风险 |
| TD-02 | `test-cases.md` | 测试用例：步骤、数据、预期、实际、状态、缺陷 |
| TD-03 | `test-run-record.md` | 执行记录：轮次、版本、命令、统计、失败和阻塞说明 |
| TD-04 | `defect-log.md` | 缺陷报告 / Bug 清单：复现、预期、实际、严重程度、回归 |
| TD-05 | `regression-verification.md` | 回归测试记录：修复验证和影响范围验证 |
| TD-06 | `test-summary-report.md` | 测试总结报告：覆盖、缺陷、质量评价、上线建议 |
| TD-07 | `uat-acceptance-report.md` | UAT 验收报告：业务验收范围、反馈和结论 |
| TD-08 | `smoke-test-report.md` | 上线冒烟测试报告：发布后核心路径检查 |

## 可选增强文档

- `test-design.md`：复杂需求、高风险需求或跨模块需求使用，记录测试设计方法和覆盖策略。
- `traceability-matrix.md`：用于追踪需求、任务、用例、执行结果和缺陷，防止漏测。

## evidence 目录

`evidence/` 存放截图、日志、接口响应、控制台输出、构建摘要、录屏或其它可验证材料。
