Develop

Monitoring-Jenkins/docker-compose.monitoring.yml

@@ -0,0 +1,28 @@
+services:
+  # Prometheus 설정
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: prometheus
+    ports:
+      - "9090:9090"  # Prometheus 웹 인터페이스
+    volumes:
+      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml  # Prometheus 설정 파일
+    networks:
+      - monitoring
+
+  # Grafana 설정
+  grafana:
+    image: grafana/grafana:latest
+    container_name: grafana
+    ports:
+      - "3000:3000"  # Grafana 대시보드
+    environment:
+      - GF_SECURITY_ADMIN_PASSWORD=admin  # 기본 관리자 비밀번호
+    depends_on:
+      - prometheus
+    networks:
+      - monitoring
+
+networks:
+  monitoring:
+    driver: bridge

Monitoring-Jenkins/grafana/.gitignore

@@ -0,0 +1 @@
+data/

Monitoring-Jenkins/jenkins/docker-compose.jenkins.yml

@@ -0,0 +1,16 @@
+version: "3.8"
+
+services:
+  jenkins:
+    image: jenkins/jenkins:lts
+    container_name: jenkins
+    restart: unless-stopped
+    user: root
+    ports:
+      - "8081:8080"
+      - "50000:50000"
+    volumes:
+      - /var/jenkins_home:/var/jenkins_home
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - TZ=Asia/Seoul

Monitoring-Jenkins/prometheus/prometheus.yml

@@ -0,0 +1,23 @@
+global:
+  scrape_interval: 15s  # 메트릭 수집 주기
+
+scrape_configs:
+  # 백엔드 서비스 메트릭 수집 (백엔드 서버의 메트릭을 수집)
+  - job_name: 'backend'
+    scheme: https
+    metrics_path: '/metrics/back'
+    static_configs:
+      - targets: ['goodgamefinder.xyz']
+
+  # PostgreSQL Exporter 메트릭 수집 (Postgres Exporter가 설정되어 있다면)
+  - job_name: 'postgres'
+    scheme: https
+    metrics_path: '/metrics/db'
+    static_configs:
+      - targets: ['goodgamefinder.xyz']
+
+  - job_name: 'node_exporter'
+    metrics_path: '/metrics/system'
+    scheme: https
+    static_configs:
+      - targets: ['goodgamefinder.xyz']

README.md

@@ -1,46 +1,140 @@
-# SSAFY 12기 자율 프로젝트 - D106팀
+# 🎮 GG (Good Game Finder) - 3가지 엔진을 탑재한 AI 게임 추천 플랫폼
 
