# 开发管理 - E2E测试详细规范

> **版本**: v2.0.0（AI可解析）  
> **创建日期**: 2026-01-20  
> **最后更新**: 2026-01-20  
> **维护者**: FFOA QA Team  
> **参考文档**: `05-ui-interaction-spec.md`, `09-test-scenarios.md`

---

## ✅ 机器读取区（必填）

### 执行摘要

| 字段 | 内容 |
|------|------|
| 执行器 | AI Agent + Playwright MCP |
| 最小断言 | 到达 + 成功/稳定 |
| 鉴权策略 | storageState |
| 等待策略 | domcontentloaded + 条件等待 |

### 用例结构

| 字段 | 说明 |
|------|------|
| 用例标题 | `#### 测试场景 X.Y.Z: {标题}` |
| 优先级 | `P0/P1/P2` |
| 步骤 | 有序列表 |
| 断言 | `预期结果`/`验证点` |

---

## 🧭 人类阅读区（可选）

### 测试范围与说明

- 覆盖工作项列表、工作项详情、状态更新、甘特图展示
- 断言包含“到达”与“成功/稳定”信号

#### 测试场景 1.1: 工作项列表加载与过滤（P1）

1. 使用 `storageState` 登录进入 `/devtracker/items`
2. 等待列表表格渲染完成
3. 选择状态过滤条件（如 REVIEWED）

预期结果：
- 到达断言：URL 为 `/devtracker/items`
- 成功/稳定断言：列表表格可见且过滤结果生效

#### 测试场景 1.2: 状态更新（P1）

1. 进入 `/devtracker/items/:id` 工作项详情页
2. 将状态更新为 `IN_DEVELOPMENT`
3. 将状态更新为 `IN_TESTING`

预期结果：
- 到达断言：详情页标题或工作项标题可见
- 成功断言：状态标签更新为新值

#### 测试场景 1.3: 甘特图展示（P1）

1. 使用 `storageState` 登录进入 `/devtracker/gantt`
2. 等待甘特图容器渲染完成

预期结果：
- 到达断言：URL 为 `/devtracker/gantt`
- 成功/稳定断言：甘特图时间轴与至少一个工作项条可见