프로젝트 개요

Poker-Mate는 홀덤 플레이어를 위한 AI 백엔드 서비스입니다.

• 도메인 특화
  일반 LLM이 아닌, 포커 룰과 확률을 이해하는 AI
• 실시간성
  SSE(Server-Sent Events)를 이용한 초저지연 응답
• 멀티 페르소나
  상황에 따라 '전략가'와 '위로자'로 변신

사용자 스토리 (User Stories)

1. 전략 코칭

   "지금 내 핸드로 올인해도 될까?" (실시간 조언)

2. 멘탈 케어

   "배드 빗을 당해서 너무 화가 나..." (위로와 지지)

3. 룰 가이드

   "이 상황에서 스트레이트가 이겨?" (정확한 룰 설명)

4. 개인화

   내 플레이 스타일을 기억하는 AI 파트너

핵심 기능 (Key Features)

1. 실시간 스트리밍 (Real-time Streaming)

• SSE 프로토콜 사용
• LLM의 답변을 기다리지 않고 토큰 단위로 즉시 전송

2. 하이브리드 메모리 (Hybrid Memory)

• 단기 기억 (Redis): 최근 10턴 대화 유지 (빠른 속도)
• 장기 기억 (MySQL): 세션 종료 후 플레이 스타일 요약 저장

동적 페르소나 (Dynamic Persona)

상황에 맞춰 System Prompt를 실시간으로 교체합니다.

모드	특징
전략가 (Strategist)	수학적 확률, 팟 오즈 계산, GTO 플레이 권장
동반자 (Companion)	정서적 지지, 멘탈 관리, 따뜻한 위로

도전과 해결 (Challenges)

Q. 게임 템포가 너무 빠르다면?

Solution: Redis Caching & Async
자주 묻는 질문은 캐시(5ms)로, 분석은 비동기로 처리하여 메인 스레드 블로킹 방지

Q. AI가 거짓말(할루시네이션)을 한다면?

Solution: Context Injection
룰 질문 시, 검증된 **'포커 확률표(JSON)'**를 프롬프트에 강제 주입하여 정확도 보장

기술 스택 (Tech Stack)

데이터 모델 (ERD)

• Users: 사용자 정보
• Personas: AI 성격 프롬프트
• Chat_Sessions: 게임 세션 메타데이터
• Chat_Logs: 대화 기록
• Game_Stats: 승률 및 스타일 분석