Menu
플레이어 데이터의 DTO/Service 구조, 암호화 처리, 로컬 저장소 정합성을 검증합니다.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
인게임 핵심 시스템(GameManager, UIManager), 초기화 순서 안전성, UI 데이터 바인딩을 검증합니다.
로비 UI의 팝업 관리 및 뒤로가기(ESC) 로직을 검증합니다. PopupManager 등록 및 중복 입력 처리 여부를 확인합니다.
타이틀 씬의 로그인 흐름(MVVM), 어드레서블 로딩, 앱 업데이트 관리를 검증합니다.
프로젝트 전체의 사운드 구현 패턴을 검증합니다. 싱글톤(Singleton) 대신 인터페이스 주입(DI) 방식의 사용을 권장합니다.
세션 변경사항을 분석하여 검증 스킬 누락을 탐지합니다. 기존 스킬을 동적으로 탐색하고, 새 스킬을 생성하거나 기존 스킬을 업데이트한 뒤 GEMINI.md를 관리합니다.
프로젝트의 모든 verify 스킬을 순차 실행하여 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시 사용.
Based on SOC occupation classification
| name | verify-data-persistence |
| description | 플레이어 데이터의 DTO/Service 구조, 암호화 처리, 로컬 저장소 정합성을 검증합니다. |
플레이어 데이터 레이어의 현대화된 아키텍처(DTO/Service/Encryption/Repository)가 안전하고 올바르게 동작하는지 검증합니다:
PlayerDataDTO가 필드 위주로 구성되어 있고 로직을 포함하지 않는지 확인PlayerDataService가 IPlayerDataService를 구현하고 암호화/저장소 의존성을 명시적으로 주입받는지 확인EncryptionService를 통해 데이터가 암호화되어 저장되는지, PlayerPrefs가 잔존하지 않는지 확인await 여부) 및 실시간 저장 흐름 확인PlayerDataDTO.cs)를 변경했을 때PlayerDataService.cs, LocalPlayerDataRepository.cs)을 수정했을 때| File | Purpose |
|---|---|
Assets/_Game/Scripts/Data/DTOs/PlayerDataDTO.cs | 플레이어 데이터 전송 객체 (POCO) |
Assets/_Game/Scripts/Data/DTOs/ServerSessionDTO.cs | 서버 서비스 세션 DTO (Auth/GameData/Post) |
Assets/_Game/Scripts/Data/DTOs/ScenePayloadDTO.cs | 씬 전환 통합 페이로드 DTO |
Assets/_Game/Scripts/Data/Services/PlayerDataService.cs | 데이터 관리 비즈니스 로직 서비스 |
Assets/_Game/Scripts/Data/Services/EncryptionService.cs | RSA/AES 암호화 서비스 |
Assets/_Game/Scripts/Data/LocalPlayerDataRepository.cs | 로컬 파일 시스템 저장소 |
Assets/_Game/Scripts/Data/ServerManager.cs | 서버 서비스 팩토리 (싱글톤 제거 확인용) |
PlayerDataDTO가 데이터를 담는 용도로만 사용되는지, 필드명이 표준(PascalCase)을 따르는지 확인합니다.
파일: Assets/_Game/Scripts/Data/DTOs/PlayerDataDTO.cs
검사:
# 1. MonoBehaviour 상속 여부 확인 (상속하지 않아야 함)
grep "class PlayerDataDTO : MonoBehaviour" Assets/_Game/Scripts/Data/DTOs/PlayerDataDTO.cs
# 2. 필드 명명 규칙 확인 (모두 PascalCase 여부)
# lowercase로 시작하는 public 필드가 있는지 탐색
grep "public [a-z]" Assets/_Game/Scripts/Data/DTOs/PlayerDataDTO.cs
PASS: MonoBehaviour를 상속받지 않으며, 모든 public 필드가 대문자로 시작함
FAIL: MonoBehaviour 잔존 또는 camelCase 필드 존재
수정: POCO로 변경하고 필드명 일괄 수정
PlayerDataService의 생성자가 필요한 의존성을 모두 주입받고 있는지 확인합니다.
파일: Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
검사:
grep "public PlayerDataService(" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
PASS: EncryptionService 및 LocalPlayerDataRepository 매개변수 존재
FAIL: 기본 생성자만 있거나 싱글톤 참조 사용
수정: Constructor Injection 패턴 적용
LobbyUIViewManager 및 GameManager 등 주요 매니저들이 ScenePayloadDTO를 통해 데이터를 수신하고 초기화하는지 확인합니다.
검사:
# 1. GameManager에서의 페이로드 캐스팅 확인
grep "if (payload is ScenePayloadDTO scenePayload)" Assets/_Game/Scripts/InGame/Manager/GameManager.cs
# 2. LobbyUIViewManager에서의 페이로드 캐스팅 확인 (InGame.Data 네임스페이스 포함)
grep "if (payload is InGame.Data.ScenePayloadDTO scenePayload)" Assets/_Game/Scripts/Lobby/LobbyUIViewManager.cs
PASS: 두 파일 모두에서 ScenePayloadDTO를 사용한 조건문이 검색됨
FAIL: 검색되지 않거나 구식 방식으로 초기화 중
수정: OnInitialize(object payload) 메서드 내에서 ScenePayloadDTO 캐스팅 로직 구현
ServerManager가 싱글톤을 사용하지 않고, 팩토리로서 세션을 제공하는지 확인합니다.
파일: Assets/_Game/Scripts/Data/ServerManager.cs
검사:
# 1. Instance 필드/프로퍼티 부재 확인 (외부에서 인스턴스에 직접 접근하지 못해야 함)
grep "public static ServerManager Instance" Assets/_Game/Scripts/Data/ServerManager.cs
# 2. GetSession 메서드 존재 확인
grep "public ServerSessionDTO GetSession()" Assets/_Game/Scripts/Data/ServerManager.cs
PASS: Instance가 검색되지 않거나(또는 비공개), GetSession이 존재함
FAIL: Instance가 public으로 남아있거나 GetSession이 없음
수정: 싱글톤 패턴 제거 및 세션 반환 메서드 구현
PlayerDataService가 더 이상 AddCalculation을 사용하지 않고, 클라이언트 주도의 절대값 업로드를 수행하는지 확인합니다.
파일: PlayerDataService.cs, GameManager.cs
검사:
# 1. UpdateCurrencyDeltaAsync 메서드 폐기 확인 (grep 결과가 없어야 함)
grep "UpdateCurrencyDeltaAsync" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
# 2. AddCalculation 키워드 사용 여부 확인 (기존 코드에서 제거되었는지 확인)
grep "AddCalculation" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
# 3. GameManager.SaveGameResult에서 includeCurrency: true를 사용한 전체 업로드 확인
grep "UploadToServerAsync(includeCurrency: true)" Assets/_Game/Scripts/InGame/Manager/GameManager.cs
PASS: UpdateCurrencyDeltaAsync 및 AddCalculation이 발견되지 않으며, GameManager에서 절대값 업로드를 대기함
FAIL: 구식 합산 방식이 남아있거나 절대값 업로드 호출 누락
수정: UpdateCurrencyDeltaAsync 삭제 및 절대값 업로드 로직으로 통합
서버에 저장된 AddCalculation 데이터({"number": val, "operator": "+"})를 안전하게 파싱하여 로컬 m_data에 반영하는지 확인합니다.
파일: Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
검사:
# 1. targetData가 Object이고 "number" 키를 포함하는지 체크하는 로직 확인
grep "targetData.IsObject && targetData.Keys.Contains(\"number\")" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
# 2. 추출된 number가 m_data의 해당 필드(Currency1, Currency2 등)에 할당되는지 확인
grep -A 5 "targetData\[\"number\"\].ToString()" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
PASS: IsObject 확인 후 number 값을 추출하여 m_data 필드에 할당하는 로직 존재
FAIL: 오브젝트 형식 처리 누락 또는 m_data 반영 전 단순 리턴
수정: ParseIntSafe/ParseFloatSafe 내에 오브젝트 하위 필드 추출 및 할당 로직 보강
재화 변경 시 실시간 저장이 이루어지는지, 핵심 저장 로직이 씬 전환 전에 완료되는지 확인합니다.
검사:
# 1. PlayerDataService에서 재화 변경 시 SaveData() 호출 확인
grep -A 5 "m_data.Currency1 +=" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs | grep "SaveData()"
# 2. GameManager에서 씬 전환 전 SaveGameResult를 기다리는지(await) 확인
# SaveAndCleanupAsync가 Forget()으로 실행되는지 await로 실행되는지 체크
grep -n "SaveAndCleanupAsync().Forget()" Assets/_Game/Scripts/InGame/Manager/GameManager.cs
PASS: 재화 변경 시 즉시 저장되며, 중요 시점(GameOver 등)에서 저장 완결성이 보장됨
FAIL: Forget() 사용으로 인해 씬 전환 시 저장이 취소될 위험이 있거나 저장 호출 누락
수정: UniTaskVoid 대신 UniTask를 반환하고 씬 로드 전 await 처리
서버 로드 실패 시의 폴백 로직과 데이터 덮어쓰기 위험을 확인합니다.
파일: Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
검사:
# LoadFromServerAsync에서 실패 시(catch/null)의 처리 확인
grep -A 10 "catch (Exception ex)" Assets/_Game/Scripts/Data/Services/PlayerDataService.cs
PASS: 예외 발생 시 로그를 남기고 false를 반환하여 호출 측에서 인지 가능함
FAIL: 에러 발생 시 부분적인 데이터만 덮어씌워져 정합성이 깨질 위험이 있음
수정: 원자적(Atomic) 업데이트 로직 적용 또는 로드 실패 시 경고 팝업 고도화
| 검사 항목 | 상태 | 상세 |
|---|---|---|
| DTO 정합성 | PASS | POCO 및 PascalCase 준수 |
| 서비스 주입 | PASS | DI 패턴 및 GameDataService 주입 확인 |
| 서버 동기화 | PASS | 실시간 업로드 및 완결 대기 확인 |
| 데이터 유실 방지 | PASS | 씬 전환 시 저장 완결성 확인 |
| 보안성 | PASS | PlayerPrefs 완전 제거됨 |
PlayerPrefs는 볼륨 설정이나 간단한 옵션 데이터에는 예외적으로 허용될 수 있으나, 게임 진행 데이터에는 금지합니다.PlayerPrefs는 검사에서 제외합니다.