majiayu000 QA Workflow - 기획서 기반 테스트 자동화
기획서에서 테스트 케이스를 추출하고 브라우저 테스트까지 수행하는 4단계 워크플로우입니다.
핵심 원칙
- Source of Truth: 기획서의 화면/기능이 TC의 기준
- Traceability: 모든 TC는 원본 화면과 매핑
- Executable: 생성된 TC는 바로 실행 가능한 형태
워크플로우 개요
Step 1: Extract → 기획서에서 화면/기능 추출
Step 2: TC Generate → 화면별 테스트 케이스 생성
Step 3: Excel Export → TC를 엑셀 파일로 내보내기
Step 4: Browser Test → 엑셀 기준으로 E2E 테스트 수행
Step 1: Extract (기획서 분석)
기획서(이미지, 텍스트, 링크)에서 다음 정보를 추출합니다.
추출 항목:
- 화면 목록 및 URL 패턴
- 각 화면의 주요 기능
- 사용자 인터랙션 (클릭, 입력, 스크롤 등)
- 화면 간 전환 흐름
- 입력 필드와 유효성 검증 규칙
사용자에게 요청:
QA 워크플로우를 시작합니다.
분석할 기획서를 공유해주세요. (이미지, 텍스트, 링크 모두 가능)
추가로 다음 정보가 있으면 알려주세요:
- 테스트할 서비스 URL (있는 경우)
- 테스트 계정 정보 (있는 경우)
Step 2: TC Generate (테스트 케이스 생성)
각 화면별로 테스트 케이스를 생성합니다.
TC 분류 체계
| 우선순위 | 설명 | 예시 |
|---|---|---|
| P0 - Critical | 핵심 비즈니스 플로우 | 로그인, 결제, 회원가입 |
| P1 - High | 주요 기능 | 검색, 필터링, 상세보기 |
| P2 - Medium | 보조 기능 | 정렬, 공유, 찜하기 |
| P3 - Low | 엣지 케이스 | 빈 상태, 에러 처리 |
TC 템플릿
### TC-[화면코드]-[번호]: [테스트 제목]
**우선순위**: P0/P1/P2/P3
**화면**: [화면명]
**원본 참조**: [기획서 페이지/위치]
**사전 조건**:
- [필요한 상태/데이터]
**테스트 단계**:
1. [행동] → [예상 결과]
2. [행동] → [예상 결과]
**기대 결과**:
- [검증할 내용]
**테스트 데이터**:
| 필드 | 값 | 비고 |
|------|-----|------|
| [입력필드] | [값] | [설명] |
화면별 필수 TC
모든 화면 공통:
- 화면 진입 확인
- 필수 요소 표시 확인
- 반응형 동작 (모바일/태블릿/PC)
폼 화면:
- 정상 입력 후 제출
- 필수 필드 누락
- 유효성 검증 실패
- 중복 제출 방지
목록 화면:
- 데이터 로딩
- 빈 상태 표시
- 페이지네이션/무한스크롤
- 필터/정렬
Step 3: Excel Export (엑셀 내보내기)
TC를 엑셀 파일로 내보냅니다.
엑셀 시트 구조
Sheet 1: TC 목록 (Summary)
| 열 | 내용 |
|---|---|
| A | TC ID |
| B | 화면 |
| C | 테스트 제목 |
| D | 우선순위 |
| E | 사전조건 |
| F | 테스트 단계 |
| G | 기대 결과 |
| H | 상태 (Pass/Fail/Skip) |
| I | 실행 일시 |
| J | 비고 |
Sheet 2: 화면별 커버리지
| 열 | 내용 |
|---|---|
| A | 화면명 |
| B | 총 TC 수 |
| C | P0 |
| G | Pass |
엑셀 생성 스크립트
Python(openpyxl) 또는 Node.js(xlsx)로 생성합니다.
생성된 엑셀 파일 경로를 안내합니다:
📁 [프로젝트경로]/qa-output/tc-[프로젝트명]-[날짜].xlsx
Step 4: Browser Test (Chrome MCP로 테스트)
Chrome MCP를 사용하여 실제 브라우저에서 TC를 수행합니다.
테스트 실행 흐름
1. 엑셀 파일의 TC 목록 확인
2. Chrome MCP로 브라우저 제어
3. TC 단계별로 액션 수행 및 검증
4. 결과 기록 (Pass/Fail + 스크린샷)
Chrome MCP 활용
페이지 이동:
[URL]로 이동해줘
요소 클릭:
"로그인" 버튼을 클릭해줘
텍스트 입력:
이메일 입력란에 "test@example.com"을 입력해줘
검증:
"환영합니다" 텍스트가 화면에 표시되는지 확인해줘
스크린샷:
현재 화면을 스크린샷으로 저장해줘
TC 실행 프로세스
각 TC에 대해 다음을 수행합니다:
- 사전 조건 확인: 필요한 상태/데이터 준비
- 단계별 실행: TC의 테스트 단계를 순서대로 수행
- 결과 검증: 기대 결과와 실제 결과 비교
- 결과 기록: Pass/Fail 판정 및 스크린샷 저장
실행 요청 형식
TC-[ID]를 실행해줘
또는
P0 우선순위 TC를 모두 실행해줘
또는
[화면명] 관련 TC를 실행해줘
결과 보고
테스트 완료 후 다음 형식으로 결과를 보고합니다:
## QA 테스트 결과 요약
**실행 일시**: YYYY-MM-DD HH:mm
**대상 서비스**: [URL]
**총 TC 수**: XX개
### 결과 현황
| 상태 | 개수 | 비율 |
|------|------|------|
| Pass | XX | XX% |
| Fail | XX | XX% |
| Skip | XX | XX% |
### 실패 TC 목록
| TC ID | 화면 | 제목 | 실패 사유 |
|-------|------|------|----------|
| [ID] | [화면] | [제목] | [스크린샷/에러] |
### 첨부 파일
- 📊 TC 엑셀: [경로]
- 📸 스크린샷: [경로]
상세 가이드
| 주제 | 참조 |
|---|---|
| TC 설계 패턴 | references/tc-patterns.md |
| 엑셀 생성 스크립트 | scripts/generate-excel.ts |