主题
[模块名] · 测试与验收文档
文档版本：0.01 ｜ 最近核对日期：[日期]
进入验证阶段且确有测试或验收内容时建立本文件；仅要求讨论或审阅时只交付结论。测试计划、预期结果和真实执行结果分别记录；尚未进入验证阶段时只写计划与“未开始”，不预填执行结果。“Agent 验证通过”只描述其证据覆盖范围，业务验收由业务方结论单独记录。
文档控制与范围
| 项目 | 内容 |
|---|---|
| 模块名称 | |
| 关联需求分析 | [链接] |
| 关联详细设计 | [链接] |
| 测试环境 | 前端、后端、数据库、浏览器及部署环境 |
| 测试数据 | 数据集、角色和清理方式 |
| 执行人/日期 | |
| 受测代码状态 | 提交号；存在未提交改动时记录受测文件范围，必要时附摘要 |
| 页面验证方式 | Agent 按改动范围执行的浏览器或端到端检查及覆盖范围；尚未进入验证阶段填“未开始”，必要页面检查因账号、工具或环境障碍未执行时记“验证受阻”及原因 |
| Agent 验证结论 | 尚未进入验证阶段填“未开始”；进入验证阶段后按检查注明通过、失败、受阻、用户豁免的未验证和未覆盖范围，附证据或原因 |
| 业务验收结论 | 未开始 / 待验收 / 有条件通过 / 通过 / 不适用；记录业务确认人、日期及范围 |
1. 测试用例与结果
按实际影响选择正常旅程、权限与数据范围、异常与回滚、文件和外部依赖等适用场景；并发和重复提交是否纳入遵循项目规则。执行后才填写实际结果。用例直接关联需求或验收编号，无须重复维护一份追踪矩阵。
| 用例 / 需求编号 | 角色/前置条件 | 操作 | 预期结果 | 实际结果 | 证据 | 结果 |
|---|---|---|---|---|---|---|
| TC-001 / AC-001 | 待执行 |
“未开始”仅用于尚未进入验证阶段；已进入验证阶段但尚未轮到的适用用例暂记“待执行”，交付前按根规则继续执行。“验证受阻”用于确有工具、环境、账号或授权障碍的必要检查；用户明确豁免的用例记“用户豁免的未验证”。未取得实际结果时不预填“通过”，并在证据或实际结果栏说明原因。
2. 验证结果汇总
证据按最新验证证据填写；后端回归核对 Surefire 标签筛选与目标测试报告，执行数量为零或目标测试缺失不能记为通过。
| 验证项 | 命令或入口 | 执行时间 | 结果摘要（目标测试及执行/失败/跳过数量） | 证据/日志 |
|---|---|---|---|---|
| 后端测试 | ||||
| 前端检查/构建 | ||||
| 接口/数据库实测 | ||||
文档检查（docs:check/verify.ps1） |
3. 缺陷与遗留问题
| 编号 | 问题 | 严重度 | 影响范围 | 处理/规避 | 复验结果 | 状态 |
|---|---|---|---|---|---|---|
| BUG-001 | 高/中/低 |
4. 验收结论
- 已覆盖的角色旅程：
- 未覆盖及原因：
- 已知限制与后续版本：
- Agent 验证结论与证据范围：
- 业务验收结论：未开始 / 待验收 / 有条件通过 / 通过 / 不适用
- 业务确认人及日期：
Agent 验证“通过”须有匹配的受测代码和可复核证据；业务验收“通过”须有业务方确认记录及覆盖范围。尚未进入验证阶段的“未开始”、必要检查的“验证失败”或“验证受阻”、用户豁免的“未验证”和用户“待验收”分别标注，不以计划或草稿推定通过。