don

현재 문제점 상단 부분 위로 올라 가야 한다 너무 많이 찾이함 올라가게 하는 메뉴 기능 넣어야 하고.

스샷 첨부 해서 보여 주어야 한다.

그리고 가로로 했을때 튕긴다 로그 넣는 부분 넣어야 한다.

음악도 넣어야 한다 7개 정도

set 폴더 만들고 넣는 대로 순서대로 그리고 그뒤 랜덤

https://vnfmstjfxkd.tistory.com/728

# 안드로이드 푸시팝 힐링 게임 앱 개발 명령서

## 1. 프로젝트 목표

안드로이드 스마트폰과 태블릿에서 실행되는 고품질 푸시팝(Fidget Pop) 게임을 개발한다.

참고 이미지의 특징인 귀여운 캐릭터, 둥근 푸시팝 버튼, 부드러운 파스텔 색상, 장난감 특유의 볼록한 입체감을 참고한다. 단, 실제 이미지 파일이나 리소스가 프로젝트에 존재하는지 먼저 확인하고, 임의로 기존 리소스를 삭제하거나 교체하지 않는다.

게임의 핵심은 버튼을 눌렀을 때 실제 피젯 토이를 누르는 듯한 촉각적 느낌을 시각적 애니메이션과 사운드로 표현하는 것이다.

기본 개발 원칙:
- 기존 Android 프로젝트의 구조와 기술 스택을 먼저 분석한다.
- 기존 프로젝트가 Kotlin 기반이면 Kotlin을 사용하고, 기존 UI가 XML인지 Jetpack Compose인지 먼저 확인한다.
- 기존 UI 프레임워크와 아키텍처를 유지한다.
- minSdk, applicationId, 기존 앱 이름, 패키지명, 서명 설정을 임의로 변경하지 않는다.
- 기존 기능과 리소스를 임의로 삭제하거나 무관하게 수정하지 않는다.
- 모든 버튼은 실제로 작동해야 하며, 장식용 버튼만 만들어 놓지 않는다.
- 스마트폰, 태블릿, 세로 화면, 가로 화면을 모두 지원한다.
- 화면 크기가 달라져도 UI가 잘리거나 겹치지 않도록 한다.
- 기능을 구현한 후 빌드 오류와 런타임 오류를 확인한다.

## 2. 메인 게임 화면

메인 화면은 귀엽고 부드러운 힐링 피젯 토이 스타일로 구성한다.

포함할 요소:
1. 화면 상단의 게임 이름과 설정 버튼
2. 현재 레벨 표시
3. 현재 점수와 누적 터치 횟수
4. 남은 시간 또는 스톱워치 표시
5. 화면 중앙의 푸시팝 버튼 영역
6. 사운드 켜기/끄기 버튼
7. 게임 모드 변경 버튼
8. 초기화 및 일시정지 버튼

UI는 파스텔 핑크, 크림색, 연한 민트, 라벤더 등의 색상을 활용한다. 버튼에는 둥근 테두리, 부드러운 그림자, 오목하거나 볼록한 입체 효과를 적용한다.

화면을 불필요하게 복잡하게 만들지 말고, 실제 푸시팝 버튼을 누르는 동작이 가장 중요한 요소가 되도록 한다.

## 3. 푸시팝 버튼의 터치 효과

각 푸시팝 버튼을 터치하면 다음 효과를 구현한다.

A. 눌림 애니메이션
- 버튼이 짧은 시간 동안 안쪽으로 들어가는 듯한 효과를 구현한다.
- 버튼 크기와 그림자를 자연스럽게 변화시킨다.
- 손가락을 떼면 부드럽게 원래 형태로 복귀시킨다.
- 과도하게 튀거나 흔들리는 애니메이션은 피한다.
- 빠르게 연속 터치해도 애니메이션과 점수가 정상적으로 처리되어야 한다.

B. 발광 효과
- 버튼을 누르면 버튼 내부에서 빛이 발생한다.
- 발광 색상은 민트, 하늘색, 핑크, 노란색 등에서 선택할 수 있도록 한다.
- 버튼 중앙에서 빛이 퍼졌다가 서서히 사라지도록 한다.
- 주변 버튼에 빛이 번지는 효과는 선택적으로 적용한다.
- 발광 효과가 게임 성능을 떨어뜨리지 않도록 한다.

