Story: E2E 테스트 + 운영 가이드

메타

항목	값
Story ID	E-05-S-10
Epic	E-05 연동 자동화
상태	ready-for-dev
우선순위	P1
규모	M
담당 개발자	하록 (BE), 수민 (FE), 운영팀

---

사용자 스토리

As a 개발팀/운영팀,
I want 전체 연동 플로우를 테스트하고 운영 가이드를 정리하고 싶다,
So that 안정적으로 운영할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: E2E 테스트

항목	내용
Given	모든 구성 요소가 배포되었을 때
When	E2E 테스트를 실행하면
Then	정상 플로우가 성공적으로 완료된다

AC-02: 장애 시나리오 테스트

항목	내용
Given	E2E 테스트 환경에서
When	각 장애 시나리오를 테스트하면
Then	예외 처리가 정상 동작한다

AC-03: 운영 가이드 문서

항목	내용
Given	테스트 완료 후
When	운영 가이드를 작성하면
Then	장애 대응, 모니터링, 수동 개입 방법이 문서화된다

AC-04: 운영팀 교육

항목	내용
Given	운영 가이드 완료 후
When	운영팀 교육을 진행하면
Then	운영팀이 독립적으로 대응할 수 있다

---

태스크 분해

Task 1: E2E 테스트 시나리오 AC-01

• [ ] 1.1: 정상 플로우 테스트
  • 세션 생성 → Lock 획득 → SMS 수신 → 이메일 수신 → 완료
• [ ] 1.2: 테스트 데이터 준비 (테스트 SMS 발송 환경)

Task 2: 장애 시나리오 테스트 AC-02

• [ ] 2.1: Lock 타임아웃 테스트
• [ ] 2.2: SMS 미수신 테스트
• [ ] 2.3: WebSocket 재연결 테스트
• [ ] 2.4: 동시 Lock 요청 테스트

Task 3: 운영 가이드 AC-03

• [ ] 3.1: 일상 모니터링 체크리스트
• [ ] 3.2: 장애 유형별 대응 방법
• [ ] 3.3: 수동 모드 전환 가이드
• [ ] 3.4: SmsForwarder 장애 복구 가이드
• [ ] 3.5: FAQ 정리

Task 4: 교육 AC-04

• [ ] 4.1: 운영팀 핸즈온 세션
• [ ] 4.2: 시뮬레이션 훈련

---

테스트 시나리오

정상 플로우

1. 테스트 셀러 계정으로 연동 시작
2. "준비 완료" 클릭 → Lock 획득 확인
3. 테스트 SMS 발송 → 화면에 코드 표시 확인
4. 테스트 이메일 발송 → 화면에 코드 표시 확인
5. 연동 완료 확인

장애 시나리오

시나리오	테스트 방법	기대 결과
Lock 타임아웃	2분 대기	재시도 안내 표시
SMS 미수신	SMS 발송 안함	타임아웃 후 재시도
동시 요청	2명 동시 클릭	1명 Lock, 1명 대기
앱 장애	SmsForwarder 중지	어드민 알림

---

운영 가이드 목차

1. 개요
   - 시스템 구성
   - 핵심 컴포넌트

2. 일상 운영
   - 매일 체크리스트
   - 모니터링 대시보드

3. 장애 대응
   - Lock 관련 문제
   - SMS 수신 문제
   - 이메일 수신 문제
   - WebSocket 문제

4. 수동 개입
   - Lock 강제 해제
   - 수동 인증번호 입력
   - 수동 모드 전환

5. SmsForwarder 관리
   - 앱 재시작
   - 설정 변경
   - 장애 복구

6. FAQ

---

Dev Notes

의존성

• 모든 E-05 스토리 완료 후 진행

테스트 환경

• Staging 환경에서 E2E 테스트
• 테스트용 SMS 발송 (다른 번호에서)

---

생성일: 2026-01-20