항목	내용
프로젝트명	🕹️ 7짱 오락실 - 출동! 동물특공대
테스트 기간	2025.05.20 ~ 2025.05.22
담당자 및 팀원	담당자: 이호정 / 팀원: 황유빈, 김지수, 배동초
테스트 환경	window 11, chrome

---

• 테스트 목적
  • 게임 전체 플로우 및 UI 흐름의 정상 작동 여부 확인
  • 캐릭터 이동, 충돌 판정, 점수 로직, 팝업 전환 기능 검증
  • Firebase 연동을 통한 점수 저장 및 베스트 랭킹 조회 확인
• 테스트 범위
  • 게임 시작 → 점수 증가 → 충돌 → 게임 종료 → 점수 저장 및 취소 → 인트로 복귀
  • 팝업 (게임 설명, 게임 오버, 저장창, 베스트 랭킹) 표시 및 일부 팝업의 ESC 키 제어
  • 저장창 내 입력값 유효성, 중복 닉네임 처리
  • 베스트 랭킹 팝업 내 Firebase 데이터 실시간 반영 확인
• 테스트 방법
  • 수동 테스트 중심
  • keydown 이벤트 기반 캐릭터 이동 및 충돌 반복
  • Firebase 저장 후 → 베스트 스코어 팝업 실시간 반영 여부 확인
  • 닉네임 중복 입력 시 초기화 및 재입력 처리 검증

🔍 주요 이슈 목록

ID	항목	재현 조건	실제 결과	예상 결과	심각도
BUG-01	닉네임 중복 후 인트로 복귀 안 됨	게임 오버 후, 기존 닉네임으로 저장 시도 → 중복 발생 → 저장 또는 취소 버튼 클릭	팝업은 닫히지만 인트로 화면으로 돌아가지 않음(게임 종료 상태 유지됨)	저장/취소 후 정상적으로 인트로 화면으로 전환	Major
BUG-02	TypeScript 내 이미지 경로 깨짐	빌드 후 TS 파일에서 상대경로로 이미지 import 하지 않은 경우	이미지가 정상 출력 되지 않고 깨짐	import 방식으로 변경한 경우 이미지가 정상 출력 됨	Major

---

• 주요 문제 요약

  • 닉네임 중복 처리 후 인트로로 돌아가는 초기화 로직 누락
    • 기존 닉네임 중복 시 저장 후 흐름이 끊기며 인트로로 복귀 불가

• 해결된 이슈

  • 닉네임 중복 시 흐름 정지 문제 해결
    • 저장 또는 취소 버튼 클릭 시 인트로로 돌아가지 않는 버그 수정
    • 중복 감지 후에도 정상적으로 상태 초기화 및 화면 복귀 처리 추가
  • 이미지 경로 불일치로 인한 빌드 후 깨짐 현상 해결
    • TypeScript 파일 내 상대 경로 사용 시, 빌드 환경에서 이미지가 정적으로 포함되지 않아 깨지는 문제가 발생
    • 이미지 최적화 및 정리 작업을 병행하면서 모든 이미지 경로를 import 방식으로 통일하고, 일괄 경로 수정 스크립트를 적용하여 문제 해결

• 추가 테스트 필요 여부

  • 브라우저 세션 만료 및 캐시 클리어 후 테스트
    • 새로고침하거나 캐시/세션을 지운 뒤에도 Firebase 저장/조회가 정상 동작하는지
  • 다중 탭 테스트
    • 같은 브라우저에서 여러 탭을 열고 각각 저장 시도할 경우 → Firebase 동기화 충돌이나 동시 쓰기 문제 없는지

• 향후 개선 방향

  • 반응형 UI 구조 개선
    • 현재 고정 해상도(920×600) 기반에서 벗어나, 추후 태블릿 및 모바일 환경에서도 플레이 가능하도록 유연한 반응형 레이아웃 도입
  • 캐릭터 선택 기능 도입
    • 다양한 캐릭터 중 원하는 캐릭터를 선택하고 플레이할 수 있는 선택창 UI 구성 필요
    • 선택한 캐릭터 정보는 게임 화면에서 반영되도록 구조 연결
  • 브라우저 호환성 테스트
    • Firefox, Safari 등 주요 브라우저에서 팝업, 입력창, Firebase 동기 반영이 정상 작동하는지 확인
  • 캐릭터 종류 추가 및 스타일링 다양화
    • 병아리 외 토끼, 개구리 등 개성 있는 캐릭터 추가
    • 각 캐릭터마다 별도의 이미지, 진화 단계, 애니메이션 등을 설정해 플레이 다양성 강화