🚀 제7 우주 QA - FRONTENDBOOTCAMP-13th/JS-07-7zzang-Arcade GitHub Wiki

1️⃣ 기본 정보

항목	내용
프로젝트명	🕹️ 7짱 오락실 - 제7 우주
테스트 기간	2025.05.20 ~ 2025.05.22
담당자 및 팀원	황유빈(PL)
테스트 환경	Windows 11 / macOS Sonoma Chrome 124.0, Edge, Safari 데스크탑 / 노트북 (FHD 기준 1920×1080)

2️⃣ 테스트 개요

테스트 목적
- 게임 로직 및 UI 동작 검증
- 충돌 처리(플레이어 총알 ↔ 적, 플레이어 ↔ 적 총알, 플레이어 ↔ 적 본체) 검증
- 점수 저장(localStorage & Firebase 연동) 기능 확인
- BGM on/off 및 ESC 키 제어 검증
테스트 범위
- 인트로 화면, How-Play 팝업, 게임 화면, 팝업(게임오버, 점수 저장, 점수 보기)
- 충돌 처리
  - 플레이어 총알 ↔ 일반 적
  - 플레이어 ↔ 적 본체
  - 플레이어 총알 ↔ 보스
  - 적(및 보스) 총알 ↔ 플레이어
- 각 충돌 시 폭발 이펙트, 점수/목숨 변화, 무적 상태 동작 확인
- 화면 밖으로 나간 총알 자동 제거
- 폭발 이펙트의 자동 삭제
테스트 방법
- 수동 테스트 중심 (크로스 브라우징 포함)
- 각 충돌 시나리오별로 플레이어 및 적/보스 위치 고정 후 반복 플레이
- Console 로그 확인(spawnExplosion, Player.explode(), score 변화 등)
- Firebase 상위 5점 랭킹 데이터 검증

🔍 주요 이슈 목록

ID	항목	재현 조건	실제 결과	예상 결과	심각도
BUG-01	총알 위치 잡기	플레이어 위치 중앙으로 총알이 발사	`const bulletX = this.x + this.width / 2- 넓이;`	총알이 중앙으로 잘 간다!	Minor
BUG-02	`object`가 중복 생성되는 문제	`pushState` → `popstate` 로직에서 매번 무조건 새 `<object>`만 생성	`currentObj.hidden = true;` `currentObj.style.display = 'none';`	오브젝트 중복을 잘 막았다.	Minor

3️⃣ 결론 및 개선 사항

주요 문제 요약
- 총알 위치 보정 오류 (BUG-01)
  - 플레이어 총알 발사 시 X축 기준 위치 계산식에 오타가 있어, 중앙이 아닌 좌측으로 치우쳐 발사되는 현상 발생
- 오브젝트 중복 생성 (BUG-02)
  - popstate 이벤트 핸들러에서 기존 <object> 엘리먼트를 숨기기만 하고, 매 이벤트마다 새로운 엘리먼트를 생성해 누적되는 문제 발생
해결된 이슈
- 총알 위치 정렬
  - 발사 위치 계산식을 this.x + (this.width / 2) - (bulletWidth / 2) 형태로 수정하여 플레이어 중앙에서 정확히 발사되도록 보정
- 중복 오브젝트 방지
  - popstate 핸들러 진입 시 기존 currentObj 유무를 체크하고, 이미 존재하면 재생성 로직을 스킵하도록 조건문 추가
추가 테스트 필요 여부
- 크로스 브라우징 검증
  - 수정된 충돌 처리 및 오브젝트 로직이 Edge, Safari 등 타 브라우저에서도 정상 동작하는지 확인
- 스트레스 테스트
  - 짧은 간격으로 빠르게 pushState/popstate를 반복 호출했을 때도 오브젝트가 중복되지 않고, 메모리 누수 없이 안정적으로 동작하는지 점검
- Firebase 연동 신뢰성
  - 네트워크 지연 시에도 점수 저장 및 조회가 오류 없이 처리되는지 시나리오별 재검증
향후 개선 방향
- 모듈화 및 코드 커버리지 강화
  - 충돌 처리, 오브젝트 관리, 상태 전환 로직 각각을 별도 모듈로 분리하고, Jest 등 단위 테스트 프레임워크로 기능별 커버리지를 80% 이상 확보
- 자동화 CI/CD 파이프라인
  - GitHub Actions 등을 도입해 코드 푸시 시 유닛 테스트·린트 검사·빌드 검증을 자동화하여 품질 보증

🚀 제7 우주 QA - FRONTENDBOOTCAMP-13th/JS-07-7zzang-Arcade GitHub Wiki

1️⃣ 기본 정보

2️⃣ 테스트 개요

3️⃣ 결론 및 개선 사항

7짱오락실 바로가기

⚠️ GitHub.com Fallback ⚠️

🚀 제7 우주 QA - FRONTENDBOOTCAMP-13th/JS-07-7zzang-Arcade GitHub Wiki

1️⃣ 기본 정보

2️⃣ 테스트 개요

3️⃣ 결론 및 개선 사항

7짱오락실 바로가기

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️