DOCS/troubleshooting/250830_health_warning_recovery_system.md

3.2 KiB

체력 경고 및 회복 시스템 아이디어

개요

로빙의 체력이 낮아졌을 때 사용자에게 자연스럽게 회복을 유도하는 시스템

1. 체력 경고 메시지 시스템

트리거 조건

  • 체력이 30 이하로 떨어졌을 때

메시지 표시 위치

  • 체력바 위에 작은 크기로 표시

경고 메시지 (랜덤 표시)

  1. "조금 지쳤지만, 곧 다시 힘내서 더 잘할 수 있을 거예요."
  2. "살짝 힘이 빠졌지만, 괜찮아요. 금방 회복할 수 있어요."
  3. "지금은 잠시 느려졌지만, 곧 더 든든해질 거예요."
  4. "조금 힘들지만, 끝까지 함께하려고 해요."
  5. "잠깐만 회복하면 더 좋은 모습으로 같이할 수 있어요."

메시지 특징

  • 희망적이고 긍정적인 톤
  • 사용자에게 직접 요구하지 않고 자연스럽게 유도
  • 로빙이 의젓한 동료처럼 느껴지도록

2. 체력 회복 아이템 시스템

진입점

  • 체력바 왼쪽 하트 아이콘 클릭 시 작은 팝업 창 표시

체력 회복 아이템

1. 커피 (+15)

  • 설명: 빠르게 활력을 회복하는 기본 아이템
  • 컨셉: "짧게 기운을 북돋는 순간"
  • 활성화 레벨: 1-2 레벨부터

2. 샌드위치 (+30)

  • 설명: 든든하게 체력을 보강하는 중간 아이템
  • 컨셉: "이제 한동안 더 잘 버틸 수 있다"는 안정감
  • 활성화 레벨: 3-5 레벨부터

3. 안마의자 (+50)

  • 설명: 피로를 확실하게 풀어주는 강력한 회복 아이템
  • 컨셉: "다시 힘내서 끝까지 함께하겠다"는 의젓한 동료의 이미지
  • 활성화 레벨: 6 레벨부터

레벨별 아이템 활성화

  • 레벨 1-2: 커피만 활성화
  • 레벨 3-5: 커피 + 샌드위치 활성화
  • 레벨 6+: 커피 + 샌드위치 + 안마의자 모두 활성화

UI/UX 고려사항

  • 비활성화 아이템은 기존 UI 스타일에 맞게 비활성화 처리
  • 작은 팝업 창으로 표시하여 게임 플레이 방해 최소화
  • 아이템 클릭 시 즉시 체력 회복 및 팝업 닫기

3. 구현 계획

  1. 프론트엔드 목업 구현 (백엔드 연결 없이)
  2. 체력바 컴포넌트에 경고 메시지 시스템 추가
  3. 하트 아이콘 클릭 이벤트 및 팝업 컴포넌트 구현
  4. 레벨별 아이템 활성화 로직 구현
  5. 체력 회복 애니메이션 효과 추가

4. 구현 상태

  • 2025-08-30: UI 목업 구현 및 테스트 완료
  • 프론트엔드 UI 동작 확인
  • 레벨별 아이템 활성화 로직 정상 작동
  • 체력 경고 메시지 랜덤 표시 확인

5. 백엔드 연결 방안 (요약)

  • API 경로: Frontend → Gateway(8100) → rb8001 → robeing_stats 테이블
  • 체력 회복 API: POST /api/stats/{robeing_id}/health
  • 아이템 시스템: items 테이블 + user_items 테이블 추가 필요
  • 실시간 반영: WebSocket/SSE로 폴링 방식 개선
  • 레벨 연동: robeing_stats.level 컬럼 활용

6. 향후 확장 가능성

  • 아이템 사용 쿨타임 시스템
  • 아이템 개수 제한 및 획득 시스템
  • 특별 이벤트 아이템 추가
  • 체력 회복 시 로빙의 감사 메시지 표시