Steam Game Recommendation Application

담당 역할

Tech Stack

아키텍처 / ERD

Electron 앱이 내장된 Spring Boot JAR를 실행하고, Spring Boot는 정적 HTML/CSS/JS UI와 REST API를 함께 제공합니다. 추천 요청은 Controller → Service → CooccurrenceService → Repository 흐름으로 처리되며, H2 DB에 저장된 게임/태그/태그 동시 출현 데이터를 조회합니다. Steam 프로필 기반 추천은 Steam Web API를, 자유 텍스트 추천은 Gemini API를 호출하고, 외부 API 장애는 timeout, retry, circuit breaker, fallback으로 격리했습니다.

주요 기능

• ✓446개 Steam 태그 간 동시 출현 빈도를 사전 계산해 78,975건의 태그 쌍 데이터를 구성했습니다. 추천 시 실제 게임 생태계에서 자주 함께 등장하는 태그 쌍을 우선 탐색해 단순 태그 매칭보다 자연스러운 추천 결과를 제공하도록 설계했습니다.
• ✓Steam Web API로 보유 게임과 최근 플레이 게임을 조회하고, 해당 게임들의 태그 빈도를 분석해 사용자의 취향 태그를 추출했습니다. 추천 결과에서는 이미 보유한 게임을 제외해 새로 플레이할 수 있는 게임이 나오도록 처리했습니다.
• ✓Gemini API로 자연어 취향 문장을 Steam 태그 배열로 변환하고, 추출된 태그를 기존 Co-occurrence 추천 파이프라인으로 연결했습니다. 동일 입력은 6시간 TTL로 캐싱해 중복 API 호출을 줄였습니다.
• ✓7라운드 동안 두 게임 중 하나를 선택하는 인터랙티브 세션과 실제 리뷰를 보고 게임을 맞추는 미니게임을 구현했습니다. 세션은 TTL 기반 인메모리 캐시로 관리해 데스크탑 앱 환경에서 별도 서버 저장소 없이 동작하도록 구성했습니다.
• ✓Spring Boot JAR와 정적 UI를 Electron으로 패키징해 Windows에서 독립 실행 가능한 앱으로 배포했습니다. API Key는 소스 코드에 직접 포함하지 않고 로컬 설정 파일 또는 환경 변수를 통해 관리하도록 구성했습니다.

트러블슈팅

• 외부 API 장애 시 앱 응답 지연 문제문제 상황Steam API 또는 Gemini API가 지연되면 추천 요청도 함께 지연되고, 데스크탑 앱 전체가 멈춘 것처럼 보일 수 있었습니다.해결 방안WebClient 호출에 5초 timeout을 설정하고, Resilience4j Retry와 Circuit Breaker를 API별로 분리 적용했습니다.장애 시 fallback을 통해 빈 결과 또는 적절한 예외를 반환하도록 구성했습니다.결과외부 API 장애가 앱 전체 장애로 전파되지 않고, 기능별로 graceful degradation이 가능해졌습니다.
• 추천 결과가 비어버리는 문제문제 상황사용자가 선택한 태그 조합이 너무 구체적이거나 추천 결과가 이미 보유 게임과 겹치면 결과가 비어 404가 발생할 수 있었습니다.해결 방안Co-occurrence 쌍 탐색 실패 시 개별 태그 탐색으로 전환하고, 태그 수 축소, 조건 완화, 기본 태그 추천으로 이어지는 다단계 폴백 전략을 적용했습니다.결과희소한 태그 조합이나 보유 게임이 많은 사용자에게도 추천 결과를 반환할 수 있게 되었습니다.
• 게임 이름 인코딩 깨짐 문제문제 상황Steam 데이터 수집 과정에서 ®, ™, © 같은 특수문자가 깨져 게임 이름이 비정상적으로 표시되었습니다.해결 방안게임명 정제 로직과 Jackson 전역 String Serializer를 통해 잘못 인코딩된 패턴을 보정했습니다.URL 필드는 별도 분기해 잘못 변환되지 않도록 처리했습니다.결과사용자에게 노출되는 게임명이 정상적으로 표시되도록 개선했고, 문자열 정제 책임을 한 곳에서 관리할 수 있게 했습니다.

아쉬웠던 점