10강. 테스트 체크리스트: 정상·경계·오류 상황을 빠뜨리지 않고 확인하기

?1. 이번 강의에서 해결할 문제

한 번 정상 실행한 결과만으로는 경계값, 잘못된 설정, 빠른 반복과 긴 실행에서 생기는 문제를 알 수 없습니다. 프로젝트 특성에 맞는 작은 회귀 테스트 표를 만듭니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 정상·경계·오류·반복·장시간 범주를 구분합니다.
• 테스트마다 사전 조건, 절차, 예상·실제 결과를 기록합니다.
• 실패를 버그 또는 알려진 문제 문서로 연결합니다.

◇3. 핵심 개념

체크리스트는 “확인함” 표시가 아니라 같은 조건에서 다시 실행할 수 있는 짧은 테스트 명세입니다. 모든 조합을 검사하기보다 핵심 흐름이 깨질 위험이 큰 대표 조건을 선택합니다.

✎4. 단계별 실습

문서 작업 · 산출물: <PROJECT_ROOT>/docs/test-checklist.md

docs/test-checklist.md

# 테스트 체크리스트

검증 버전: 프로젝트에서 실제 사용한 버전  
검증 날짜: YYYY-MM-DD

| ID | 범주 | 사전 조건·절차 | 예상 결과 | 실제 결과 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T-01 | 정상 | 시작 후 핵심 흐름 1회 완료 | 결과와 다음 행동 표시 | 예상과 같음 | 통과 |
| T-02 | 경계 | 빈 목록·0점·최솟값 사용 | 오류 없이 빈 상태 표시 | 예상과 같음 | 통과 |
| T-03 | 오류 | 누락된 참조 또는 잘못된 입력 | 원인 안내 후 안전 종료 | 예외 발생 | 실패 |
| T-04 | 반복 | 핵심 동작을 빠르게 20회 실행 | 중복 처리 없음 | 예상과 같음 | 통과 |
| T-05 | 장시간 | 대표 흐름을 20분 유지 | 진행 불가·누적 오류 없음 | 확인 필요 | 미실행 |

## 실패 연결
- T-03 → `docs/bugs/001-missing-reference.md`

Unity Editor 작업: Console을 비운 뒤 Play Mode에서 상태 전환, 잘못된 Inspector 참조와 긴 플레이를 확인합니다.

웹 브라우저 작업: 작은 모바일 폭, 키보드 조작, 이미지 누락, 빠른 클릭과 Console 오류를 확인합니다.

코드 작업: Python·Java는 빈 입력, 잘못된 형식, 반복 실행과 긴 입력을 검사합니다.

완료 기준: 프로젝트에 맞는 테스트 8개 이상, 다섯 범주 중 네 범주 이상과 실제 결과가 있습니다.

§5. 작성 방식이 필요한 이유

반복 가능한 체크리스트는 변경 뒤 같은 품질 기준을 적용하게 합니다. 실패도 증거로 남겨 문제를 숨기는 대신 추적 가능한 작업으로 바꿉니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 정상 상황만 확인: 경계·오류·빠른 반복·긴 실행을 추가합니다.
• 예상 결과 없이 체크: 관찰할 화면, 값이나 메시지를 씁니다.
• 실패를 통과로 표시: 실제 결과를 그대로 쓰고 버그 문서로 연결합니다.
• 기능을 더 넣어 테스트 회피: 현재 범위를 먼저 검증합니다.

✎7. 직접 실습

✎직접 실습

docs/test-checklist.md에 테스트 8개 이상을 작성하고 실행하세요. 완료 기준은 정상, 경계, 잘못된 입력·설정, 빠른 반복, 긴 실행 중 프로젝트에 맞는 항목이 포함되고 모든 실행 항목에 실제 결과가 있는 것입니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 체크리스트에 사전 조건이 필요한 이유는 무엇인가요?
2. 빠른 반복 테스트로 찾을 수 있는 문제의 예는 무엇인가요?
3. 실패한 테스트는 다음에 어디로 연결해야 하나요?

■9. 핵심 요약

■핵심 요약

정상 실행뿐 아니라 경계, 오류, 반복과 긴 실행을 같은 형식으로 검증합니다. 실패를 숨기지 않고 재현 가능한 버그 기록으로 넘깁니다.