# PRD - 플레이어 인벤토리 시스템 ## 📋 기본 정보 - **프로젝트명**: Unity MVVM 게임 프로젝트 - **작성자**: 김기획 - **작성일**: 2024-01-01 - **버전**: v1.0 - **상태**: Approved ## 🎯 제품 개요 ### 목적 및 목표 - **핵심 목적**: 플레이어가 게임 내에서 획득한 아이템을 효율적으로 관리할 수 있는 시스템 구현 - **비즈니스 목표**: - 사용자 게임 플레이 시간 20% 증가 - 아이템 수집 요소를 통한 게임 재미 향상 - 향후 상점 시스템과 연동 기반 마련 - **성공 지표**: - 인벤토리 사용률 80% 이상 - 아이템 정렬/필터링 기능 사용률 60% 이상 - 인벤토리 관련 버그 리포트 월 5건 이하 ### 대상 사용자 - **주요 타겟**: 모바일 RPG 게임 플레이어 (20-35세) - **사용자 페르소나**: - 수집 욕구가 강한 플레이어 - 체계적인 아이템 관리를 선호하는 플레이어 - **사용 시나리오**: - 전투 후 전리품 확인 및 정리 - 퀘스트 아이템 관리 - 장비 업그레이드 전 비교 검토 ## 🔍 요구사항 ### 핵심 기능 (Core Features) #### 1. 기본 인벤토리 표시 - **설명**: 플레이어가 보유한 모든 아이템을 그리드 형태로 표시 - **우선순위**: High - **사용자 스토리**: "플레이어로서 나는 내가 가진 모든 아이템을 한눈에 볼 수 있어야 한다" - **수용 기준**: - [ ] 6x8 그리드 (48슬롯) 인벤토리 UI 구현 - [ ] 아이템 아이콘, 수량, 등급 표시 - [ ] 빈 슬롯과 아이템 슬롯 구분 표시 - [ ] 스크롤 가능한 확장형 인벤토리 #### 2. 아이템 드래그 앤 드롭 - **설명**: 직관적인 아이템 이동 및 정렬 기능 - **우선순위**: High - **사용자 스토리**: "플레이어로서 나는 아이템을 드래그해서 원하는 위치로 이동할 수 있어야 한다" - **수용 기준**: - [ ] 아이템 드래그 시 반투명 이미지 표시 - [ ] 유효한 드롭 위치에서 하이라이트 표시 - [ ] 같은 아이템끼리 자동 스택킹 - [ ] 드롭 실패 시 원위치로 복귀 #### 3. 아이템 정보 툴팁 - **설명**: 아이템 호버/터치 시 상세 정보 표시 - **우선순위**: High - **사용자 스토리**: "플레이어로서 나는 아이템의 상세 정보를 쉽게 확인할 수 있어야 한다" - **수용 기준**: - [ ] 아이템 이름, 설명, 스탯 정보 표시 - [ ] 아이템 등급별 컬러 테마 적용 - [ ] 툴팁 위치 자동 조정 (화면 경계 고려) #### 4. 아이템 분류 및 필터링 - **설명**: 아이템 타입별 필터링 및 정렬 기능 - **우선순위**: Medium - **사용자 스토리**: "플레이어로서 나는 원하는 종류의 아이템만 골라서 볼 수 있어야 한다" - **수용 기준**: - [ ] 아이템 카테고리별 탭 (전체/무기/방어구/소비품/기타) - [ ] 등급별 정렬 (높음/낮음) - [ ] 획득 순서별 정렬 (최신순/오래된순) - [ ] 검색 기능 (아이템 이름 기반) ### 부가 기능 (Additional Features) - **아이템 즐겨찾기**: 자주 사용하는 아이템 북마크 - **일괄 판매**: 선택한 여러 아이템 동시 판매 - **아이템 비교**: 장비 아이템 간 스탯 비교 - **인벤토리 확장**: 게임 머니로 슬롯 확장 구매 ### 제외 사항 (Out of Scope) - 아이템 제작 시스템 - 아이템 거래 시스템 - 길드 창고 기능 - 아이템 경매장 ## 🎮 Unity 특화 요구사항 ### 플랫폼 요구사항 - **타겟 플랫폼**: Android, iOS - **Unity 버전**: Unity 2022.3 LTS 이상 - **해상도**: - 최소: 1280x720 (16:9) - 권장: 1920x1080 (16:9) - 지원: 18:9, 19.5:9 비율 - **성능 요구사항**: - 60 FPS 유지 - 메모리 사용량 100MB 이하 - 인벤토리 열기/닫기 0.3초 이내 ### 게임플레이 요소 - **장르**: 모바일 RPG - **컨트롤 방식**: 터치 기반 UI - **난이도**: 쉬움 (직관적 조작) - **세이브 시스템**: - 로컬 데이터 자동 저장 - 클라우드 세이브 지원 (Firebase) ## 📱 UI/UX 요구사항 ### 인터페이스 설계 - **인벤토리 창 크기**: 화면의 80% 영역 사용 - **그리드 셀 크기**: 균등한 정사각형 (64x64 픽셀 기준) - **여백**: 셀 간격 4픽셀, 외부 여백 16픽셀 - **애니메이션**: - 창 열기/닫기: Scale 애니메이션 (0.2초) - 아이템 드래그: Smooth follow (60fps) ### 색상 및 테마 - **배경**: 반투명 다크 오버레이 (80% 투명도) - **인벤토리 창**: 게임 UI 테마와 일치 - **등급별 색상**: - 일반: 회색 (#808080) - 고급: 초록 (#00FF00) - 희귀: 파랑 (#0080FF) - 영웅: 보라 (#8000FF) - 전설: 주황 (#FF8000) ### 접근성 - **다국어 지원**: 한국어, 영어, 일본어, 중국어(간체) - **터치 최적화**: 최소 터치 영역 44x44 픽셀 - **색약 지원**: 색상 외에 아이콘으로도 등급 구분 ## 🔧 기술적 제약사항 ### 성능 제약 - **최대 메모리 사용량**: 50MB (인벤토리 시스템 전체) - **로딩 시간**: 인벤토리 창 열기 0.1초 이내 - **배터리 사용량**: 기본 UI 대비 5% 이내 추가 사용 ### 호환성 - **최소 시스템 요구사항**: - Android 8.0 (API 26) 이상 - iOS 12.0 이상 - RAM 2GB 이상 - **외부 라이브러리**: - UGUI (Unity 내장) - R3 (반응형 프로그래밍) - VContainer (의존성 주입) - MessagePipe (메시징) ## 📅 일정 및 마일스톤 ### 주요 마일스톤 - **Phase 1 - 기본 UI 구현**: 2024-01-15 - 인벤토리 그리드 UI - 기본 아이템 표시 - **Phase 2 - 상호작용 구현**: 2024-01-30 - 드래그 앤 드롭 - 툴팁 시스템 - **Phase 3 - 고급 기능**: 2024-02-15 - 필터링 및 정렬 - 성능 최적화 ### 의존성 - **차단 요소**: - 아이템 데이터 모델 확정 필요 - 게임 UI 테마 가이드라인 필요 - **전제 조건**: - MVVM 아키텍처 구축 완료 - 기본 아이템 시스템 구현 ## 🔄 피드백 및 승인 ### 리뷰어 - [x] **기획자**: 김기획 - 2024-01-01 - [x] **개발 리드**: 박개발 - 2024-01-02 - [x] **UI/UX 디자이너**: 이디자인 - 2024-01-02 ### 변경 이력 | 버전 | 날짜 | 변경 사항 | 작성자 | |------|------|-----------|--------| | v1.0 | 2024-01-01 | 초기 작성 | 김기획 | --- ## 📝 참고 자료 - [모바일 RPG 인벤토리 UI 분석](https://example.com/mobile-rpg-inventory) - [Unity UGUI Best Practices](https://docs.unity3d.com/Packages/com.unity.ugui@1.0/manual/index.html) - [사용자 경험 연구 보고서](https://example.com/ux-research) ## 🎯 성공 측정 방법 - **Analytics 이벤트**: - inventory_opened (인벤토리 열기) - item_dragged (아이템 드래그) - filter_used (필터 사용) - tooltip_viewed (툴팁 조회) - **A/B 테스트**: 그리드 크기 (6x8 vs 5x10) 효과 측정 - **사용자 피드백**: 앱 스토어 리뷰, 커뮤니티 피드백 모니터링