[Merge] main 브랜치에 staging 브랜치 병합

.coderabbit.yaml

@@ -0,0 +1,11 @@
+# CodeRabbit 설정 파일
+language: "ko-KR"                # 리뷰 언어 한국어로 설정
+early_access: false
+reviews:
+  profile: "chill"
+  request_changes_workflow: false # AI가 승인 거부를 못 하게
+  high_level_summary: true       # 전체적인 3줄 요약 제공
+  auto_review:
+    enabled: true
+chat:
+  auto_reply: true               # 대댓글로 질문하면 답변

.github/PULL_REQUEST_TEMPLATE/release.md

@@ -4,16 +4,5 @@
 <!-- 예: dev → staging / staging → main -->
 이번 PR은 **[브랜치A] → [브랜치B]** 병합을 위한 릴리즈 PR입니다.
 
-### 📄 변경 요약
-- 스프린트 기능 묶음 반영
-- 주요 변경사항 하이라이트 (선택)
-
-### 🛠 스키마 / 환경 변수 변경
-- 없음
-
-### 🧪 테스트 / QA
-- smoke test 완료
-- staging QA 완료 (해당 시)
-
 ### ⚠️ 참고 사항
 <!-- 배포 시 유의하거나 리뷰어가 알아야 할 내용 -->

.github/workflows/deploy.yml

@@ -9,65 +9,81 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - name: ✔️ GIT - Checkout Repository ✔️
+      - name: GIT - Checkout Repository
         uses: actions/checkout@v4
 
-      - name: 🔻 SETUP - Install JDK 21 🔻
+      - name: SETUP - Install JDK 21
         uses: actions/setup-java@v4
         with:
           distribution: temurin
           java-version: 21
 
-      - name: 🔐 CONFIG - Create application-prod.properties 🔐
-        run: |
-          mkdir -p ./src/main/resources
-          echo "${{ secrets.ENV }}" > ./src/main/resources/application-prod.properties
-
-      - name: ⏳ BUILD - Run Test & Build JAR ⏳
+      - name: BUILD - Run Test & Build JAR
         run: | 
           ./gradlew clean build
 
-      - name: ☁️ CONFIG - Configure AWS Credentials ☁️
+      - name: CONFIG - Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v4
         with:
           aws-region: ap-northeast-2
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
 
-      - name: ☁️ AWS - Login to Amazon ECR ☁️
-        id: login-ecr
-        uses: aws-actions/amazon-ecr-login@v2
-
-      - name: 🐳 DOCKER - Build Docker Image 🐳
-        run: docker build -t talkpick-server .
-
-      - name: 🐳 DOCKER - Tag Docker Image 🐳
-        run: docker tag talkpick-server ${{ steps.login-ecr.outputs.registry }}/talkpick-server:latest
+      - name: DOCKER - Build Docker Image
+        run: docker build -t talkpick-server:latest .
+
+      - name: DOCKER_HUB - Login to Docker Hub
+        run: |
+          echo "${{ secrets.DOCKERHUB_TOKEN }}" | docker login \
+            -u "${{ secrets.DOCKERHUB_USERNAME }}" \
+            --password-stdin
 
-      - name: ☁️ AWS - Push Docker Image to ECR ☁️
-        run: docker push ${{ steps.login-ecr.outputs.registry }}/talkpick-server:latest
+      - name: DOCKER_HUB - Push Docker image
+        run: |
+          docker tag talkpick-server:latest ${{ secrets.DOCKERHUB_USERNAME }}/talkpick-server:latest
+          docker push ${{ secrets.DOCKERHUB_USERNAME }}/talkpick-server:latest
 
-      - name: 🛠️ PERMISSIONS - Fix file ownership and permission before tar
+      - name: PERMISSIONS - Fix file ownership and permission before tar
         run: |
           sudo chown -R $(whoami):$(whoami) .
           chmod -R 755 scripts
           chmod 644 docker-compose.yml
 