-SSAFY 13기 자율 프로젝트 D106팀의 공식 Repository입니다.
+[![React](https://img.shields.io/badge/React-18.2.0-61DAFB?style=for-the-badge&logo=react)](https://reactjs.org/) [![Spring Boot](https://img.shields.io/badge/Spring_Boot-3.5.6-6DB33F?style=for-the-badge&logo=spring)](https://spring.io/projects/spring-boot) [![FastAPI](https://img.shields.io/badge/FastAPI-0.120.0-009688?style=for-the-badge&logo=fastapi)](https://fastapi.tiangolo.com/) [![LangChain](https://img.shields.io/badge/LangChain-1.0.3-8A2BE2?style=for-the-badge)](https://www.langchain.com/)
 
+**GG(Good Game Finder)**는 사용자의 취향과 상황에 맞춰 최적의 게임을 발견할 수 있도록, 각기 다른 강점을 가진 **3가지 핵심 추천 엔진**을 탑재한 AI 기반 개인화 게임 추천 플랫폼입니다.
 
+MSA(Microservice Architecture) 기반으로 설계되었으며, 사용자의 복합적인 요구사항을 만족시키기 위해 전통적인 머신러닝, 생성형 AI, 로직 기반 필터링을 모두 활용합니다.
 
-## 🗓️ 프로젝트 주요 일정
+---
 
-| 날짜 | 내용 | 비고 |
-| --- | --- | --- |
-| 2025.10.10(금) | 자율 프로젝트 시작 및 첫 팀 미팅  | |
-| 2025.10.15(수) | 프로젝트 계획서 제출 및 1차 교보재 신청 (예정)  | |
-| 2025.10.17(금) | Field Trip  | |
-| 2025.10.24(금) | **중간 평가** | 기획/설계 내용 기반 발표 (10분 내외)  |
-| 2025.11.20(목) | **최종 평가**  | 최종 발표 (시연 포함 15분) |
-| 2025.11.24(월) ~ | 포트폴리오 위크 | 프로젝트 회고 및 마무리  |
+## ✨ 주요 기능 및 설계
 
-## Ground Rules
+### 🖥️ 프론트엔드 (UI/UX)
 
-우리 팀은 SSAFY 자율 프로젝트 Ground Rule을 준수합니다.
+사용자 경험의 중심이 되는 웹 애플리케이션으로, React 기반의 반응형 SPA(Single Page Application)로 구축되었습니다.
 
-- **미팅 시간**
-    - **오전 미팅(조회):** 매일 09:00 시작 (라이브 방송 시 방송 후) 
-    - **오후 미팅(종례):** 매일 17:30 시작, **금요일은 17:00 시작** 
-- **협업 Tool**
-    - **GitLab, Jira, Mattermost, Webex**를 반드시 사용합니다. 
-    - Mattermost 공지는 이모지로 확인 반응을 남겨 적극적으로 소통합니다. 
-- **프로젝트 관리**
-    - 매일 **Stand up Scrum 회의**로 하루를 시작합니다. 
-    - 매주 **금요일** Sprint 회고를 진행하고, 회고록을 팀 채널에 공유합니다. 
-    - 기획 내용은 `Readme.md`에 꾸준히 업데이트합니다. 
+- **컴포넌트 기반 아키텍처**: 재사용성과 유지보수성을 높이기 위해 `features`와 `shared` 디렉토리 구조를 채택했습니다. 각 기능(게임, 프로필, 인증 등)별로 컴포넌트를 분리하고, 공용 컴포넌트(레이아웃, UI 요소 등)는 `shared`에서 관리하여 일관성을 유지합니다.
+- **서버 상태 관리**: `TanStack Query`를 핵심 라이브러리로 사용하여 서버와의 비동기 통신을 관리합니다. 이를 통해 데이터 캐싱, 자동 리프레시, 로딩 및 에러 상태 처리를 선언적으로 구현하여 코드 복잡도를 줄이고 사용자 경험을 향상시켰습니다.
+- **UI 디자인 시스템**: `Tailwind CSS`와 `shadcn/ui`를 기반으로 자체 디자인 시스템을 구축하여, 프로젝트 전반에 걸쳐 통일성 있고 세련된 UI를 제공합니다. `Recharts`를 활용한 데이터 시각화, `embla-carousel`을 이용한 캐러셀 등 동적인 UI 요소를 적극적으로 사용합니다.
+- **전역 상태 및 라우팅**: `React Context`를 통해 사용자 인증 정보(`AuthContext`), 테마(`ThemeProvider`) 등 전역 상태를 관리하며, `React Router`를 사용하여 페이지 간 부드러운 전환을 제공합니다.
 
-## 👥 팀원 소개
+### ⚙️ 3가지 핵심 추천 엔진
+
+GG 플랫폼은 사용자의 다양한 탐색 시나리오에 대응하기 위해 세 가지의 독립적인 추천 엔진을 제공합니다.
+
+#### 1. 개인 맞춤 추천 (ML-based Recommendation)
+
+> "나의 플레이 패턴을 분석해서 좋아할 만한 게임을 자동으로 추천해줘."
+
+- **담당 서비스**: `gg-recommend`
+- **기술 방식**: **전통적 머신러닝 (하이브리드 필터링)**
+- **상세 로직**:
+    1.  **데이터 분석**: 사용자의 Steam 라이브러리, 플레이 시간, '좋아요' 기록, 리뷰 평가 등 다양한 상호작용에 가중치를 부여하여 단일 상호작용 점수(`r_ui`)를 계산합니다.
+    2.  **후보군 생성 (Candidate Generation)**:
+        - **협업 필터링 (CF)**: 계산된 상호작용 점수를 기반으로 **Item-Item k-NN** 모델을 사용하여 '나와 비슷한 취향의 유저들이 즐긴 게임'을 후보로 추천합니다.
+        - **콘텐츠 기반 (CB)**: **TF-IDF**와 **SVD**로 벡터화된 게임의 콘텐츠(장르, 태그 등) 유사도를 기반으로 '내가 즐긴 게임과 비슷한 게임'을 후보로 추천합니다.
+    3.  **순위 재조정 (Ranking)**: 생성된 후보군들을 인기도, 최신성, 리뷰 점수 등 다양한 기준으로 재정렬하여 최종 추천 목록을 제공합니다.
+
+#### 2. 대화형 AI 추천 (Conversational AI Recommendation)
+
+> "최근에 친구랑 할만한 긴장감 넘치는 멀티플레이 FPS 게임 뭐 없을까?"
+
+- **담당 서비스**: `AI-SERVER`
+- **기술 방식**: **생성형 AI (RAG - Retrieval-Augmented Generation)**
+- **상세 로직**:
+    1.  **의도 분석**: 사용자의 자연어 질문 의도(단순 추천, 비교, 조건 검색 등)를 `LangChain`을 통해 분류합니다.
+    2.  **정보 검색 (Retrieval)**:
+        - **하이브리드 검색**: 질문의 의도와 문맥을 모두 고려하기 위해 **키워드 기반 검색(BM25)**과 **의미 기반 벡터 검색**을 동시에 사용해 가장 관련성 높은 게임들을 DB(MongoDB Atlas)에서 찾아냅니다.
+    3.  **프롬프트 생성 및 LLM 호출 (Generation)**: 검색된 게임 정보, 사용자 정보(필요시), 원본 질문을 조합하여 LLM(대규모 언어 모델)을 위한 정교한 프롬프트를 생성합니다. LLM은 이 프롬프트를 바탕으로 추천 이유를 포함한 자연스러운 답변을 만들어냅니다.
+
+#### 3. 아키네이터 추천 (Filter-based Recommendation)
+
+> "내가 원하는 장르, 분위기, 플레이 방식을 하나씩 선택해서 딱 맞는 게임을 찾아보고 싶어."
+
+- **담당 서비스**: `gg-backend`
+- **기술 방식**: **로직 기반 필터링 시스템**
+- **상세 로직**:
+    1.  **질문-답변 진행**: '스무고개'처럼 시스템이 제시하는 질문(e.g., "혼자서 하는 게임인가요?", "스토리가 중요한가요?")에 사용자가 답변합니다.
+    2.  **후보군 필터링**: 각 답변에 해당하는 게임 속성(장르, 태그 등)을 기준으로 전체 게임 목록을 실시간으로 필터링하여 후보군을 점차 좁혀나갑니다.
+    3.  **결과 제시**: 모든 질문이 끝나면, 최종적으로 남은 게임을 추천 결과로 제시합니다. 머신러닝 모델 없이, 정해진 로직에 따라 빠르고 명확한 결과를 제공하는 것이 특징입니다.
+
+---
+
+## 🏗️ 아키텍처 및 기술 스택
+
+```mermaid
+graph TD
+    subgraph "사용자"
+        A[Browser]
+    end
+
+    subgraph "인프라 (Docker)"
+        B[Nginx]
+        C[gg-frontend]
+        D[gg-backend]
+        E[gg-recommend]
+        F[AI-SERVER]
+        G[gg-ingester]
+        H[PostgreSQL]
+        I[Redis]
+        J[MongoDB Atlas]
+    end
 
-| 포지션 | 이름 | 희망 기술 |
-| --- | --- | --- |
-| 팀장, 프론트엔드 | 윤문정 | UI/UX 기획 및 프론트엔드 개발 |
-| 백엔드 | 이창환 | 실시간 데이터 파이프라인 설계 및 백엔드 API 개발 |
-| AI/MLOps | 송하윤 | AI 모델 학습 및 MLOps(CI/CD) 파이프라인 구축 |
-| 백엔드 | 하승재 | 웹소켓 기반 서버 및 백엔드 API 개발 |
-| 백엔드 | 박범준 | 백엔드 API 개발 및 DB 설계 |
-| 프론트엔드 | 박재연 | 프론트엔드 개발 |
+    subgraph "외부 API"
+        K[Steam API]
+        L[LLM API]
+    end
 
+    A -- HTTPS --> B
+    B -- / --> C
+    B -- /api --> D
+
+    D -- 개인 맞춤 추천 요청 --> E
+    D -- 아키네이터 로직 처리 --> D
+    D -- 대화형 AI 추천 요청 --> F
+
+    E -- 학습/추론 데이터 --> H
+    D -- 메인 데이터 --> H
+    G -- 수집 데이터 저장 --> H
+
+    F -- 벡터/메타데이터 --> J
+    F -- LLM 호출 --> L
+    G -- 플레이어 수 수집 --> K
+```
+
+| 서비스 | 역할 | 주요 기술 |
+| :--- | :--- | :--- |
+| **gg-frontend** | 웹 프론트엔드 | `React`, `TypeScript`, `Vite`, `Tailwind CSS`, `shadcn/ui`, `TanStack Query` |
+| **gg-backend** | 메인 API 서버, **아키네이터 엔진** | `Java 21`, `Spring Boot`, `JPA`, `QueryDSL`, `JJWT` |
+| **gg-recommend** | **개인 맞춤 추천 엔진 (ML)** | `Python`, `FastAPI`, `Scikit-learn`, `Pandas`, `SQLAlchemy` |
+| **AI-SERVER** | **대화형 AI 추천 엔진 (RAG)** | `Python`, `FastAPI`, `LangChain`, `Pytorch`, `Sentence-Transformers`, `MongoDB` |
+| **gg-ingester** | 데이터 수집기 | `Python`, `FastAPI`, `APScheduler`, `AsyncPG`, `AIOHTTP` |
+| **Monitoring-Jenkins** | 모니터링 & CI/CD | `Prometheus`, `Grafana`, `Jenkins`, `Docker`, `Docker Compose` |
+| **데이터베이스** | 데이터 저장소 | `PostgreSQL`, `Redis`, `MongoDB` |
+
+---
+
+## 🚀 시작하기 (Getting Started)
+
+본 프로젝트는 `docker-compose`를 사용하여 모든 서비스를 한 번에 실행할 수 있습니다.
+
+1.  **Repository 클론 및 환경 변수 설정**
+    ```bash
+    git clone https://github.com/your-repo/S13P31D106.git
+    cd S13P31D106
+    # 각 서비스의 .env.example 파일을 참고하여 .env 파일 생성 및 설정
+    ```
+
+2.  **Docker Compose 실행**
+    ```bash
+    # 필요한 docker-compose 파일을 조합하여 실행
+    docker-compose -f ... up --build
+    ```
+
+3.  **애플리케이션 접속**: `http://localhost`
+
+---
 
 ## ✍️ Git Commit Convention
 
@@ -54,4 +148,15 @@ SSAFY 13기 자율 프로젝트 D106팀의 공식 Repository입니다.
 | `test` | 테스트 코드 추가 및 수정 |
 | `chore` | 빌드 업무, 패키지 매니저 등 수정 |
 
-**예시:** `feat: 로그인 기능 추가`
+---
+
+## 👥 팀원 소개
+
+| 포지션 | 이름 |
+| --- | --- |
+| 팀장, 프론트엔드 | 윤문정 |
+| 백엔드 | 이창환 |
+| AI/MLOps | 송하윤 |
+| 백엔드 | 하승재 |
+| 백엔드/DevOps | 박원준 |
+| 프론트엔드 | 박재연 |