qaground 가이드

관심사·도구에 따라 트랙을 고르세요. 한 챌린지는 하나의 트랙에 속합니다.

1. 1요구사항을 읽는다

   챌린지 상단의 요구사항이 곧 검증 목표입니다. 무엇을 확인해야 하는지 먼저 파악하세요.

2. 2연습 대상을 연다

   제공된 연습 대상(샌드박스)이나 API 엔드포인트의 구조·셀렉터를 살펴봅니다.

3. 3테스트를 작성한다

   정상 경로뿐 아니라 경계·예외까지 직접 설계해 작성합니다.

4. 4제출하고 채점받는다

   채점 결과가 요구사항별로 표시되고, 모범 답안·피드백으로 빠진 부분을 보완합니다.

자동화는 작성한 Playwright 테스트의 단언이 통과하는지로 판정합니다(러너 연결 시 실제 실행, 미연결 시 구조·관련성 정적 채점).

수동은 작성한 케이스·리포트가 요구사항을 충족하는지로 채점하고 모범 답안을 공개합니다. 키가 연결되면 AI가 내용을 읽고 요구사항별 맞춤 피드백을 줍니다(배지 “AI 채점”). 그렇지 않으면 요구사항 연결 기준의 구조적 채점(배지 “임시 모드”)으로 동작합니다.

API는 요청을 실제로 보내고 단언·pm.test 결과로 통과 개수를 즉시 보여줍니다.

UI 자동화는 data-testid처럼 변하지 않는 셀렉터를 우선 쓰는 것이 안정적입니다. 텍스트·클래스·DOM 구조는 디자인이 바뀌면 깨지기 쉽습니다. 챌린지마다 안정적인 셀렉터를 제공하니 그대로 활용하세요.

await page.goto('/sandbox/login');
await page.getByTestId('email').fill('[email protected]');
await page.getByTestId('password').fill('secret');
await page.getByTestId('submit').click();
await expect(page.getByTestId('error')).toBeVisible();

상태 코드와 JSON 필드를 단언으로 확인하거나, 포스트맨 스타일 pm.test 스크립트로 더 세밀하게 검증할 수 있습니다. 성공 경로뿐 아니라 4xx·5xx 실패 경로까지 단언하는 것이 견고한 API 테스트입니다.

pm.test('상태 코드는 200', () => {
  pm.response.to.have.status(200);
});
pm.test('총 개수 메타데이터', () => {
  pm.expect(pm.response.json().total).to.eql(12);
});

하나의 시나리오에 사전조건 · 절차 · 기대 결과를 명확히 적고, 각 케이스가 어떤 요구사항을 검증하는지 연결합니다(추적성). 정상 경로만이 아니라 경계값과 예외 상황까지 빠짐없이 도출하는 것이 핵심입니다.

• 정상: 규칙대로 동작하는 대표 경로
• 경계: 한도·최소·최대 등 임계값 바로 안팎
• 예외: 빈 값·잘못된 형식·권한 없음 등 실패 경로