-      - name: ☁️ AWS - Compress for CodeDeploy ☁️
-        run: |
-          mkdir -p deploy-files
-          cp appspec.yml docker-compose.yml -t deploy-files
-          cp -r scripts deploy-files
-          cp src/main/resources/application.yml deploy-files
-          tar -czvf $GITHUB_SHA.tar.gz -C deploy-files .
+      - name: AWS - Fix Permissions on EC2
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USER }}
+          key: ${{ secrets.EC2_SSH_KEY }}
+          script: |
+            target_dir="/home/${{ secrets.EC2_USER }}/TalkPick_Server"
+            sudo mkdir -p $target_dir
+            sudo chown -R $(whoami):$(whoami) $target_dir
 
-      - name: ☁️ AWS - Upload Archive to S3 ☁️
-        run: aws s3 cp --region ap-northeast-2 ./$GITHUB_SHA.tar.gz s3://talkpick-server/$GITHUB_SHA.tar.gz
+      - name: SCP - Copy docker-compose.yml to EC2
+        uses: appleboy/scp-action@v0.1.7
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USER }}
+          key: ${{ secrets.EC2_SSH_KEY }}
+          source: "docker-compose.yml"
+          target: "/home/${{ secrets.EC2_USER }}/TalkPick_Server"
 
-      - name: ☁️ AWS - Create Deployment to EC2 ☁️
-        run: |
-          aws deploy create-deployment \
-            --application-name talkpick-server \
-            --deployment-config-name CodeDeployDefault.AllAtOnce \
-            --deployment-group-name Production \
-            --s3-location "bucket=talkpick-server,bundleType=tgz,key=$GITHUB_SHA.tar.gz"
+      - name: AWS - Deploy to EC2
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USER }}
+          key: ${{ secrets.EC2_SSH_KEY }}
+          script: |
+            mkdir -p /home/${{ secrets.EC2_USER }}/TalkPick_Server/env
+            cat << 'EOF' > /home/${{ secrets.EC2_USER }}/TalkPick_Server/env/.env
+            ${{ secrets.ENV }}
+            GRAFANA_CLOUD_USER=${{ secrets.GRAFANA_CLOUD_USER }}
+            GRAFANA_CLOUD_TOKEN=${{ secrets.GRAFANA_CLOUD_TOKEN }}
+            EOF
+
+            cd /home/${{ secrets.EC2_USER }}/TalkPick_Server
+            docker compose pull talkpick-server
+            docker compose build nginx
+            docker compose up -d

STRUCTURE.md

