13강. 체크리스트 기반 테스트: 기능 변경 뒤 놓치기 쉬운 상황 점검하기

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

기능이 한 번 성공했다고 끝내면 잘못된 경로, 비어 있는 값, 빠른 연속 입력 같은 상황을 놓칩니다. 매번 머릿속 기억에 의존하지 않는 짧은 점검표가 필요합니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 정상·경계·실패·반복 상황을 나눈 테스트 표를 만듭니다.
• 각 항목에 예상 결과와 확인 방법을 적습니다.
• 자동화할 항목과 사람이 확인할 항목을 구분합니다.

◇3. 핵심 개념

체크리스트는 “기능 확인” 같은 추상적인 문장이 아니라 입력, 행동, 예상 결과가 드러나는 문장이어야 합니다. 새 버그를 발견하면 재현 항목을 추가해 다음 변경에서 다시 확인합니다. 모든 상황을 무한히 적기보다 사용 빈도와 실패 영향이 큰 항목부터 고릅니다.

✎4. 단계별 실습

Markdown · 파일 경로: docs/test-checklist.md

docs/test-checklist.md

# 점수 기능 테스트 체크리스트

| 상태 | 입력·행동 | 예상 결과 | 방법 | 완료 |
|---|---|---|---|---|
| 정상 | 정답 1회 처리 | 점수 +10 | 자동 | [ ] |
| 잘못된 경로 | 다른 폴더에서 실행 | 프로젝트 위치 안내 후 중단 | 수동 | [ ] |
| 누락된 참조 | 필수 설정 제거 | 읽을 수 있는 오류 표시 | 수동 | [ ] |
| 잘못된 설정 | 음수 시작 점수 | 검증 오류 발생 | 자동 | [ ] |
| 빠른 반복 | 정답 처리를 20회 연속 호출 | 중복·누락 없이 +200 | 자동 | [ ] |

## 기록
- 실행일:
- 확인한 버전:
- 실패 항목과 재현 문서 링크:

PowerShell · 실행 위치: D:\Projects\productivity-lab

Test-Path .\docs\test-checklist.md
npm.cmd test

예상 결과: 첫 명령은 True, 두 번째 명령은 현재 자동 테스트 결과를 표시합니다. 수동 항목은 실제 확인 후에만 체크합니다.

→5. 도구와 설정이 동작하는 이유

표의 상태와 예상 결과가 고정되면 변경 전후를 같은 기준으로 비교할 수 있습니다. 실패 항목을 재현 문서와 연결하면 체크 표시가 단순 기억이 아니라 확인 가능한 증거가 됩니다.

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

!자주 하는 실수

• ‘전체 확인’ 한 줄로 끝냄: 입력과 예상 결과를 한 항목씩 분리합니다.
• 항상 성공하는 상황만 검사: 잘못된 경로·참조·설정과 반복 실행을 넣습니다.
• 확인하지 않고 미리 체크: 실행일과 결과를 남긴 뒤 완료 표시합니다.
• 목록이 끝없이 커짐: 핵심 회귀 항목은 유지하고 일회성 조사 메모는 버그 기록으로 옮깁니다.

✎7. 직접 실습

✎직접 실습

자신의 웹 또는 게임 기능 하나에 대해 정상, 잘못된 경로, 누락된 참조, 잘못된 설정, 빠른 반복 실행을 포함한 5개 이상의 체크리스트를 작성하고 실제로 한 번 수행하세요.

?8. 이해 점검 질문 3개

?이해 점검

1. 좋은 체크리스트 항목에 입력과 예상 결과가 필요한 이유는 무엇인가요?
2. 새로 발견한 버그를 다음 점검표에 추가해야 하는 이유는 무엇인가요?
3. 자동 테스트와 수동 테스트 항목을 어떻게 나눌 수 있나요?

■9. 핵심 요약

■핵심 요약

체크리스트는 정상, 경계, 실패와 반복 상황을 같은 기준으로 다시 확인하게 합니다. 구체적인 행동과 예상 결과를 쓰고 실제 검증 증거와 연결합니다.