[Deploy] 최신 버전 반영

README.md

@@ -0,0 +1,47 @@
+# SPOT
+
+## Summary
+
+- 스터디 탐색, 운영, 커뮤니티 기능을 하나의 서비스로 묶은 멀티 모듈 백엔드 프로젝트
+- `Java 21`, `Spring Boot`, `JPA`, `QueryDSL`, `MySQL`, `Redis`, `AWS S3`
+- 모듈러 모놀리식 구조 기반으로 도메인 경계를 분리하고, 이벤트 기반 후처리와 배치 구조를 함께 운영
+- 백엔드 개발 및 인프라 운영 전반 담당
+
+---
+
+## What I Did
+
+- 대규모 데이터 환경에서 스터디 검색 API의 병목을 분석하고, 데이터 구조와 인덱스 설계를 조정해 응답 시간을 큰 폭으로 단축
+- 조회수와 좋아요를 같은 통계성 데이터로 보지 않고, 쓰기 패턴 차이에 맞춰 Redis Write-Behind와 RDB 즉시 반영 전략으로 분리
+- 외부 알림 호출이 비즈니스 API 안정성에 영향을 주지 않도록 트랜잭셔널 아웃박스 기반 비동기 발송 구조 설계
+- OAuth 로그인 로직에 전략 패턴을 적용해 소셜 로그인 타입별 구현을 분리하고, 공통 처리 흐름을 재구성
+
+---
+
+## Highlights
+
+- 검색 성능 개선: `10,986ms → 2.86ms`
+- 대규모 조건 검색 환경에서 `300 RPS` 수준 처리
+- 조회수 반영 구조 개선으로 DB 부하 대폭 감소
+- 좋아요 처리에서 정합성을 유지하면서 동시성 처리 성능 개선
+- 알림 시스템을 비동기화해 외부 장애 전파 차단
+- 확장 가능한 로그인 구조로 유지보수성과 테스트 용이성 개선
+
+---
+
+## Architecture
+
+- `Modular Monolith`
+- 도메인별 모듈 분리: `auth`, `member`, `study`, `post`, `notification`, `region`
+- 모듈 간 계약은 `*-api` 모듈로 분리
+- Redis 기반 캐시/집계/쓰기 완충
+- 스케줄러와 이벤트 리스너를 활용한 비동기 후처리
+
+---
+
+## Role & Contribution
+
+- 백엔드 설계와 구현 전반 담당
+- 성능 병목 분석, 데이터 구조 개선, 동시성 처리 전략 수립 주도
+- Redis, 배치, 비동기 이벤트 기반 운영 구조 설계 및 적용
+- 인증, 검색, 알림, 통계성 데이터 처리까지 핵심 기능 직접 구현

app/boot/build.gradle

@@ -18,6 +18,7 @@ dependencies {
     implementation project(":modules:member")
     implementation project(":modules:post")
     implementation project(":modules:region")
+    implementation project(":modules:notification")
 
     implementation project(":modules:member-api")
     implementation project(":modules:auth-api")

app/config/src/main/java/kr/spot/config/AsyncConfig.java

@@ -20,4 +20,15 @@ public Executor imageUploadExecutor() {
     executor.initialize();
     return executor;
   }
+
+  @Bean(name = "notificationExecutor")
+  public Executor notificationExecutor() {
+    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+    executor.setCorePoolSize(5);
+    executor.setMaxPoolSize(20);
+    executor.setQueueCapacity(100);
+    executor.setThreadNamePrefix("notification-");
+    executor.initialize();
+    return executor;
+  }
 }

app/config/src/main/java/kr/spot/config/JacksonConfig.java

@@ -0,0 +1,17 @@
+package kr.spot.config;
+
+import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
+import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class JacksonConfig {
+
+  @Bean
+  public Jackson2ObjectMapperBuilderCustomizer longToStringCustomizer() {
+    return builder -> {
+      builder.serializerByType(Long.class, ToStringSerializer.instance);
+    };
+  }
+}

build.gradle