@@ -0,0 +1,128 @@
+# TalkPick 서버 구조
+
+## 개요
+TalkPick 서버는 스몰토크 주제 추천 및 사용자 성향(MBTI 등) 기반 통계 서비스를 제공하는 서비스
+헥사고날 아키텍처(Ports & Adapters)를 기반으로 도메인 중심 설계를 따름
+
+## 1. Global (공통 인프라 및 설정)
+
+### `talkPick.global.config`
+*   **`AsyncConfig`**: 비동기 작업 처리 설정 (`@EnableAsync`)
+*   **`CacheConfig`**: 로컬 캐싱 설정 (Caffeine 등)
+*   **`CorsFilter`**: CORS 정책 설정 (허용 출처, 헤더 등)
+*   **`JacksonConfig`**: JSON 직렬화/역직렬화 설정
+*   **`JasyptConfig`**: 설정 파일 암호화 지원
+*   **`JpaAuditingConfig`**: JPA 엔티티 자동 감시 (`BaseTime` 등) 활성화
+*   **`QuerydslConfig`**: QueryDSL `JPAQueryFactory` 빈 등록
+*   **`SchedulingConfig`**: 스케줄링 작업 활성화 (`@EnableScheduling`)
+*   **`SpringDocOpenApiConfig`**: Swagger/OpenAPI 문서 설정
+*   **`WebConfig`**: 웹 MVC 설정 (ArgumentResolver 등 등록)
+
+### `talkPick.global.security`
+*   **Config**
+    *   `SecurityConfig`: Spring Security 체인 설정. CSRF/FormLogin 비활성화, JWT 필터 추가, WhiteList 기반 경로 허용
+*   **Filter**
+    *   `JwtAuthenticationFilter`: JWT 토큰 파싱 및 유효성 검증, `SecurityContext`에 인증 정보 설정
+    *   `ExceptionHandlerFilter`: 필터 체인 내 예외 포착 및 핸들링
+*   **JWT**
+    *   `JwtProvider`: 토큰 생성, 검증, 정보 추출 (MemberId, Role)
+    *   `JwtTokenCommandService`: 액세스/리프레시 토큰 발급 및 재발급
+    *   `RefreshTokenRepository`: 리프레시 토큰 저장소
+*   **Resolver**
+    *   `MemberIdArgumentResolver`: 컨트롤러 파라미터 `@MemberId`를 통해 인증된 사용자 ID 주입
+
+### `talkPick.global.exception`
+*   **Handler**: `GlobalExceptionHandler` 및 도메인별 핸들러 (`MemberExceptionHandler`, `TopicExceptionHandler` 등)
+*   **Exception**: `TalkPickException` (루트 예외), `ErrorCode` (에러 코드 정의)
+
+### `talkPick.global.rateLimiter`
+*   **Adapter**: `RateLimiterManagerAdapter` (Caffeine + Bucket4j 기반 토큰 버킷 알고리즘 구현)
+*   **Aspect**: `RateLimiterAspect` (`@RateLimited` 어노테이션이 붙은 메서드 트래픽 제어)
+*   **Annotation**: `@RateLimited`
+
+### `talkPick.global.log`
+*   **Aspect**: `LoggerAspect` (현재 주석 처리됨, AOP 기반 로깅)
+
+### `talkPick.global.healthCheck`
+*   **API**: `DBHealthIndicator`, `UrlHealthIndicator` (시스템 상태 점검)
+
+---
+
+## 2. Domain (핵심 비즈니스 로직)
+
+### **Member (회원)**
+*   **Entity**: `Member` (핵심 정보), `MemberLoginHistory` (로그인 기록), `MemberTerm` (약관 동의 내역)
+*   **Port (In/Out)**
+    *   In: `MemberCommandUseCase`, `MemberQueryUseCase`, `MemberWithdrawalUseCase`
+    *   Out: `MemberCommandRepositoryPort`, `MemberQueryRepositoryPort` 등
+*   **Service (Application)**
+    *   `MemberCommandService`: 회원가입, 프로필 수정(MBTI), 약관 동의, 로그아웃
+    *   `MemberQueryService`: 프로필 조회, 좋아요한 토픽 조회, 캘린더 결과 조회
+    *   `MemberWithdrawalService`: 회원 탈퇴(Soft Delete) 및 영구 삭제(Hard Delete)
+*   **Adapter (Out)**
+    *   `MemberJpaRepository`: 기본 CRUD
+    *   `MemberLikedTopicsQuerydslRepository`: 좋아요한 토픽 커서 페이징 조회 (복잡한 조인)
+    *   `MemberTopicResultQuerydslRepository`: 일자별 토픽 결과 조회
+
+### **Topic (토픽)**
+*   **Entity**: `Topic` (주제), `TopicStat` (통계), `Category`, `Keyword`, `TopicLikeHistory`
+*   **Port (In/Out)**
+    *   In: `TopicCommandUseCase`, `TopicQueryUseCase`
+    *   Out: `TopicQueryRepositoryPort`, `TopicLikeHistoryCommandRepositoryPort` 등
+*   **Service (Application)**
+    *   `TopicCommandService`: 좋아요 기능 (이벤트 발행)
+    *   `TopicQueryService`: 카테고리 목록, 토픽 상세 조회
+*   **Adapter (Out)**
+    *   `TopicQuerydslRepository`: 토픽 검색 및 조회
+    *   `TopicStatJpaRepository`: 통계 데이터 관리
+
+### **Random (랜덤 토픽)**
+*   **Entity**: `Random` (세션), `RandomTopicHistory` (진행 이력)
+*   **Port (In/Out)**
+    *   In: `RandomCommandUseCase`, `RandomQueryUseCase`
+*   **Service (Application)**
+    *   `RandomCommandService`: 세션 시작/종료, 다음 토픽 진행, 평점/한줄평 등록
+    *   `RandomQueryService`: 조건별 랜덤 토픽 추천 목록 조회
+*   **Adapter (Out)**
+    *   `RandomQuerydslRepository`, `RandomTopicHistoryQuerydslRepository`: 동적 쿼리 처리
+
+### **Today (오늘의 토픽)**
+*   **Entity**: `TodayTopic` (사용자-토픽 매핑)
+*   **Service (Application)**
+    *   `TodayTopicQueryService`: 사용자별 오늘의 토픽 조회 (캐싱 적용 `CacheManager`)
+*   **Adapter (Out)**
+    *   `TodayTopicQuerydslRepository`: 오늘의 토픽 조회 최적화
+
+### **Notice (공지사항)**
+*   **Entity**: `Notice`, `NoticeImage`
+*   **Service (Application)**
+    *   `NoticeQueryService`: 공지사항 목록(커서 페이징) 및 상세 조회
+*   **Adapter (Out)**
+    *   `NoticeQuerydslRepository`: 페이징 쿼리
+
+### **Inquiry (문의)**
+*   **Entity**: `Inquiry`
+*   **Service (Application)**
+    *   `InquiryCommandService`: 문의 등록
+    *   `InquiryQueryService`: 내 문의 내역 조회
+*   **Adapter (Out)**
+    *   `InquiryQuerydslRepository`: 문의 내역 페이징
+
+### **Term (약관)**
+*   **Entity**: `Term`
+*   **Adapter (Out)**: `TermJpaRepository`
+
+---
+
+## 3. Batch (배치 및 스케줄러)
+*   **`MemberCleanupScheduler`**: 탈퇴 상태인 회원과 연관 데이터를 주기적으로 영구 삭제 (Hard Delete)
+*   **`TodayTopicCacheRefreshScheduler`**: 매일 자정 사용자별 새로운 '오늘의 토픽' 생성 및 캐시 갱신
+*   **`MasterTokenGenerator`**: 개발/테스트용 마스터 토큰 생성
+
+---
+
+## 4. External (외부 연동)
+*   **Kakao**: `KakaoOidcService` (ID Token 검증, 공개키 조회, 사용자 정보 파싱)
+*   **Apple**: `AppleOidcService` (애플 로그인 지원)
+*   **Google**: `GoogleOidcService` (구글 로그인 지원)
+*   **Port**: `KakaoOidcUsecase` 등 인터페이스 정의로 결합도 낮춤

