Menu
로비 UI의 팝업 관리 및 뒤로가기(ESC) 로직을 검증합니다. PopupManager 등록 및 중복 입력 처리 여부를 확인합니다.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
인게임 핵심 시스템(GameManager, UIManager), 초기화 순서 안전성, UI 데이터 바인딩을 검증합니다.
타이틀 씬의 로그인 흐름(MVVM), 어드레서블 로딩, 앱 업데이트 관리를 검증합니다.
프로젝트 전체의 사운드 구현 패턴을 검증합니다. 싱글톤(Singleton) 대신 인터페이스 주입(DI) 방식의 사용을 권장합니다.
세션 변경사항을 분석하여 검증 스킬 누락을 탐지합니다. 기존 스킬을 동적으로 탐색하고, 새 스킬을 생성하거나 기존 스킬을 업데이트한 뒤 GEMINI.md를 관리합니다.
플레이어 데이터의 DTO/Service 구조, 암호화 처리, 로컬 저장소 정합성을 검증합니다.
프로젝트의 모든 verify 스킬을 순차 실행하여 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시 사용.
| name | verify-lobby-navigation |
| description | 로비 UI의 팝업 관리 및 뒤로가기(ESC) 로직을 검증합니다. PopupManager 등록 및 중복 입력 처리 여부를 확인합니다. |
로비 UI 시스템에서 팝업의 열기/닫기 동작이 중앙화된 PopupManager를 통해 관리되는지 검증합니다:
PopupManager.RegisterPopup을 호출하는지 확인PopupManager.CloseTopPopup과 연동되는지 확인Input.GetKeyDown(KeyCode.Escape)를 직접 처리하지 않는지 확인LobbyUIViewManager가 ISceneInitializer를 통해 PlayerDataDTO를 정상적으로 주입받는지 확인ISoundManager를 주입받아 사운드를 제어하는지 확인(권장)View, ViewModel)를 수정한 후| File | Purpose |
|---|---|
Assets/_Game/Scripts/Lobby/Core/UI/PopupManager.cs | 팝업 스택 및 입력 처리 관리자 |
Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs | 로비 UI 전체 관리자 |
Assets/_Game/Scripts/Lobby/Core/LobbyNavigator.cs | 로비 내비게이션 구현체 |
Assets/_Game/Scripts/Lobby/Core/LobbySubSystemService.cs | 서브시스템 초기화 서비스 |
Assets/_Game/Scripts/Lobby/LobbyViewModel.cs | 로비 메인 뷰모델 |
Assets/_Game/Scripts/Lobby/UI/Popups/InventoryView.cs | 인벤토리 팝업 뷰 |
Assets/_Game/Scripts/Lobby/UI/Popups/PostView.cs | 우편함 팝업 뷰 |
Assets/_Game/Scripts/Lobby/UI/Popups/QuestInfoView.cs | 퀘스트 정보 팝업 뷰 |
Assets/_Game/Scripts/Lobby/UI/Popups/StoreView.cs | 상점 팝업 뷰 |
Assets/_Game/Scripts/Lobby/OptionPopupView.cs | 옵션 팝업 뷰 (PopupManager 연동) |
Assets/_Game/Scripts/Data/DTOs/ScenePayloadDTO.cs | 씬 전환 통합 페이로드 DTO |
Assets/_Game/Scripts/Lobby/ChoosegamePopup.cs | 게임 선택 팝업 (중복 로딩 방지 적용) |
모든 로비 UI 스크립트에서 Input.GetKeyDown(KeyCode.Escape)를 직접 호출하는지 검사합니다. 이는 PopupManager와 충돌을 일으킬 수 있으므로 제거해야 합니다.
파일: Assets/_Game/Scripts/Lobby/**/*.cs
검사:
grep -r "Input.GetKeyDown(KeyCode.Escape)" Assets/_Game/Scripts/Lobby
PASS: 검색 결과가 없어야 함 (단, PopupManager 제외)
FAIL: 검색 결과가 존재함
수정: 해당 로직을 제거하고 PopupManager에 위임하거나, PopupManager의 이벤트를 구독하도록 변경
주요 팝업 뷰가 열릴 때 PopupManager.RegisterPopup을 호출하는지 검사합니다.
파일: InventoryView.cs, PostView.cs, QuestInfoView.cs, StoreView.cs 등
검사:
grep -r "PopupManager.Instance.RegisterPopup" Assets/_Game/Scripts/Lobby/UI/Popups
PASS: 각 팝업 스크립트 파일 내에서 RegisterPopup 호출이 확인됨 (또는 팝업을 생성하는 매니저(GameManager, LobbyNavigator)에서 호출됨)
FAIL: 특정 팝업 스크립트에서 호출이 누락되어 ESC 키로 닫히지 않음
수정: Open 관련 메서드 내에 RegisterPopup(CloseMethod) 추가 또는 생성 주체에서 등록 수행
LobbyNavigator 및 LobbySubSystemService가 인터페이스 기반으로 구현되고 주입되는지 확인합니다.
파일: LobbyNavigator.cs, LobbySubSystemService.cs, LobbyViewModel.cs
검사:
# 1. LobbyNavigator가 ILobbyNavigator를 구현하는지 확인
grep "class LobbyNavigator : ILobbyNavigator" Assets/_Game/Scripts/Lobby/Core/LobbyNavigator.cs
# 2. LobbyViewModel이 생성자에서 인터페이스를 주입받는지 확인
grep "public LobbyViewModel(ILobbyNavigator lobbyNavigator, ILobbySubSystemService lobbySubSystemService)" Assets/_Game/Scripts/Lobby/LobbyViewModel.cs
PASS: 위 구문들이 정확히 일치함 FAIL: 구체 클래스에 의존하거나 주입 방식이 아님 수정: 인터페이스 추상화 및 Constructor Injection 적용
LobbyUIViewManager가 ScenePayloadDTO를 통해 플레이어 및 서버 세션 데이터를 정상적으로 수신하는지 확인합니다.
파일: Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs
검사:
# OnInitialize에서 ScenePayloadDTO 캐스팅 및 데이터 할당 확인
grep "payload is InGame.Data.ScenePayloadDTO scenePayload" Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs
PASS: ScenePayloadDTO를 사용하여 m_playerData와 m_serverSession을 초기화함
FAIL: 여전히 PlayerDataDTO 단일 객체만 기대하거나 수동으로 싱글톤 참조
수정: ScenePayloadDTO 기반의 초기화 로직으로 변경
LobbyNavigator 및 하위 팝업(OptionPopupView 등)이 ISoundManager를 주입받아 사용하는지 확인합니다.
파일: LobbyNavigator.cs, OptionPopupView.cs
검사:
LobbyNavigator 생성자에서 ISoundManager를 인자로 받는지 확인.OptionPopupView.Initialize에서 ISoundManager를 전달받는지 확인.권장: 싱글톤(SoundManager.Instance)에 의존하지 않고 주입받은 인스턴스 사용 권장.
SceneLoader가 정확한 씬 범위를 검색하는지, 로비 진입 시 서버 데이터 동기화를 대기하는지 확인합니다.
파일: SceneLoader.cs, LobbySceneCompositionRoot.cs
검사:
# 1. SceneLoader의 RootGameObjects 기반 검색 로직 확인
grep "loadedScene.GetRootGameObjects()" Assets/_Game/Scripts/Lobby/SceneLoader.cs
# 2. LobbySceneCompositionRoot에서 서버 데이터 로딩(await) 대기 확인
grep "await playerService.LoadFromServerAsync()" Assets/_Game/Scripts/Lobby/Core/LobbySceneCompositionRoot.cs
PASS: GetRootGameObjects()를 통한 정밀 검색 확인, 로비 진입 전 서버 데이터 완결 대기(await) 확인
FAIL: 전체 객체 검색(FindObjectsByType) 잔존 또는 서버 데이터 로드 대기 누락
수정: 씬 로더 루프 개선 및 OnInitialize 내 await 추가
옵션 팝업 종료 시 m_popupService가 없을 때(에디터 단독 실행 등) NRE가 발생하지 않고 폴백 로직이 작동하는지 확인합니다.
파일: Assets/_Game/Scripts/Lobby/OptionPopupView.cs
검사:
# m_popupService null 체크 후 CloseTopPopup() 호출 및 else 블록의 Destroy 확인
grep -A 5 "if (m_popupService != null)" Assets/_Game/Scripts/Lobby/OptionPopupView.cs | grep -E "CloseTopPopup|Destroy"
PASS: if (m_popupService != null) 체크와 함께 CloseTopPopup() 및 폴백 Destroy가 모두 확인됨
FAIL: Null 체크 없이 바로 CloseTopPopup() 호출
수정: m_popupService 호출 전 Null 체크 및 자체 파괴 로직 추가
씬 로딩이 한 번에 하나만 진행되도록 SceneLoader에 전역 가드가 구현되어 있는지 확인합니다.
파일: Assets/_Game/Scripts/Lobby/SceneLoader.cs
검사:
# m_isLoading 플래그 선언 및 LoadSceneAsync에서의 체크 로직 확인
grep -E "bool m_isLoading|if (m_isLoading)" Assets/_Game/Scripts/Lobby/SceneLoader.cs
PASS: m_isLoading 필드와 이를 통한 중복 로딩 조기 리턴(LogWarning 포함) 로직 존재
FAIL: 전역 가드 누락 (중복 호출 시 예외 발생 또는 중첩 로딩 가능성)
수정: bool m_isLoading 변수 추가 및 LoadSceneAsync 시작 부분에 체크 로직 삽입
로비 진입 시 설정 데이터를 먼저 불러온 후 BGM을 재생하는지 확인합니다.
파일: Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs
검사:
# LoadSoundSetting 호출이 Play(SoundKeys.Lobby) 보다 위 라인에 있는지 확인
grep -nE "LoadSoundSetting|Play\(SoundKeys.Lobby" Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs
PASS: LoadSoundSetting이 BGM 재생보다 먼저 수행됨
FAIL: 순서 거꾸로 또는 호출 중 하나가 누락됨
수정: 초기화 블록의 코드 순서 조정
OptionPopupViewModel에서 LoadSettings와 초기값 할당이 Subscribe 이전에 수행되어 데이터 덮어쓰기 버그를 방지하는지 확인합니다.
파일: Assets/_Game/Scripts/Lobby/OptionPopupViewModel.cs
검사:
# Initialize() 메서드 내에서 Value 할당이 Subscribe 호출보다 위에 있는지 확인
grep -nE "EffectSoundVolume.Value =|EffectSoundVolume.Subscribe" Assets/_Game/Scripts/Lobby/OptionPopupViewModel.cs
PASS: .Value = 할당 라인이 .Subscribe 라인보다 위에 위치함
FAIL: Subscribe가 먼저 수행되어 초기값(0)이 로드된 설정을 덮어씀
수정: 구독 로직(Subscribe)을 초기값 설정 로직 아래로 이동
| 검사 항목 | 상태 | 파일/상세 |
|---|---|---|
| 개별 ESC 입력 | PASS | 발견되지 않음 |
| 팝업 등록 | PASS | InventoryView, OptionPopupView 등 확인됨 |
| 씬 로딩 정밀성 | PASS | RootObjects 기반 타겟팅 확인 |
| 서버 데이터 동기화 | PASS | 로비 진입 전 LoadFromServerAsync 대기 |
| NRE 방지 가드 | PASS | OptionPopupView 폴백 로직 확인 |
| 전역 로딩 가드 | PASS | SceneLoader m_isLoading 가드 확인 |
PopupManager.cs: 입력 처리를 담당하는 주체이므로 Input.GetKeyDown 사용 가능.