Travel_Run/Docs/feedback.md

# Feedback

날짜별 수정 내용과 다음 할 일을 기록합니다.

## 2026-07-07

### 수정한 점

- 튜토리얼 설명창을 공항 벽면 디지털 안내 패널/광고판 느낌의 이미지 프레임으로 교체
- 튜토리얼 안내는 자동으로 넘어가지 않고 확인 버튼 클릭으로만 닫히게 수정
- 튜토리얼 설명창 전체 크기를 원본 기준 약 60%로 조정
- 오프닝 만화 컷 중 시선이 분산되던 빈 말풍선을 제거한 버전으로 교체
- 왼쪽 HUD를 가로형 여권 페이지 패널로 교체
- 오프닝 만화 캐릭터를 바탕으로 만든 JJ 여권사진을 왼쪽 HUD에 적용
- 왼쪽 HUD는 화면을 덜 가리도록 원본 기준 약 50% 크기로 표시
- HP 3칸과 아이템 3칸을 2줄 그리드로 정렬하고, 캐릭터 사진은 두 줄 높이에 맞춤
- 필드에서 먹는 아이템 크기를 약 2배로 확대
- 오른쪽 HUD를 가로형 수하물 라벨/공항 스티커 이미지로 교체
- 오른쪽 HUD에는 거리와 이번 판 적립 마일리지만 표시
- 오른쪽 HUD는 맵에 따라 한국/일본/중국/미국 라벨을 자동으로 바꾸고, 원본 기준 약 60% 크기로 표시
- 오른쪽 HUD 글자는 부모 스케일 축소 대신 실제 크기로 배치해 회색 번짐을 줄임
- 튜토리얼 설명창 글자 위치를 오른쪽으로 조정
- 슬라이드 안내 이미지를 더 낮게 숙인 프레임으로 교체
- 라멘 무적 체험 뒤 방어막이 바로 나오지 않도록 안전 발판 간격 추가
- 튜토리얼 아이템 순서를 `초밥 -> 라멘 -> 방어막 -> 마일리지 카드 -> 운동화`로 조정
- 운동화 뒤에 속도 변화 설명과 출국 게이트까지 실전 연습 안내를 추가
- `Platform.prefab`에서 내장 장애물을 제거하고 발판 전용 프리팹으로 정리
- 출국 버튼 도장은 종이 배경이 같이 찍히지 않도록 투명 배경의 빨간 잉크 리소스로 교체
- 2단 점프 설명 이미지의 `X2` 표시를 더 크게 조정하고 외곽선을 추가
- 강제 피격 구간에서 점프 장애물과 슬라이드 장애물이 같은 위치에 겹치지 않도록 슬라이드 장애물 생성을 제거
- 결과 화면을 `출국 성공!` 여권 정산표 형태로 변경하고, 마일리지/시간/거리/보상만 간추려 표시
- 결과 화면 배경을 인천공항으로 바꾸고, 아이콘/글자/도장 위치를 여권 슬롯에 맞춰 재배치
- 결과 화면의 `인트로` 버튼을 `다음 여행지 가기`로 바꾸고 기존 공항 안내 버튼 에셋을 적용
- 결과 화면에서 `No cameras rendering` 경고가 뜨지 않도록 플로우 카메라를 보장하고, 버튼 글자를 밝은 색/외곽선으로 보정
- 왼쪽 HUD는 오른쪽 빈 장식 영역을 줄인 컴팩트 여권 배경으로 교체하고, HP/아이템 슬롯 비율과 간격을 재조정
- 면세점 화면을 내부 배경과 상품 카드형 UI로 교체하고, 도시락/방어막/운동화/마일리지 카드 구매 상태를 표시
- `Esc` 디버그 메뉴로 인트로, 게임 시작, 출국 실패, 출국 성공, 면세점, 지도 화면을 바로 확인할 수 있게 수정
- 스크립트 책임 분리 방향을 `Docs/refactor-plan.md`에 정리
- 맵별 정의와 코스 패턴을 `CourseStep` / `CourseProfile` 중심으로 나누는 리팩터링 방향을 문서화
- `PlatformSpawner.TutorialStep`을 독립 `CourseStep`, `CourseStepKind`, `CoursePlatformType` 파일로 분리
- `MapDefinition`, `MapDatabase`, `GameManager`가 새 `CourseStep` 타입을 참조하도록 정리
- `MapDatabase`의 맵별 생성 코드를 `Maps/Definitions/*Map.cs` 파일로 분리
- 공통 코스 조각 생성과 복제 로직을 `CourseStepFactory`로 이동

### 현재 문제