docker-compose.yml

@@ -1,30 +1,16 @@
 services:
-  ## talkpick
+  ## talkpick server
   talkpick-server:
-    image: 718513646976.dkr.ecr.ap-northeast-2.amazonaws.com/talkpick-server:latest
+    image: hszoo/talkpick-server:latest
     container_name: talkpick-server
-    ports:
-      - "8080:8080"
     networks:
       - t4y
+    ports:
+      - "8080:8080"
     restart: always
-    volumes:
-      - ./env/.env.properties:/app/config/.env.properties
-    environment:
-      - SPRING_CONFIG_IMPORT=optional:file:/app/config/.env.properties
     env_file:
-      - ./env/.env
-
-  ## adminer
-  adminer:
-    image: adminer
-    container_name: talkpick-db-adminer
-    networks:
-      - t4y
-    restart: always
-    ports:
-      - "8081:8080"
-
+      - /home/ec2-user/TalkPick_Server/env/.env
+
   ## nginx
   nginx:
     build: ./nginx
@@ -35,14 +21,24 @@ services:
     ports:
       - "443:443"
       - "80:80"
-    environment:
-        ORIGIN_CERTIFICATE: "${ORIGIN_CERTIFICATE}"
-        PRIVATE_CERTIFICATE_KEY: "${PRIVATE_CERTIFICATE_KEY}"
     depends_on:
       - talkpick-server
-      - adminer
     volumes:
       - ./nginx/conf:/etc/nginx/conf.d
+      - ./nginx/html/terms/privacy-policy:/usr/share/nginx/html/docs:ro
+      - /etc/ssl/cloudflare:/etc/ssl/cloudflare:ro
+
+  ## promtail
+  promtail:
+    image: grafana/promtail:2.9.4
+    container_name: promtail
+    networks:
+      - t4y
+    volumes:
+      - /var/lib/docker/containers:/var/lib/docker/containers:ro
+      - ./promtail.yaml:/etc/promtail/config.yml:ro
+    command: -config.file=/etc/promtail/config.yml
+    restart: unless-stopped
 
 networks:
-  t4y:
+  t4y: