개발 과정에서 요청되고 조정된 Playground 요구사항을 정리한 문서입니다.

1) 제품 방향

  • Playground가 페이지의 메인 콘텐츠여야 함
  • 가벼운 오픈월드 시뮬레이션 느낌 유지
  • 무거운 엔진 의존 없이 로컬 실행 가능해야 함
  • 비주얼 방향: 카툰풍

2) 월드 기본 경험

  • 완전 탑뷰가 아닌 비스듬한 시점
  • 플레이어 이동:
    • WASD / 방향키
    • Shift 달리기
    • Space 시점 초기화
  • 카메라:
    • 마우스 드래그 이동
    • 휠 줌
  • 상호작용:
    • E 근처 상호작용
    • P 일시정지
  • 월드 좌측 끝 EXIT 지점에서 About 페이지로 복귀

3) NPC와 월드 콘텐츠

  • 기본 NPC 8명 사용:
    • 허승준, 김민수, 최민영, 정욱진, 서창근, 이진원, 박지호, 장동우
  • NPC 루틴/관계도 값이 존재해야 함
  • 시간 경과에 따라 퀘스트 상태가 갱신되어야 함
  • 이벤트 로그로 월드 상태를 추적 가능해야 함

4) 채팅과 LLM

  • NPC 채팅은 Google AI API 기반 실제 대화 지원
  • 모델 fallback 순서:
    1. gemini-2.0-flash
    2. gemini-2.5-pro
    3. gemma-3-27b-it
    4. gemma-3-12b-it
  • quota/rate-limit 상황에서 다음 모델로 자동 전환
  • 채팅 언어는 한국어 고정
  • NPC 기본 페르소나(20대 남성) + 성격값 반영

5) 캐릭터 생성

  • 사용자 입력 기반 캐릭터 생성 UI 필요
  • 생성 항목:
    • 이름
    • 성격(선택)
  • 생성된 캐릭터가 월드에 반영되어야 함
  • 브라우저 로컬 전용이 아니라 공유 상태 선호

6) UI/UX 요구사항

  • Playground에서 불필요한 전역 내비게이션 느낌 최소화
  • 월드를 최대한 화면 가득 보이게 구성
  • 채팅 입력창이 항상 명확히 보여야 함
  • 중복 채팅 입력 UI 금지(단일 흐름)
  • 맥북 전체화면/리사이즈에서도 레이아웃 안정성 확보
  • 모바일:
    • 가로모드 권장 힌트
    • 조이스틱 + 액션 버튼 제공

7) 시각/가독성

  • 캐릭터 라벨은 줌에 따라 가독성 유지
  • 텍스트 크기/캐릭터 가시성 강화
  • 카툰풍을 유지하되 색 과포화는 완화

8) 개발 워크플로

  • 기능 묶음 단위 커밋
  • Playground 진행사항을 Posts/devlog로 지속 기록
  • 로컬 확인 기반 반복 개선