C. 테두리 반짝임
- 터치한 버튼의 외곽선에 밝은 빛이 나타난다.
- 테두리를 따라 짧은 빛의 흐름이나 반짝임이 지나가게 한다.
- 작은 별 모양이나 빛 입자를 추가할 수 있도록 한다.
- 반짝임은 짧고 부드럽게 끝나야 한다.

D. 파동 효과
- 버튼을 누른 지점에서 원형 파동이 바깥으로 퍼져 나간다.
- 파동의 반지름은 시간에 따라 증가한다.
- 파동이 커질수록 투명도가 감소한다.
- 파동이 버튼 경계 밖으로 나가지 않도록 클리핑한다.
- 필요하면 버튼 바깥쪽으로 퍼지는 별도의 파동 효과도 지원한다.

E. 촉감 표현
- 버튼이 눌리는 순간 미세한 햅틱 진동을 제공한다.
- 진동은 설정에서 켜거나 끌 수 있어야 한다.
- 기기가 진동을 지원하지 않거나 사용자가 비활성화한 경우에도 오류 없이 작동해야 한다.
- 접근성을 고려하여 시각 효과와 햅틱을 각각 독립적으로 제어할 수 있도록 한다.

## 4. 버튼 상태 및 게임 규칙

버튼마다 다음 상태를 관리한다.
- 기본 상태
- 눌리는 중
- 눌림 완료
- 애니메이션 진행 중

기본 모드에서는 버튼을 누를 때마다 눌림 애니메이션과 빛 효과를 재생하고 점수를 증가시킨다.

버튼을 눌렀다고 해서 영구적으로 비활성화하지 않는다. 사용자가 원하는 만큼 반복해서 누를 수 있어야 한다.

추가 모드에서는 버튼을 누르면 눌린 상태가 유지되고, 다시 누르면 원래 상태로 돌아오는 토글 방식을 지원한다.

게임 모드에 따라 버튼 상태 처리와 점수 계산을 분리한다. 빠른 연속 터치에서 중복 입력, 점수 중복 증가, 애니메이션 충돌이 발생하지 않도록 한다.

## 5. 게임 모드

다음 모드를 구현한다.

모드 A: 자유 플레이
- 시간 제한 없이 자유롭게 버튼을 누른다.
- 점수와 누적 터치 횟수를 기록한다.
- 힐링과 휴식에 집중한다.

모드 B: 타임 어택
- 30초, 60초, 120초 중 제한 시간을 선택한다.
- 제한 시간 동안 누른 횟수와 점수를 계산한다.
- 시간이 종료되면 결과 팝업을 표시한다.
- 다시 도전하기와 메인 화면으로 돌아가기 기능을 제공한다.

모드 C: 레벨 도전
- 목표 터치 횟수 또는 목표 점수를 달성하면 레벨이 올라간다.
- 레벨 상승 시 축하 애니메이션과 팝업을 표시한다.
- 다음 레벨의 목표를 보여준다.
- 레벨이 높아져도 버튼 조작이 불편해지지 않도록 한다.

모드 D: 패턴 따라 누르기
- 지정된 버튼을 순서대로 강조한다.
- 사용자가 같은 순서대로 터치하면 성공 처리한다.
- 성공할수록 패턴 길이가 증가한다.
- 틀렸을 때는 짧은 안내 효과와 재도전 버튼을 표시한다.

모든 모드는 정상적으로 전환되어야 하며, 모드를 변경할 때 이전 타이머와 애니메이션이 남아 있지 않도록 한다.

## 6. 점수, 레벨, 보상

다음 기능을 구현한다.
- 버튼을 누를 때 점수 획득
- 전체 누적 터치 횟수 표시
- 현재 레벨과 다음 레벨 목표 표시
- 연속 터치 콤보 보너스
- 개인 최고 기록 저장
- 타임 어택 최고 점수 저장
- 레벨 달성 시 시각적 보상
- 레벨업 팝업 및 효과음
- 게임 종료 후 결과 화면 표시

점수와 레벨은 UI 코드와 분리된 게임 상태 관리 로직에서 계산한다.

앱을 종료했다가 다시 실행해도 필요한 기록이 유지되도록 로컬 저장 기능을 구현한다. 저장할 항목과 초기화할 항목을 명확하게 분리한다.

## 7. 타이머 및 스톱워치

다음 기능을 제공한다.
- 자유 플레이 누적 시간
- 타임 어택 카운트다운
- 일시정지와 재개
- 남은 시간의 숫자 표시
- 종료 직전 시각적 알림
- 시간이 종료되면 자동으로 결과 팝업 표시
- 다시 시작 기능

타이머는 화면의 애니메이션 프레임 수에 의존하지 말고 실제 경과 시간을 기준으로 계산한다.

화면 회전이나 앱이 백그라운드로 이동하는 상황에서도 타이머가 잘못 계산되지 않도록 한다. 각 모드의 백그라운드 처리 정책을 명확하게 정한다.

## 8. 팝업과 숫자 애니메이션

다음 팝업을 구현한다.
- 레벨업 팝업
- 목표 달성 팝업
- 타임 어택 결과 팝업
- 일시정지 팝업
- 게임 재시작 확인 팝업
- 설정 팝업

버튼을 누르면 획득 점수인 +1, +5 등의 숫자가 버튼 근처에 잠시 나타났다 위쪽으로 이동하며 사라지는 플로팅 텍스트 효과를 구현한다.

레벨업 시 현재 레벨과 다음 레벨을 표시하고, 짧은 빛 효과와 축하 애니메이션을 재생한다.

팝업은 화면 크기에 맞게 배치하고 작은 화면에서도 버튼이 잘리지 않도록 한다. 팝업 바깥 영역을 터치했을 때 닫을지 여부는 팝업별로 명확히 정의한다.

## 9. 사운드 시스템

버튼을 누를 때 짧고 깨끗한 팝 사운드를 재생한다.

다음 사운드를 별도로 지원한다.
- 일반 버튼 클릭음
- 부드러운 크리스탈 클릭음
- 레벨업 효과음
- 성공 효과음
- 실패 효과음
- 타이머 종료 알림음

사운드는 설정 화면에서 켜거나 끌 수 있어야 한다. 가능하면 버튼마다 여러 소리를 무작위로 선택해 반복음의 단조로움을 줄인다.

빠르게 연속으로 터치해도 사운드가 지나치게 겹치거나 지연되지 않도록 한다. 짧은 효과음은 적절한 Android 오디오 재생 API를 사용하고 리소스 수명과 메모리를 관리한다.

사운드 파일이 없거나 재생에 실패해도 게임 자체는 정상적으로 작동해야 한다.

## 10. 화면 크기에 따른 버튼 자동 배치

이 기능은 필수 요구 사항이다.

버튼 개수를 화면 크기에 따라 고정하지 않는다.

스마트폰 세로 화면에서는 기본적으로 9~12개 정도의 버튼을 적절히 배치하고, 화면의 실제 사용 가능 영역이 넓어지면 버튼 개수를 자동으로 증가시킨다.

태블릿에서는 화면 너비와 높이에 따라 더 많은 버튼을 배치한다.

가로 화면에서는 가용 너비를 활용해 버튼 열 수를 늘리고, 세로 화면에서는 화면 높이와 너비에 맞게 행과 열을 조정한다.

구현 기준:
- 시스템 상태 표시줄, 내비게이션 바, 상단 메뉴와 하단 메뉴를 제외한 실제 사용 가능 영역을 계산한다.
- 화면 너비, 높이, 방향, 밀도 및 UI 여백을 고려한다.
- 버튼의 최소 크기와 최대 크기를 지정한다.
- 버튼이 너무 작아지지 않도록 최소 터치 영역을 확보한다.
- 남는 공간이 생기면 버튼 간격과 크기를 자연스럽게 조절한다.
- 화면이 넓으면 열 수를 늘리고, 화면이 높으면 행 수를 늘린다.
- 가로 화면에서는 불필요한 여백이 생기지 않도록 한다.
- 버튼 크기가 지나치게 커지거나 작아지지 않도록 한다.
- 버튼 수와 크기는 독립적으로 계산한다.
- 회전하거나 창 크기가 변경되면 레이아웃을 다시 계산한다.
- 화면이 바뀌어도 현재 점수, 레벨, 타이머, 게임 상태를 유지한다.

가능하다면 반응형 그리드 레이아웃을 사용한다. Jetpack Compose라면 적절한 LazyVerticalGrid 또는 사용자 지정 반응형 레이아웃을 고려하고, XML 기반이라면 현재 프로젝트 구조에 맞는 그리드 또는 사용자 지정 View 방식을 선택한다.

버튼 개수 계산은 별도 함수로 분리한다. 실제 가용 너비와 높이를 기반으로 행과 열을 계산하고, 화면 비율에 따라 버튼 크기를 결정한다.

버튼이 많아져도 불필요한 객체 생성이나 전체 화면 재구성으로 인해 프레임이 떨어지지 않도록 한다.

## 11. 태블릿과 가로 화면 최적화

- 휴대전화 세로 화면을 기본으로 지원한다.
- 휴대전화 가로 화면을 지원한다.
- 7~8인치 태블릿을 지원한다.
- 10인치 이상 태블릿을 지원한다.
- 큰 화면에서는 푸시팝 버튼 수를 늘린다.
- 태블릿에서는 상단 정보와 게임 영역을 균형 있게 배치한다.
- 가로 화면에서는 게임 영역을 넓게 사용한다.
- 화면 크기에 따라 버튼과 글자 크기를 별도로 조정한다.
- 태블릿에서 버튼이 지나치게 퍼지거나 빈 공간이 커지지 않도록 한다.
- 가능하면 폴더블 기기와 창 크기 변경도 고려한다.
- 화면 회전으로 게임 진행 상태가 초기화되지 않도록 한다.

## 12. 설정 화면

다음 설정을 제공한다.
- 효과음 켜기/끄기
- 배경음악 켜기/끄기
- 진동 켜기/끄기
- 발광 효과 켜기/끄기
- 파동 효과 켜기/끄기
- 테두리 반짝임 켜기/끄기
- 애니메이션 강도 선택
- 푸시팝 버튼 색상 테마 변경
- 버튼 개수 자동 조절 또는 수동 설정
- 게임 기록 초기화

설정은 앱 재실행 후에도 유지되도록 한다. 초기화는 사용자 확인을 받은 후 실행한다.

## 13. 성능 및 안정성

- 터치 반응이 빠르고 부드러워야 한다.
- 빠른 연속 터치에서도 입력이 누락되지 않도록 한다.
- 애니메이션이 종료된 후 관련 작업과 객체를 정리한다.
- 타이머와 사운드 객체가 불필요하게 누적되지 않도록 한다.
- 화면 회전 시 중복 타이머가 생성되지 않도록 한다.
- 앱이 백그라운드로 이동하거나 복귀할 때 상태를 안전하게 처리한다.
- 저사양 기기에서도 기본적인 게임 플레이가 가능해야 한다.
- 효과가 많아도 UI 스레드를 장시간 점유하지 않도록 한다.
- 접근성 설정으로 애니메이션을 줄일 수 있도록 한다.
- 모든 버튼에 명확한 접근성 설명을 제공한다.

## 14. 개발 진행 순서

1단계: 현재 프로젝트 파일과 구조를 분석한다.

2단계: 기존 UI 프레임워크, 리소스, 테마, SDK 설정을 확인한다.

3단계: 수정할 파일과 추가할 파일, 각 파일의 역할을 먼저 설명한다.

4단계: 메인 게임 화면과 반응형 버튼 그리드를 구현한다.

5단계: 버튼 눌림, 발광, 테두리 반짝임, 원형 파동 효과를 구현한다.

6단계: 사운드와 햅틱 진동을 구현한다.

7단계: 점수, 콤보, 레벨업, 팝업을 구현한다.

8단계: 타이머, 일시정지, 결과 화면을 구현한다.

9단계: 게임 모드와 기록 저장을 구현한다.

10단계: 태블릿과 가로 화면에서 레이아웃을 검증한다.

11단계: 빌드 및 런타임 테스트를 수행하고 오류를 수정한다.

12단계: 최종 변경 사항과 테스트 결과를 보고한다.

## 15. 최종 보고 요구 사항

개발이 완료되면 다음 내용을 정리한다.
- 변경된 파일의 전체 목록
- 새로 추가한 파일의 전체 목록
- 각 파일의 변경 이유
- 구현 완료된 기능과 미완성 기능
- 빌드 성공 또는 실패 여부
- 발생한 오류와 해결 방법
- 스마트폰 세로 화면 테스트 결과
- 가로 화면 테스트 결과
- 태블릿 화면 테스트 결과
- 타이머와 레벨 시스템 테스트 결과
- 효과음과 시각 효과 테스트 결과

기존 기능을 불필요하게 변경하지 않는다. 빌드가 성공했다고 실제 기기 테스트까지 완료했다고 보고하지 않는다.

먼저 현재 프로젝트를 분석한 뒤, 기존 구조에 가장 적합한 방식으로 구현을 진행한다. 기존 코드와 리소스를 확인하기 전에는 대규모 파일 교체를 시작하지 않는다.