- `GameFlowManager`에 화면 흐름과 UI 생성 코드가 함께 몰려 있음
- `GameManager`에 플레이 진행, HUD, 튜토리얼, 도착 처리 코드가 함께 몰려 있음
- 코스 배열은 아직 `CourseProfile`로 묶이지 않고 `openingSteps`, `loopSteps`로 직접 연결됨
- `PlatformSpawner`에 fallback 코스 생성 코드가 아직 남아 있음
- 면세점 구매 아이템이 아직 장착 슬롯과 연결되지 않음
- 일본, 중국, 미국 맵의 실제 패턴과 난이도 차별화가 더 필요함
- 새 HUD 이미지들은 실제 플레이 화면에서 위치와 글자 크기를 한 번 더 미세 조정할 수 있음

### 다음 할 일

1. 튜토리얼 코스와 일본/중국/미국 일반 코스를 `CourseProfile`로 분리
2. `PlatformSpawner`의 fallback 코스 생성 책임을 `Course` 쪽으로 이동
3. `GameFlowManager`의 결과 화면, 면세점, 디버그 메뉴 UI를 View 클래스로 분리
4. `GameManager`의 HUD와 튜토리얼 안내창을 별도 스크립트로 분리
5. 면세점 구매 아이템을 장착 슬롯과 연결

## 2026-07-06

### 수정한 점

- 인트로 화면 방향을 세계지도, 여권, 스마트폰, 미니 비행기, 도장 버튼 구조로 잡음
- 오프닝 스토리를 만화 컷 형식으로 구성
- 캐릭터 의상 방향 결정
  - 오버핏 갈색 니트
  - 짙은 올리브 골덴 바지
  - 올리브색 숏비니
  - 운동화
  - 백팩
- 튜토리얼 맵을 인천공항 배경으로 구성
- 튜토리얼 순서를 점프, 2단 점프, 슬라이드, 강제 피격, 아이템 체험으로 정리
- 랜덤 발판 대신 검증된 패턴 기반 코스로 전환
- 도착 지점 구조 추가
  - 튜토리얼 출국 게이트
  - 일본 토리이
  - 중국 패방
  - 미국 자유의 여신상/뉴욕 도착지
- 미국 맵 배경을 뉴욕 배경으로 연결
- 문서 구조를 `README.md`와 `Docs/` 세부 문서로 분리
- 하단 미니맵을 런타임 HUD에서 제거
- 아이템 획득 시 짧은 링/반짝임/문구 이펙트 추가
- 라멘 무적/방어막 방어 성공 시 피격 깜빡임 대신 `SAFE`/`BLOCK` 피드백 표시
- 점프 마일리지 코인 경로를 5개 포물선으로 조정
- 점프 조작성을 쉽게 맞추기 위해 플레이어 점프 힘을 `700`에서 `600`으로 낮춤
- 속도가 붙을수록 점프 코인 경로의 가로 폭이 넓어지도록 보정
- 점프 코인 아크의 기본 가로/세로 폭을 더 크게 조정
- 출국 게이트 도착지는 만든 PNG 리소스를 우선 사용하도록 로딩 순서 수정
- 점프 코인 기본 아크 폭을 `1.3`, 최대 속도 폭을 `2.0`으로 확대
- 도착지점 스프라이트 로딩을 `Sprite`, `LoadAll<Sprite>`, `Texture2D`, 에디터 직접 경로 순서로 보강
- 점프 코인 기본 아크 폭을 다시 `1.5`, 최대 속도 폭을 `2.15`로 확대
- 점프 코인 기본 가로 폭만 `1.8`로 추가 확대
- 점프 코인 최대 속도 가로 폭을 `2.5`로 확대
- 도착 게이트가 나온 뒤에는 새 발판/장애물 코스가 더 스폰되지 않도록 수정
- 아이템 설명창은 전체 아이템 줄 대신 해당 아이템 하나만 큰 이미지로 표시
- 도착 게이트가 생성될 때 전용 착지 발판을 함께 생성하도록 수정
- 미국 도착 지점 리소스 파일명을 `FinishGate_America_Liberty.png`로 정리
- 라멘 무적 아이템 지속 시간이 현재 `2.2초`임을 문서에 기록

### 현재 문제

- 면세점 구매 아이템이 아직 장착 슬롯과 연결되지 않음
- 일본, 중국, 미국 맵의 실제 패턴과 난이도 차별화가 더 필요함
- 도착 지점 이미지의 게임 내 세부 크기는 실제 플레이로 더 조정해야 함

### 다음 할 일

1. 면세점 구매 아이템을 장착 슬롯과 연결
2. 일본, 중국, 미국 맵의 실제 패턴과 난이도 차별화
3. 도착 지점 이미지의 실제 화면 크기를 플레이하면서 세부 조정
4. 컨셉 이펙트 이미지를 실제 개별 스프라이트로 분리할지 결정