E2e

---
name: e2e
description: E2E for [flow] tasks: Playwright on web, Patrol on Flutter, REST Assured on Spring. Run by qa right before review. 트리거: "E2E", "사용자 흐름 테스트".
---

# e2e

nereus:common 규칙을 따른다. 담당: qa.

## 1. 대상 선정
tasks 파일에서 `[flow]` 태그가 있고 이번 작업 단위에 포함된 태스크만. 그 외는 유닛/통합 테스트가 담당한다.

## 2. 스택별 실행

| 스택 | 도구 | 위치 | 명령 |
|---|---|---|---|
| 웹 | Playwright | `e2e/*.spec.ts` | `npx playwright test` |
| Flutter | integration_test + Patrol | `integration_test/*_test.dart` | `patrol test` (권한·알림 필요 시), 아니면 `flutter test integration_test` |
| Spring | REST Assured + Testcontainers | `src/test/java/**/*E2ETest.java` | `./gradlew test --tests '*E2ETest'` |

세팅이 없으면 `references/<도구>.md`대로 한 번 제안하고 승인 시 적용한다. 웹은 공식 `webapp-testing` 스킬의 Playwright 지침을 우선 참고한다.

## 3. 규칙
- 대기는 결정적으로(요소 상태, 응답 완료). `sleep`·고정 타임아웃 금지.
- 실패 시 2회 재시도. 3회 모두 실패 → 게이트 차단, build로 돌려보낸다(테스트 통과를 위해 제품 코드를 여기서 고치지 않는다).
- 간헐 실패(성공·실패 혼재)는 `.nereus/e2e-quarantine.json`에 `{test, reason, since}`로 격리하고 handoff.md 테스트 상태에 적는다. 삭제하지 않는다.
- 스크린샷·트레이스는 `.nereus/e2e-artifacts/`에.

## 4. 출력
`.nereus/e2e-report.md`: 흐름별 통과/실패/격리, 아티팩트 경로, 게이트 판정. 통과면 nereus:review.