@@ -1,6 +1,7 @@
 plugins {
     id "io.spring.dependency-management" version "1.1.6" apply false
     id "org.springframework.boot" version "3.3.2" apply false
+    id "jacoco"
 }
 
 allprojects {
@@ -12,6 +13,7 @@ allprojects {
 subprojects {
     apply plugin: "java"
     apply plugin: "io.spring.dependency-management"
+    apply plugin: "jacoco"
 
     dependencyManagement {
         imports { mavenBom "org.springframework.boot:spring-boot-dependencies:3.3.2" }
@@ -23,12 +25,66 @@ subprojects {
         options.compilerArgs += "-parameters"
     }
 
-    tasks.test { useJUnitPlatform() }
+    tasks.test {
+        useJUnitPlatform()
+        finalizedBy jacocoTestReport
+    }
+
+    jacoco {
+        toolVersion = "0.8.12"
+    }
+
+    jacocoTestReport {
+        dependsOn test
+        reports {
+            xml.required = true
+            html.required = true
+        }
+        afterEvaluate {
+            classDirectories.setFrom(files(classDirectories.files.collect {
+                fileTree(dir: it, includes: [
+                    '**/domain/**',
+                    '**/application/**'
+                ], excludes: [
+                    '**/infrastructure/**',
+                    '**/presentation/**',
+                    '**/config/**'
+                ])
+            }))
+        }
+    }
 
     dependencies {
         compileOnly "org.projectlombok:lombok"
         annotationProcessor "org.projectlombok:lombok"
         testCompileOnly "org.projectlombok:lombok"
         testAnnotationProcessor "org.projectlombok:lombok"
     }
+}
+
+// 전체 프로젝트 통합 커버리지 리포트
+tasks.register('jacocoRootReport', JacocoReport) {
+    dependsOn subprojects.findAll { it.plugins.hasPlugin('jacoco') }.collect { it.tasks.named('test') }
+
+    additionalSourceDirs.from(subprojects.findAll { it.plugins.hasPlugin('java') }.collect { it.sourceSets.main.allSource.srcDirs })
+    sourceDirectories.from(subprojects.findAll { it.plugins.hasPlugin('java') }.collect { it.sourceSets.main.allSource.srcDirs })
+
+    def allClassDirs = subprojects.findAll { it.plugins.hasPlugin('java') }.collect { it.sourceSets.main.output }
+    classDirectories.from(files(allClassDirs).asFileTree.matching {
+        include '**/domain/**'
+        include '**/application/**'
+        exclude '**/infrastructure/**'
+        exclude '**/presentation/**'
+        exclude '**/config/**'
+    })
+
+    executionData.from(subprojects.findAll { it.plugins.hasPlugin('jacoco') }.collect {
+        it.tasks.named('test').map { task -> task.extensions.getByType(JacocoTaskExtension).destinationFile }
+    })
+
+    reports {
+        xml.required = true
+        html.required = true
+        html.outputLocation = layout.buildDirectory.dir('reports/jacoco/aggregated')
+    }
 }

common/api/src/main/java/kr/spot/code/status/ErrorStatus.java

@@ -32,6 +32,7 @@ public enum ErrorStatus implements BaseErrorCode {
   _MEMBER_UNSUPPORTED_LOGIN_TYPE(400, "MEMBER4003", "지원하지 않는 로그인 타입입니다."),
   _MEMBER_EMAIL_EXIST(400, "MEMBER4004", "이미 해당 방식으로 가입 내역이 존재하는 이메일입니다."),
   _FAIL_TO_UPDATE_NAME(400, "MEMBER4005", "이름 변경에 실패했습니다."),
+  _CANNOT_WITHDRAW_WITH_ACTIVE_STUDY(400, "MEMBER4006", "운영 중인 스터디가 있어 탈퇴할 수 없습니다."),
 
   // 스터디 관련
   _MAX_MEMBERS_MUST_BE_POSITIVE(400, "STUDY4000", "최대 인원 수는 양수여야 합니다."),
@@ -48,19 +49,59 @@ public enum ErrorStatus implements BaseErrorCode {
       "셀프 승인을 위한 유효하지 않은 스터디 멤버 상태입니다."),
   _STUDY_ALREADY_APPLIED(400, "STUDY4006", "이미 해당 스터디에 지원한 상태입니다."),
   _STUDY_ACCESS_DENIED(403, "STUDY4032", "스터디에 접근할 권한이 없습니다."),
+  _INVALID_STUDY_ACCESS(403, "STUDY4033", "유효하지 않은 스터디 접근입니다."),
+  _STUDY_IS_FULL(400, "STUDY4007", "스터디 정원이 가득 찼습니다."),
+  _NEXT_OWNER_ID_REQUIRED_FOR_OWNER_WITHDRAWAL(400, "STUDY4008",
+      "스터디장 탈퇴 시 다음 스터디장 ID가 필요합니다."),
+  _NEXT_OWNER_NOT_EXIST_IN_STUDY(400, "STUDY4009",
+      "다음 스터디장이 스터디 멤버에 존재하지 않습니다."),
+  _CANNOT_DELETE_STUDY_WITH_MEMBERS(400, "STUDY4010",
+      "스터디 멤버가 있는 상태에서는 스터디를 삭제할 수 없습니다."),
 
   // 게시글 관련
   _POST_NOT_FOUND(404, "POST404", "게시글을 찾을 수 없습니다."),
   _COMMENT_NOT_FOUND(404, "COMMENT404", "댓글을 찾을 수 없습니다."),
   _ONLY_AUTHOR_CAN_MODIFY(403, "POST403", "게시글 및 댓글 수정은 작성자만 가능합니다."),
+  _PRIVATE_POST_ACCESS_DENIED(403, "POST4030", "스터디원 전용 게시글입니다."),
   _ALREADY_LIKED(400, "POST4000", "이미 좋아요를 누른 게시글입니다."),
   _ALREADY_UNLIKED(400, "POST4001", "좋아요를 누르지 않은 게시글입니다."),
   _SORT_TYPE_INVALID(400, "POST4002", "유효하지 않은 정렬 타입입니다."),
 
   // 지역 관련
   _REGION_NOT_FOUND(404, "REGION404", "지역을 찾을 수 없습니다."),
   _NO_SUCH_REGION(400, "REGION4000", "존재하지 않는 지역 코드입니다."),
-  ;
+
+  // 일정 관련
+  _SCHEDULE_NOT_FOUND(404, "SCHEDULE404", "일정을 찾을 수 없습니다."),
+  _SCHEDULE_ACCESS_DENIED(403, "SCHEDULE403", "해당 스터디에 속하는 일정이 아닙니다."),
+  _SCHEDULE_TIME_CONFLICT(400, "SCHEDULE4001", "동일한 시간대에 이미 일정이 존재합니다."),
+  _SCHEDULE_QR_CODE_ALREADY_ASSIGNED(400, "SCHEDULE4000", "이미 출석 QR 코드가 할당된 일정입니다."),
+
+  // 출석 관련
+  _ATTENDANCE_NOT_IN_SCHEDULE_TIME(400, "ATTENDANCE4000", "일정 시간 외에는 출석체크를 진행할 수 없습니다."),
+  _ATTENDANCE_NOT_STARTED(400, "ATTENDANCE4001", "출석체크가 시작되지 않았습니다."),
+  _ATTENDANCE_ALREADY_CHECKED(400, "ATTENDANCE4002", "이미 출석체크를 완료했습니다."),
+  _INVALID_ATTENDANCE_TOKEN(400, "ATTENDANCE4003", "유효하지 않은 출석 토큰입니다."),
+
+  // 투두 관련
+  _TODO_NOT_FOUND(404, "TODO404", "투두를 찾을 수 없습니다."),
+  _TODO_ACCESS_DENIED(403, "TODO403", "해당 스터디에 속하는 투두가 아닙니다."),
+  _ONLY_TODO_OWNER_CAN_MODIFY(403, "TODO4030", "투두 수정은 작성자만 가능합니다."),
+
+  // 회고 관련
+  _REVIEW_NOT_FOUND(404, "REVIEW404", "회고를 찾을 수 없습니다."),
+  _REVIEW_ACCESS_DENIED(403, "REVIEW403", "해당 스터디에 속하는 회고가 아닙니다."),
+  _ALREADY_REACTED(400, "REVIEW4000", "이미 반응을 누른 회고입니다."),
+  _REACTION_NOT_FOUND(404, "REVIEW4040", "반응을 찾을 수 없습니다."),
+
+  // 알림 관련
+  _NOTIFICATION_NOT_FOUND(404, "NOTIFICATION404", "알림을 찾을 수 없습니다."),
+  _INVALID_NOTIFICATION_TYPE(400, "NOTIFICATION4000", "유효하지 않은 알림 유형입니다."),
+  _NOTIFICATION_PAYLOAD_MISSING_MEMBER_ID(400, "NOTIFICATION4001", "알림 페이로드에 memberId가 필요합니다."),
+  _NOTIFICATION_PAYLOAD_MISSING_STUDY_ID(400, "NOTIFICATION4002", "알림 페이로드에 studyId가 필요합니다."),
+  _NOTIFICATION_TEMPLATE_NOT_FOUND(500, "NOTIFICATION5000", "알림 템플릿을 찾을 수 없습니다."),
+  _PUSH_NOTIFICATION_FAILED(500, "NOTIFICATION5001", "푸시 알림 발송에 실패했습니다."),
+  _NOTIFICATION_ACCESS_DENIED(403, "NOTIFICATION403", "해당 알림에 접근할 권한이 없습니다.");
 
   private final int httpStatus;
   private final String code;

common/view/build.gradle

@@ -0,0 +1,2 @@
+dependencies {
+}

common/view/src/main/java/kr/spot/view/ViewAbuseGuard.java

@@ -0,0 +1,6 @@
+package kr.spot.view;
+
+public interface ViewAbuseGuard {
+
+    boolean shouldCount(ViewableType type, long targetId, long viewerId);
+}

common/view/src/main/java/kr/spot/view/ViewCounter.java

@@ -0,0 +1,8 @@
+package kr.spot.view;
+
+public interface ViewCounter {
+
+    long incrementAndGet(ViewableType type, long targetId);
+
+    long currentDelta(ViewableType type, long targetId);
+}

common/view/src/main/java/kr/spot/view/ViewableType.java

@@ -0,0 +1,15 @@
+package kr.spot.view;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ViewableType {
+
+    POST("post"),
+    STUDY("study"),
+    STUDY_BOARD("study-board");
+
+    private final String keyPrefix;
+}

infra/view-redis/build.gradle

@@ -0,0 +1,15 @@
+plugins {
+    id "io.spring.dependency-management"
+    id "java"
+}
+
+dependencies {
+    implementation project(":common:view")
+
+    // Spring Boot Starters
+    implementation "org.springframework.boot:spring-boot-starter-data-redis"
+
+    // Testing
+    testImplementation "org.springframework.boot:spring-boot-starter-test"
+    testRuntimeOnly "org.junit.platform:junit-platform-launcher"
+}

modules/post/src/main/java/kr/spot/infrastructure/redis/RedisViewAbuseGuard.java → infra/view-redis/src/main/java/kr/spot/view/redis/RedisViewAbuseGuard.java

@@ -1,7 +1,8 @@
-package kr.spot.infrastructure.redis;
+package kr.spot.view.redis;
 
 import java.time.Duration;
-import kr.spot.application.ports.ViewAbuseGuard;
+import kr.spot.view.ViewAbuseGuard;
+import kr.spot.view.ViewableType;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.redis.core.StringRedisTemplate;
 import org.springframework.stereotype.Component;
@@ -10,19 +11,19 @@
 @RequiredArgsConstructor
 public class RedisViewAbuseGuard implements ViewAbuseGuard {
 
-  public static final String GUARD_KEY = "view:guard:%d:%d";
-  public static final String VALUE = "1";
+  private static final String GUARD_KEY_FORMAT = "view:guard:%s:%d:%d";
+  private static final String VALUE = "1";
   private static final Duration WINDOW = Duration.ofMinutes(10);
-  
+
   private final StringRedisTemplate redis;
 
-  private static String guardKey(long postId, long viewerId) {
-    return GUARD_KEY.formatted(postId, viewerId);
+  private static String guardKey(ViewableType type, long targetId, long viewerId) {
+    return GUARD_KEY_FORMAT.formatted(type.getKeyPrefix(), targetId, viewerId);
   }
 
   @Override
-  public boolean shouldCount(long postId, long viewerId) {
-    String key = guardKey(postId, viewerId);
+  public boolean shouldCount(ViewableType type, long targetId, long viewerId) {
+    String key = guardKey(type, targetId, viewerId);
     Boolean ok = redis.opsForValue().setIfAbsent(key, VALUE, WINDOW);
     return Boolean.TRUE.equals(ok);
   }

infra/view-redis/src/main/java/kr/spot/view/redis/RedisViewCounter.java

@@ -0,0 +1,32 @@
+package kr.spot.view.redis;
+
+import kr.spot.view.ViewCounter;
+import kr.spot.view.ViewableType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.redis.core.StringRedisTemplate;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class RedisViewCounter implements ViewCounter {
+
+  private static final String DELTA_KEY_FORMAT = "view:%s:%d";
+
+  private final StringRedisTemplate redis;
+
+  private static String deltaKey(ViewableType type, long targetId) {
+    return DELTA_KEY_FORMAT.formatted(type.getKeyPrefix(), targetId);
+  }
+
+  @Override
+  public long incrementAndGet(ViewableType type, long targetId) {
+    Long v = redis.opsForValue().increment(deltaKey(type, targetId));
+    return v == null ? 0L : v;
+  }
+
+  @Override
+  public long currentDelta(ViewableType type, long targetId) {
+    String v = redis.opsForValue().get(deltaKey(type, targetId));
+    return (v == null) ? 0L : Long.parseLong(v);
+  }
+}