From 1c3b8211ee2b0f1ea3eea11aebd2800e361105ec Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Fri, 24 Jul 2026 23:02:13 +0900 Subject: [PATCH 01/14] =?UTF-8?q?chore:=20=EB=8F=99=EC=8B=9C=20=EC=A0=91?= =?UTF-8?q?=EC=86=8D=20100=EB=AA=85=20=EA=B8=B0=EC=A4=80=20=EC=BB=A4?= =?UTF-8?q?=EB=84=A5=EC=85=98=20=ED=92=80/=EC=8A=A4=EB=A0=88=EB=93=9C=20?= =?UTF-8?q?=ED=92=80=20=EC=84=A4=EC=A0=95=20=EC=A0=81=EC=9A=A9=20(#140)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - HikariCP 풀 크기 15로 고정, 커넥션 획득 타임아웃 3초로 단축 - max-lifetime 29분 설정으로 MySQL wait_timeout 만료 커넥션 획득 방지 - Tomcat 스레드 최대 100, 대기 큐 100으로 조정 - 배포 시 처리 중 요청 유실 방지를 위한 graceful shutdown 적용 Co-Authored-By: Claude Opus 4.8 --- src/main/resources/application-dev.yml | 20 ++++++++++++++++++++ src/main/resources/application-prod.yml | 22 ++++++++++++++++++++++ 2 files changed, 42 insertions(+) diff --git a/src/main/resources/application-dev.yml b/src/main/resources/application-dev.yml index b8698da..9d8408b 100644 --- a/src/main/resources/application-dev.yml +++ b/src/main/resources/application-dev.yml @@ -7,6 +7,15 @@ spring: driver-class-name: com.mysql.cj.jdbc.Driver username: ${DB_USERNAME} password: ${DB_PASSWORD} + hikari: + pool-name: BillilgeHikariCP + maximum-pool-size: 15 + minimum-idle: 15 + connection-timeout: 3000 + validation-timeout: 2000 + idle-timeout: 600000 + max-lifetime: 1740000 + keepalive-time: 300000 security: oauth2: @@ -37,6 +46,17 @@ spring: resolve-lazily: true +server: + tomcat: + threads: + max: 100 + min-spare: 20 + accept-count: 100 + max-connections: 2000 + connection-timeout: 5000ms + shutdown: graceful + + jwt: secret_key: ${JWT_SECRET_KEY} issuer: ${JWT_ISSUER} diff --git a/src/main/resources/application-prod.yml b/src/main/resources/application-prod.yml index 30e482e..8774db8 100644 --- a/src/main/resources/application-prod.yml +++ b/src/main/resources/application-prod.yml @@ -7,6 +7,17 @@ spring: driver-class-name: com.mysql.cj.jdbc.Driver username: ${DB_USERNAME} password: ${DB_PASSWORD} + hikari: + pool-name: BillilgeHikariCP + # 동접 100 기준: 요청당 DB 점유 시간이 짧아(수십 ms) 커넥션은 적게 유지하는 편이 큐잉/컨텍스트 스위칭에 유리 + # 웹 요청 + @Async 알림 처리(기본 태스크 풀 8) 여유분까지 포함해 15 + maximum-pool-size: 15 + minimum-idle: 15 # 풀 크기 고정 (증감 시 커넥션 생성 지연 방지) + connection-timeout: 3000 # 풀 고갈 시 30초 대기 대신 3초 내 fail-fast + validation-timeout: 2000 + idle-timeout: 600000 + max-lifetime: 1740000 # 29분. MySQL wait_timeout보다 짧게 유지 + keepalive-time: 300000 security: oauth2: @@ -36,6 +47,17 @@ spring: resolve-lazily: true +server: + tomcat: + threads: + max: 100 # 동접 100을 동시에 수용. 초과분은 accept-count 큐에서 대기 + min-spare: 20 # 트래픽 유입 시 스레드 생성 지연 완화 + accept-count: 100 + max-connections: 2000 + connection-timeout: 5000ms + shutdown: graceful + + jwt: secret_key: ${JWT_SECRET_KEY} issuer: ${JWT_ISSUER} From acaf715f834cd59e81e1eca0cdf61d2ee3c0f236 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Fri, 24 Jul 2026 23:31:31 +0900 Subject: [PATCH 02/14] =?UTF-8?q?fix:=20=EB=82=A9=EB=B6=80=EC=9E=90=20?= =?UTF-8?q?=EB=AA=A9=EB=A1=9D=20=EC=A1=B0=ED=9A=8C=20=EC=A0=95=EB=A0=AC=20?= =?UTF-8?q?=EC=88=9C=EC=84=9C=EC=99=80=20=EB=B6=88=EC=9D=BC=EC=B9=98?= =?UTF-8?q?=ED=95=98=EB=8A=94=20=EC=9D=B8=EB=8D=B1=EC=8A=A4=20=EC=88=98?= =?UTF-8?q?=EC=A0=95=20(#142)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- .../site/billilge/api/backend/domain/payer/entity/Payer.kt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/kotlin/site/billilge/api/backend/domain/payer/entity/Payer.kt b/src/main/kotlin/site/billilge/api/backend/domain/payer/entity/Payer.kt index 8198a1d..c0f7220 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/payer/entity/Payer.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/payer/entity/Payer.kt @@ -5,7 +5,7 @@ import jakarta.persistence.* @Entity @Table( name = "payer", - indexes = [Index(name = "idx_payer_name_enrollment_year", columnList = "name, enrollment_year")] + indexes = [Index(name = "idx_payer_enrollment_year_name", columnList = "enrollment_year DESC, name")] ) class Payer( @Column(nullable = false) From cab1b5c2ddc9d28046442869690fe85cdef8c30c Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 18:41:47 +0900 Subject: [PATCH 03/14] =?UTF-8?q?fix:=20=ED=91=B8=EC=8B=9C=20=EB=B0=9C?= =?UTF-8?q?=EC=86=A1=EC=9D=84=20=EC=95=8C=EB=A6=BC=20=EC=A0=80=EC=9E=A5=20?= =?UTF-8?q?=ED=8A=B8=EB=9E=9C=EC=9E=AD=EC=85=98=20=EB=B0=96=EC=9C=BC?= =?UTF-8?q?=EB=A1=9C=20=EB=B6=84=EB=A6=AC=20(#144)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit FCM 호출이 알림 저장 트랜잭션 안에 있어, 푸시가 실패하면 방금 저장한 Notification 레코드까지 롤백되고 관리자 알림은 루프 중간에서 끊겼다. 또 HTTP 호출이 끝날 때까지 HikariCP 커넥션을 점유했다. - NotificationService는 알림 저장만 담당하도록 축소 (FCMService, MemberService 의존 제거) - PushNotificationSender를 추가해 트랜잭션 밖에서 푸시 발송, 실패를 예외로 전파하지 않음 - NotificationEventHandler의 REQUIRES_NEW 제거 — 저장은 짧은 트랜잭션에서 커밋 후 푸시 발송 - FCMService 반환 타입을 Boolean에서 PushResult로 교체해 재시도 가능 여부를 구분 (기존에는 네트워크 오류·FCM 5xx도 true로 반환되어 실패가 호출부에 전달되지 않았음) Co-Authored-By: Claude Opus 5 --- CLAUDE.md | 27 ++++++-- .../handler/NotificationEventHandler.kt | 52 +++++++++++---- .../service/NotificationService.kt | 63 +++---------------- .../service/PushNotificationSender.kt | 61 ++++++++++++++++++ .../backend/global/external/fcm/FCMService.kt | 53 +++++++++++++--- .../backend/global/external/fcm/PushResult.kt | 20 ++++++ 6 files changed, 195 insertions(+), 81 deletions(-) create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/global/external/fcm/PushResult.kt diff --git a/CLAUDE.md b/CLAUDE.md index e93eadf..bbb5bab 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -72,13 +72,30 @@ domain/{name}/ ## 서비스 의존성 ``` -ItemService → ItemRepository, S3Service -MemberService → MemberRepository, TokenProvider, PayerService -NotificationService → NotificationRepository, FCMService, MemberService -PayerService → PayerRepository, MemberRepository, ExcelGenerator -RentalService → RentalRepository, NotificationService +ItemService → ItemRepository, S3Service +MemberService → MemberRepository, TokenProvider, PayerService +NotificationService → NotificationRepository +PushNotificationSender → FCMService, MemberService +PayerService → PayerRepository, MemberRepository, ExcelGenerator +RentalService → RentalRepository, ApplicationEventPublisher ``` +### 알림 발송 구조 + +`RentalService`가 이벤트를 발행하면 `NotificationEventHandler`가 커밋 이후 비동기로 받아 처리한다. + +``` +RentalService → 이벤트 발행 + └ NotificationEventHandler (@Async + AFTER_COMMIT, 트랜잭션 없음) + ├ NotificationService.createNotification() # 짧은 트랜잭션에서 저장 후 즉시 커밋 + └ PushNotificationSender.send() # 트랜잭션 밖에서 FCM 호출 +``` + +- **푸시 발송은 트랜잭션 밖에서 수행한다** — 네트워크 I/O가 DB 커넥션을 점유하지 않도록, 그리고 푸시 실패가 저장된 알림을 롤백시키지 않도록 분리 +- **`PushNotificationSender`는 예외를 전파하지 않는다** — 한 수신자의 실패가 다른 수신자에게 영향을 주면 안 됨 +- **FCM 실패는 `PushResult`로 구분한다** — `InvalidToken`(토큰 제거) / `Retryable`(재시도 대상) / `Permanent`(재시도 무의미) +- **`@Async`는 알림 전용 실행기(`notificationTaskExecutor`)를 사용한다** — `AsyncConfig`에 정의 + ## 대여 상태 머신 ``` diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt index 21fdd1c..499b32b 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt @@ -2,28 +2,34 @@ package site.billilge.api.backend.domain.notification.handler import org.springframework.scheduling.annotation.Async import org.springframework.stereotype.Component -import org.springframework.transaction.annotation.Propagation -import org.springframework.transaction.annotation.Transactional import org.springframework.transaction.event.TransactionPhase import org.springframework.transaction.event.TransactionalEventListener +import site.billilge.api.backend.domain.member.entity.Member import site.billilge.api.backend.domain.member.service.MemberService import site.billilge.api.backend.domain.notification.enums.NotificationStatus import site.billilge.api.backend.domain.notification.service.NotificationService +import site.billilge.api.backend.domain.notification.service.PushNotificationSender import site.billilge.api.backend.domain.rental.enums.RentalStatus import site.billilge.api.backend.domain.rental.event.* +/** + * 알림 저장(DB)과 푸시 발송(FCM)을 분리해 호출한다. + * + * 핸들러 자체에는 트랜잭션을 걸지 않는다. 알림 저장은 NotificationService의 짧은 트랜잭션에서 + * 즉시 커밋되고, 그 뒤 트랜잭션 밖에서 푸시를 보낸다. 푸시가 실패해도 저장된 알림은 남는다. + */ @Component class NotificationEventHandler( private val notificationService: NotificationService, + private val pushNotificationSender: PushNotificationSender, private val memberService: MemberService, ) { @Async - @Transactional(propagation = Propagation.REQUIRES_NEW) @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) fun handleRentalApplied(event: RentalAppliedEvent) { val member = memberService.findById(event.memberId) - notificationService.sendNotification( + notifyUser( member, NotificationStatus.USER_RENTAL_APPLY, listOf(event.itemName), @@ -31,7 +37,7 @@ class NotificationEventHandler( ) if (!event.isDevMode) { - notificationService.sendNotificationToAdmin( + notifyAdmins( NotificationStatus.ADMIN_RENTAL_APPLY, listOf( member.name, @@ -45,12 +51,11 @@ class NotificationEventHandler( } @Async - @Transactional(propagation = Propagation.REQUIRES_NEW) @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) fun handleRentalCancelled(event: RentalCancelledEvent) { val member = memberService.findById(event.memberId) - notificationService.sendNotificationToAdmin( + notifyAdmins( NotificationStatus.ADMIN_RENTAL_CANCEL, listOf(member.name, member.studentId, event.itemName), needPush = true, @@ -58,19 +63,18 @@ class NotificationEventHandler( } @Async - @Transactional(propagation = Propagation.REQUIRES_NEW) @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) fun handleReturnApplied(event: ReturnAppliedEvent) { val member = memberService.findById(event.memberId) - notificationService.sendNotification( + notifyUser( member, NotificationStatus.USER_RETURN_APPLY, listOf(event.itemName), needPush = true, ) - notificationService.sendNotificationToAdmin( + notifyAdmins( NotificationStatus.ADMIN_RETURN_APPLY, listOf(member.name, member.studentId, event.itemName), needPush = true, @@ -78,7 +82,6 @@ class NotificationEventHandler( } @Async - @Transactional(propagation = Propagation.REQUIRES_NEW) @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) fun handleRentalStatusChanged(event: RentalStatusChangedEvent) { val member = memberService.findById(event.memberId) @@ -91,6 +94,31 @@ class NotificationEventHandler( else -> return } - notificationService.sendNotification(member, notificationStatus, listOf(event.itemName), needPush) + notifyUser(member, notificationStatus, listOf(event.itemName), needPush) + } + + private fun notifyUser( + member: Member, + status: NotificationStatus, + formatValues: List, + needPush: Boolean, + ) { + notificationService.createNotification(member, status, formatValues) + + if (needPush) { + pushNotificationSender.send(member, status, formatValues) + } + } + + private fun notifyAdmins( + status: NotificationStatus, + formatValues: List, + needPush: Boolean, + ) { + notificationService.createAdminNotification(status, formatValues) + + if (needPush) { + pushNotificationSender.sendAll(memberService.findAllWorkers(), status, formatValues) + } } } diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt index 74896cf..f3cc69c 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt @@ -1,26 +1,18 @@ package site.billilge.api.backend.domain.notification.service -import io.github.oshai.kotlinlogging.KotlinLogging import org.springframework.stereotype.Service import org.springframework.transaction.annotation.Transactional import site.billilge.api.backend.domain.member.entity.Member -import site.billilge.api.backend.domain.member.enums.Role -import site.billilge.api.backend.domain.member.service.MemberService import site.billilge.api.backend.domain.notification.entity.Notification import site.billilge.api.backend.domain.notification.enums.NotificationStatus import site.billilge.api.backend.domain.notification.exception.NotificationErrorCode import site.billilge.api.backend.domain.notification.repository.NotificationRepository import site.billilge.api.backend.global.exception.ApiException -import site.billilge.api.backend.global.external.fcm.FCMService - -private val log = KotlinLogging.logger {} @Service @Transactional(readOnly = true) class NotificationService( private val notificationRepository: NotificationRepository, - private val fcmService: FCMService, - private val memberService: MemberService, ) { fun getNotifications(memberId: Long?): List { return notificationRepository.findAllUserNotificationsByMemberId(memberId!!) @@ -45,70 +37,31 @@ class NotificationService( } @Transactional - fun sendNotification( + fun createNotification( member: Member, status: NotificationStatus, formatValues: List, - needPush: Boolean = false, - ) { + ): Notification { val notification = Notification( member = member, status = status, formatValues = formatValues.joinToString(",") ) - notificationRepository.save(notification) - - if (needPush) { - sendPushNotification(member, status, formatValues) - } - } - - private fun sendPushNotification( - member: Member, - status: NotificationStatus, - formatValues: List, - ) { - val studentId = member.studentId - - if (member.fcmToken == null) { - log.warn { "(studentId=${studentId}) FCM Token is null" } - return - } - - val isTokenValid = fcmService.sendPushNotification( - member.fcmToken!!, - status.title, - status.formattedMessage(*formatValues.toTypedArray()), - status.link, - studentId - ) - - if (!isTokenValid) { - memberService.clearFcmToken(member.id!!) - } + return notificationRepository.save(notification) } @Transactional - fun sendNotificationToAdmin( - type: NotificationStatus, + fun createAdminNotification( + status: NotificationStatus, formatValues: List, - needPush: Boolean = false - ) { - val admins = memberService.findAllWorkers() - + ): Notification { val notification = Notification( - status = type, + status = status, formatValues = formatValues.joinToString(",") ) - notificationRepository.save(notification) - - if (needPush) { - admins.forEach { admin -> - sendPushNotification(admin, type, formatValues) - } - } + return notificationRepository.save(notification) } fun getNotificationCount(memberId: Long?): Int { diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt new file mode 100644 index 0000000..af92c53 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt @@ -0,0 +1,61 @@ +package site.billilge.api.backend.domain.notification.service + +import io.github.oshai.kotlinlogging.KotlinLogging +import org.springframework.stereotype.Component +import site.billilge.api.backend.domain.member.entity.Member +import site.billilge.api.backend.domain.member.service.MemberService +import site.billilge.api.backend.domain.notification.enums.NotificationStatus +import site.billilge.api.backend.global.external.fcm.FCMService +import site.billilge.api.backend.global.external.fcm.PushResult + +private val log = KotlinLogging.logger {} + +/** + * FCM 푸시 발송 담당. + * + * 알림 저장 트랜잭션 바깥에서 호출된다. 네트워크 I/O가 DB 커넥션을 붙잡지 않도록 + * @Transactional을 걸지 않으며, 발송 실패를 예외로 전파하지 않는다. + * 한 수신자의 실패가 다른 수신자나 이미 저장된 알림에 영향을 주면 안 되기 때문이다. + */ +@Component +class PushNotificationSender( + private val fcmService: FCMService, + private val memberService: MemberService, +) { + fun send(member: Member, status: NotificationStatus, formatValues: List) { + val studentId = member.studentId + val fcmToken = member.fcmToken + + if (fcmToken == null) { + log.warn { "(studentId=$studentId) FCM Token is null" } + return + } + + val result = try { + fcmService.sendPushNotification( + fcmToken, + status.title, + status.formattedMessage(*formatValues.toTypedArray()), + status.link, + studentId + ) + } catch (e: Exception) { + // 메시지 포맷 인자 개수 불일치 등 발송 이전 단계에서 발생하는 오류 + log.error(e) { "(studentId=$studentId) 푸시 메시지 생성 실패: ${e.message}" } + return + } + + when (result) { + PushResult.Success -> Unit + PushResult.InvalidToken -> memberService.clearFcmToken(member.id!!) + is PushResult.Retryable -> log.warn { "(studentId=$studentId) 재시도 가능한 푸시 실패: ${result.reason}" } + is PushResult.Permanent -> log.error { "(studentId=$studentId) 재시도 불가능한 푸시 실패: ${result.reason}" } + } + } + + fun sendAll(members: List, status: NotificationStatus, formatValues: List) { + members.forEach { member -> + send(member, status, formatValues) + } + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/fcm/FCMService.kt b/src/main/kotlin/site/billilge/api/backend/global/external/fcm/FCMService.kt index 8e70895..1539c10 100644 --- a/src/main/kotlin/site/billilge/api/backend/global/external/fcm/FCMService.kt +++ b/src/main/kotlin/site/billilge/api/backend/global/external/fcm/FCMService.kt @@ -8,7 +8,13 @@ import site.billilge.api.backend.global.logging.log class FCMService( private val firebaseMessaging: FirebaseMessaging, ) { - fun sendPushNotification(fcmToken: String, title: String, body: String, link: String, studentId: String = "20000000"): Boolean { + fun sendPushNotification( + fcmToken: String, + title: String, + body: String, + link: String, + studentId: String = "20000000" + ): PushResult { val fcmMessage = Message.builder() .putData("title", title) .putData("body", body.replace("\n", " ")) @@ -24,15 +30,44 @@ class FCMService( return try { firebaseMessaging.send(fcmMessage) log.info { "(studentId=$studentId) FCM Message sent." } - true + PushResult.Success } catch (e: FirebaseMessagingException) { - if (e.messagingErrorCode == MessagingErrorCode.UNREGISTERED) { - log.warn { "(studentId=$studentId) FCM token is unregistered. Clearing token." } - false - } else { - log.error { "(studentId=$studentId) FCM send failed: ${e.message}" } - true + resolveFailure(e, studentId) + } catch (e: Exception) { + // 자격 증명 갱신 실패 등 SDK가 FirebaseMessagingException으로 감싸지 않는 오류 + log.error(e) { "(studentId=$studentId) FCM send failed: ${e.message}" } + PushResult.Retryable(e.javaClass.simpleName) + } + } + + private fun resolveFailure(e: FirebaseMessagingException, studentId: String): PushResult { + val errorCode = e.messagingErrorCode + + return when (errorCode) { + MessagingErrorCode.UNREGISTERED, MessagingErrorCode.SENDER_ID_MISMATCH -> { + log.warn { "(studentId=$studentId) FCM token is no longer valid($errorCode). Clearing token." } + PushResult.InvalidToken + } + + MessagingErrorCode.UNAVAILABLE, + MessagingErrorCode.INTERNAL, + MessagingErrorCode.QUOTA_EXCEEDED, + MessagingErrorCode.THIRD_PARTY_AUTH_ERROR -> { + log.error { "(studentId=$studentId) FCM send failed temporarily($errorCode): ${e.message}" } + PushResult.Retryable(errorCode.name) + } + + // 에러 코드가 없는 경우는 전송 계층 오류에 가까우므로 재시도 대상으로 둔다 + null -> { + log.error { "(studentId=$studentId) FCM send failed without error code: ${e.message}" } + PushResult.Retryable(e.javaClass.simpleName) + } + + // INVALID_ARGUMENT는 토큰 문제일 수도, 페이로드 문제일 수도 있어 토큰을 지우지 않는다 + else -> { + log.error { "(studentId=$studentId) FCM send failed permanently($errorCode): ${e.message}" } + PushResult.Permanent(errorCode.name) } } } -} \ No newline at end of file +} diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/fcm/PushResult.kt b/src/main/kotlin/site/billilge/api/backend/global/external/fcm/PushResult.kt new file mode 100644 index 0000000..da425a0 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/global/external/fcm/PushResult.kt @@ -0,0 +1,20 @@ +package site.billilge.api.backend.global.external.fcm + +/** + * FCM 푸시 발송 결과. + * + * 호출부가 "재시도해야 하는 실패"와 "재시도해도 소용없는 실패"를 구분할 수 있도록 + * 실패를 세 종류로 나눈다. + */ +sealed interface PushResult { + data object Success : PushResult + + /** 토큰이 더 이상 유효하지 않음 — 재시도 대신 토큰을 제거해야 한다 */ + data object InvalidToken : PushResult + + /** FCM 일시 장애·네트워크 오류 — 동일한 요청으로 재시도할 수 있다 */ + data class Retryable(val reason: String) : PushResult + + /** 페이로드 오류 등 재시도해도 결과가 같은 실패 */ + data class Permanent(val reason: String) : PushResult +} From ce1a92eef67bf55d96c49ec1d929d20af082cf38 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 18:41:56 +0900 Subject: [PATCH 04/14] =?UTF-8?q?chore:=20=EC=95=8C=EB=A6=BC=20=EC=A0=84?= =?UTF-8?q?=EC=9A=A9=20=EB=B9=84=EB=8F=99=EA=B8=B0=20=EC=8B=A4=ED=96=89?= =?UTF-8?q?=EA=B8=B0=EC=99=80=20=EC=98=88=EC=99=B8=20=ED=95=B8=EB=93=A4?= =?UTF-8?q?=EB=9F=AC=20=EC=84=A4=EC=A0=95=20(#144)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 자동 설정 실행기(applicationTaskExecutor)는 큐가 무제한이라 FCM 지연 시 태스크가 계속 쌓이고, 종료 대기 설정이 없어 배포 시 큐에 남은 알림이 유실됐다. - notificationTaskExecutor 정의 (코어 4 / 최대 8 / 큐 500) - 큐 포화 시 CallerRunsPolicy로 유실 대신 지연 선택 - 종료 시 최대 20초간 잔여 작업 처리 대기 - AsyncUncaughtExceptionHandler 등록해 실패한 비동기 작업을 식별 가능하도록 기록 Co-Authored-By: Claude Opus 5 --- .../api/backend/global/config/AsyncConfig.kt | 49 ++++++++++++++++++- 1 file changed, 47 insertions(+), 2 deletions(-) diff --git a/src/main/kotlin/site/billilge/api/backend/global/config/AsyncConfig.kt b/src/main/kotlin/site/billilge/api/backend/global/config/AsyncConfig.kt index 71b0bd9..96887a5 100644 --- a/src/main/kotlin/site/billilge/api/backend/global/config/AsyncConfig.kt +++ b/src/main/kotlin/site/billilge/api/backend/global/config/AsyncConfig.kt @@ -1,9 +1,54 @@ package site.billilge.api.backend.global.config +import io.github.oshai.kotlinlogging.KotlinLogging +import org.springframework.aop.interceptor.AsyncUncaughtExceptionHandler +import org.springframework.context.annotation.Bean import org.springframework.context.annotation.Configuration +import org.springframework.scheduling.annotation.AsyncConfigurer import org.springframework.scheduling.annotation.EnableAsync +import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor +import java.util.concurrent.Executor +import java.util.concurrent.ThreadPoolExecutor + +private val log = KotlinLogging.logger {} @EnableAsync @Configuration -class AsyncConfig { -} \ No newline at end of file +class AsyncConfig : AsyncConfigurer { + /** + * 알림 발송 전용 실행기. + * + * 자동 설정 실행기(applicationTaskExecutor)는 큐가 무제한이라 FCM이 지연되면 태스크가 + * 계속 쌓이고, 종료 대기 설정이 없어 배포 시 큐에 남은 알림이 유실된다. + */ + @Bean + fun notificationTaskExecutor(): ThreadPoolTaskExecutor = ThreadPoolTaskExecutor().apply { + corePoolSize = CORE_POOL_SIZE + maxPoolSize = MAX_POOL_SIZE + setQueueCapacity(QUEUE_CAPACITY) + setThreadNamePrefix("notification-") + + // 큐가 가득 차면 버리는 대신 호출 스레드에서 실행한다 — 유실보다 지연을 택한다 + setRejectedExecutionHandler(ThreadPoolExecutor.CallerRunsPolicy()) + + // 종료 시 큐에 남은 알림을 처리할 시간을 준다 + setWaitForTasksToCompleteOnShutdown(true) + setAwaitTerminationSeconds(AWAIT_TERMINATION_SECONDS) + } + + override fun getAsyncExecutor(): Executor = notificationTaskExecutor() + + override fun getAsyncUncaughtExceptionHandler(): AsyncUncaughtExceptionHandler = + AsyncUncaughtExceptionHandler { ex, method, params -> + log.error(ex) { + "비동기 작업 실패: ${method.declaringClass.simpleName}.${method.name}(${params.joinToString()})" + } + } + + companion object { + private const val CORE_POOL_SIZE = 4 + private const val MAX_POOL_SIZE = 8 + private const val QUEUE_CAPACITY = 500 + private const val AWAIT_TERMINATION_SECONDS = 20 + } +} From 2dd3d4f97503902d19d6cf6f252e98bd57d19b87 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 19:13:54 +0900 Subject: [PATCH 05/14] =?UTF-8?q?feat:=20=EC=95=84=EC=9B=83=EB=B0=95?= =?UTF-8?q?=EC=8A=A4=20=EA=B8=B0=EB=B0=98=20=ED=91=B8=EC=8B=9C=20=EB=B0=9C?= =?UTF-8?q?=EC=86=A1=20=EC=9E=AC=EC=8B=9C=EB=8F=84=20(#146)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Retryable로 분류된 푸시 실패가 로그로만 남고 유실됐다. FCM 일시 장애나 네트워크 오류로 실패하면 사용자는 대여 승인 알림을 영영 받지 못한다. 발송 대상을 수신자 단위 row로 DB에 남기고 스케줄러가 미발송 건을 재시도한다. 알림과 같은 트랜잭션에서 저장되므로 프로세스가 재시작돼도 발송 대상이 남는다. - notification_push_outbox 테이블 및 엔티티 추가 (상태/재시도 횟수/다음 시도 시각/마지막 오류) - 백오프 30초 → 2분 → 5분 → 15분, 최대 4회. 생성 후 1시간 경과 시 EXPIRED로 포기 - 즉시 발송과 재시도가 같은 경로(PushNotificationSender.dispatch)를 공유 - 새 row의 nextRetryAt을 60초 뒤로 잡아 즉시 시도와 폴러의 중복 발송 방지 - InvalidToken은 재시도 없이 토큰 제거 후 종료 - 상태 전이(백오프/최대 횟수/TTL) 단위 테스트 추가 Co-Authored-By: Claude Opus 5 --- CLAUDE.md | 33 ++++- .../notification/dto/PushDispatchTarget.kt | 17 +++ .../entity/NotificationPushOutbox.kt | 130 ++++++++++++++++++ .../notification/enums/PushDeliveryStatus.kt | 15 ++ .../handler/NotificationEventHandler.kt | 21 +-- .../NotificationPushOutboxRepository.kt | 23 ++++ .../scheduler/PushRetryScheduler.kt | 44 ++++++ .../service/NotificationPushOutboxService.kt | 103 ++++++++++++++ .../service/NotificationService.kt | 35 +++-- .../service/PushNotificationSender.kt | 63 +++++---- .../backend/global/config/SchedulingConfig.kt | 14 ++ .../entity/NotificationPushOutboxTest.kt | 98 +++++++++++++ 12 files changed, 543 insertions(+), 53 deletions(-) create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/dto/PushDispatchTarget.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/enums/PushDeliveryStatus.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushRetryScheduler.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/global/config/SchedulingConfig.kt create mode 100644 src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt diff --git a/CLAUDE.md b/CLAUDE.md index bbb5bab..bcf62fd 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -74,10 +74,11 @@ domain/{name}/ ``` ItemService → ItemRepository, S3Service MemberService → MemberRepository, TokenProvider, PayerService -NotificationService → NotificationRepository -PushNotificationSender → FCMService, MemberService -PayerService → PayerRepository, MemberRepository, ExcelGenerator -RentalService → RentalRepository, ApplicationEventPublisher +NotificationService → NotificationRepository, NotificationPushOutboxService +NotificationPushOutboxService → NotificationPushOutboxRepository +PushNotificationSender → FCMService, MemberService, NotificationPushOutboxService +PayerService → PayerRepository, MemberRepository, ExcelGenerator +RentalService → RentalRepository, ApplicationEventPublisher ``` ### 알림 발송 구조 @@ -87,8 +88,11 @@ RentalService → RentalRepository, ApplicationEventPublisher ``` RentalService → 이벤트 발행 └ NotificationEventHandler (@Async + AFTER_COMMIT, 트랜잭션 없음) - ├ NotificationService.createNotification() # 짧은 트랜잭션에서 저장 후 즉시 커밋 - └ PushNotificationSender.send() # 트랜잭션 밖에서 FCM 호출 + ├ NotificationService.createNotification() # 알림 + 아웃박스 저장 (한 트랜잭션, 즉시 커밋) + └ PushNotificationSender.dispatch() # 트랜잭션 밖에서 FCM 호출 + +PushRetryScheduler (@Scheduled, 30초 간격) + └ PushNotificationSender.dispatch() # 미발송 건 재시도 (같은 경로) ``` - **푸시 발송은 트랜잭션 밖에서 수행한다** — 네트워크 I/O가 DB 커넥션을 점유하지 않도록, 그리고 푸시 실패가 저장된 알림을 롤백시키지 않도록 분리 @@ -96,6 +100,23 @@ RentalService → 이벤트 발행 - **FCM 실패는 `PushResult`로 구분한다** — `InvalidToken`(토큰 제거) / `Retryable`(재시도 대상) / `Permanent`(재시도 무의미) - **`@Async`는 알림 전용 실행기(`notificationTaskExecutor`)를 사용한다** — `AsyncConfig`에 정의 +### 푸시 재시도 (아웃박스) + +발송 대상을 `notification_push_outbox`에 **수신자 단위 row**로 남긴다. 알림과 같은 트랜잭션에서 저장되므로 프로세스가 재시작돼도 발송 대상이 남는다. + +``` +PENDING ─┬─ 발송 성공 ──────────────→ SENT + ├─ Retryable 실패 ─ 백오프 → PENDING (재시도 횟수 소진 시 FAILED) + ├─ InvalidToken/Permanent → FAILED + └─ 생성 후 1시간 경과 ─────→ EXPIRED +``` + +- **백오프는 `30초 → 2분 → 5분 → 15분`, 최대 4회** — `NotificationPushOutbox`의 상수로 정의 +- **생성 후 1시간이 지나면 포기한다(`EXPIRED`)** — 늦게 도착하는 푸시는 의미가 없다. 인앱 알림은 이미 저장돼 있음 +- **즉시 발송과 재시도가 같은 경로를 탄다** — 새 row의 `nextRetryAt`은 60초 뒤로 잡혀, 즉시 시도와 폴러가 겹치지 않는다 +- **메시지 본문은 저장하지 않는다** — 연결된 `Notification`의 status와 formatValues로 재구성 +- 인스턴스를 여러 대로 늘리면 조회에 잠금(`FOR UPDATE SKIP LOCKED`)이나 ShedLock이 필요하다 + ## 대여 상태 머신 ``` diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/dto/PushDispatchTarget.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/dto/PushDispatchTarget.kt new file mode 100644 index 0000000..95d0c3c --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/dto/PushDispatchTarget.kt @@ -0,0 +1,17 @@ +package site.billilge.api.backend.domain.notification.dto + +import site.billilge.api.backend.domain.notification.enums.NotificationStatus + +/** + * 아웃박스 한 건을 발송하는 데 필요한 값. + * + * FCM 호출은 트랜잭션 밖에서 이뤄지므로 엔티티 대신 이 값만 꺼내 넘긴다. + */ +data class PushDispatchTarget( + val outboxId: Long, + val receiverId: Long, + val studentId: String, + val fcmToken: String?, + val status: NotificationStatus, + val formatValues: List, +) diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt new file mode 100644 index 0000000..548fd58 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt @@ -0,0 +1,130 @@ +package site.billilge.api.backend.domain.notification.entity + +import jakarta.persistence.* +import org.hibernate.annotations.OnDelete +import org.hibernate.annotations.OnDeleteAction +import org.springframework.data.annotation.CreatedDate +import org.springframework.data.annotation.LastModifiedDate +import org.springframework.data.jpa.domain.support.AuditingEntityListener +import site.billilge.api.backend.domain.member.entity.Member +import site.billilge.api.backend.domain.notification.enums.PushDeliveryStatus +import java.time.Duration +import java.time.LocalDateTime + +/** + * 푸시 발송 대기열. + * + * 알림 저장과 같은 트랜잭션에서 수신자 수만큼 생성된다. 발송 실패 시 상태와 재시도 시각만 + * 갱신되므로 프로세스가 재시작돼도 발송 대상이 남는다. + * + * 메시지 본문은 저장하지 않는다 — 연결된 [Notification]의 status와 formatValues로 재구성한다. + */ +@Entity +@Table( + name = "notification_push_outbox", + indexes = [Index(name = "idx_push_outbox_delivery", columnList = "delivery_status, next_retry_at")] +) +@EntityListeners(AuditingEntityListener::class) +class NotificationPushOutbox( + @JoinColumn(name = "notification_id", nullable = false) + @ManyToOne(fetch = FetchType.LAZY) + @OnDelete(action = OnDeleteAction.CASCADE) + val notification: Notification, + + @JoinColumn(name = "receiver_id", nullable = false) + @ManyToOne(fetch = FetchType.LAZY) + @OnDelete(action = OnDeleteAction.CASCADE) + val receiver: Member, +) { + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + @Column(name = "notification_push_outbox_id", nullable = false) + val id: Long? = null + + @Enumerated(EnumType.STRING) + @Column(name = "delivery_status", nullable = false) + var deliveryStatus: PushDeliveryStatus = PushDeliveryStatus.PENDING + protected set + + @Column(name = "retry_count", nullable = false) + var retryCount: Int = 0 + protected set + + /** + * 폴러는 이 시각이 지난 건만 집어간다. + * + * 생성 직후에는 이벤트 핸들러가 즉시 1회 발송을 시도하므로, 그 시도와 폴러가 겹쳐 + * 중복 발송되지 않도록 첫 대상 시각을 뒤로 미뤄 둔다. + */ + @Column(name = "next_retry_at", nullable = false) + var nextRetryAt: LocalDateTime = LocalDateTime.now().plus(FIRST_POLL_DELAY) + protected set + + @Column(name = "last_error", length = MAX_ERROR_LENGTH) + var lastError: String? = null + protected set + + @CreatedDate + @Column(name = "created_at", nullable = false, updatable = false) + var createdAt: LocalDateTime = LocalDateTime.now() + protected set + + @LastModifiedDate + @Column(name = "updated_at", nullable = false) + var updatedAt: LocalDateTime = LocalDateTime.now() + protected set + + fun markSent() { + deliveryStatus = PushDeliveryStatus.SENT + lastError = null + } + + /** 재시도해도 결과가 같은 실패 — 더 시도하지 않는다 */ + fun markFailed(reason: String) { + deliveryStatus = PushDeliveryStatus.FAILED + lastError = reason.take(MAX_ERROR_LENGTH) + } + + fun markExpired() { + deliveryStatus = PushDeliveryStatus.EXPIRED + } + + /** + * 재시도 가능한 실패를 기록하고 다음 시도 시각을 뒤로 민다. + * 재시도 횟수를 모두 썼거나 유효 시간이 지났으면 발송을 포기한다. + */ + fun recordRetryableFailure(reason: String, now: LocalDateTime = LocalDateTime.now()) { + lastError = reason.take(MAX_ERROR_LENGTH) + + if (isExpired(now)) { + markExpired() + return + } + + if (retryCount >= BACKOFF_SECONDS.size) { + deliveryStatus = PushDeliveryStatus.FAILED + return + } + + nextRetryAt = now.plusSeconds(BACKOFF_SECONDS[retryCount]) + retryCount++ + } + + fun isPending(): Boolean = deliveryStatus == PushDeliveryStatus.PENDING + + fun isExpired(now: LocalDateTime = LocalDateTime.now()): Boolean = + now.isAfter(createdAt.plus(TIME_TO_LIVE)) + + companion object { + /** 즉시 발송 시도와 폴러가 겹치지 않도록 두는 간격 */ + private val FIRST_POLL_DELAY: Duration = Duration.ofSeconds(60) + + /** 늦게 도착하는 푸시는 의미가 없으므로 1시간까지만 재시도한다 */ + private val TIME_TO_LIVE: Duration = Duration.ofHours(1) + + /** 재시도 간격(초) — 배열 길이가 곧 최대 재시도 횟수 */ + private val BACKOFF_SECONDS = longArrayOf(30, 120, 300, 900) + + private const val MAX_ERROR_LENGTH = 500 + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/enums/PushDeliveryStatus.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/enums/PushDeliveryStatus.kt new file mode 100644 index 0000000..5d74ae6 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/enums/PushDeliveryStatus.kt @@ -0,0 +1,15 @@ +package site.billilge.api.backend.domain.notification.enums + +enum class PushDeliveryStatus { + /** 발송 대기 — 폴러가 재시도 대상으로 집어간다 */ + PENDING, + + /** 발송 완료 */ + SENT, + + /** 재시도 횟수를 모두 썼거나 재시도해도 소용없는 실패 */ + FAILED, + + /** 유효 시간이 지나 발송을 포기함 — 늦게 도착하는 푸시는 의미가 없다 */ + EXPIRED, +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt index 499b32b..8b6c62a 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt @@ -103,11 +103,14 @@ class NotificationEventHandler( formatValues: List, needPush: Boolean, ) { - notificationService.createNotification(member, status, formatValues) + val outboxIds = notificationService.createNotification( + member, + status, + formatValues, + pushReceivers = if (needPush) listOf(member) else emptyList(), + ) - if (needPush) { - pushNotificationSender.send(member, status, formatValues) - } + pushNotificationSender.dispatch(outboxIds) } private fun notifyAdmins( @@ -115,10 +118,12 @@ class NotificationEventHandler( formatValues: List, needPush: Boolean, ) { - notificationService.createAdminNotification(status, formatValues) + val outboxIds = notificationService.createAdminNotification( + status, + formatValues, + pushReceivers = if (needPush) memberService.findAllWorkers() else emptyList(), + ) - if (needPush) { - pushNotificationSender.sendAll(memberService.findAllWorkers(), status, formatValues) - } + pushNotificationSender.dispatch(outboxIds) } } diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt new file mode 100644 index 0000000..b7fd2ae --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt @@ -0,0 +1,23 @@ +package site.billilge.api.backend.domain.notification.repository + +import org.springframework.data.domain.Pageable +import org.springframework.data.jpa.repository.JpaRepository +import org.springframework.data.jpa.repository.Query +import site.billilge.api.backend.domain.notification.entity.NotificationPushOutbox +import site.billilge.api.backend.domain.notification.enums.PushDeliveryStatus +import java.time.LocalDateTime + +interface NotificationPushOutboxRepository : JpaRepository { + @Query( + """ + SELECT o.id FROM NotificationPushOutbox o + WHERE o.deliveryStatus = :deliveryStatus AND o.nextRetryAt <= :now + ORDER BY o.nextRetryAt ASC + """ + ) + fun findDispatchTargetIds( + deliveryStatus: PushDeliveryStatus, + now: LocalDateTime, + pageable: Pageable + ): List +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushRetryScheduler.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushRetryScheduler.kt new file mode 100644 index 0000000..0b500af --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushRetryScheduler.kt @@ -0,0 +1,44 @@ +package site.billilge.api.backend.domain.notification.scheduler + +import io.github.oshai.kotlinlogging.KotlinLogging +import org.springframework.scheduling.annotation.Scheduled +import org.springframework.stereotype.Component +import site.billilge.api.backend.domain.notification.service.NotificationPushOutboxService +import site.billilge.api.backend.domain.notification.service.PushNotificationSender +import site.billilge.api.backend.global.external.fcm.PushResult + +private val log = KotlinLogging.logger {} + +/** + * 발송되지 못한 푸시를 주기적으로 재시도한다. + * + * fixedDelay라 이전 주기가 끝난 뒤에 다음 주기가 시작된다 — 발송이 밀려도 중복 실행되지 않는다. + */ +@Component +class PushRetryScheduler( + private val notificationPushOutboxService: NotificationPushOutboxService, + private val pushNotificationSender: PushNotificationSender, +) { + @Scheduled( + initialDelayString = "\${notification.push.retry.initial-delay-ms:60000}", + fixedDelayString = "\${notification.push.retry.poll-interval-ms:30000}", + ) + fun retryFailedPushes() { + val targetIds = notificationPushOutboxService.findRetryTargetIds(BATCH_SIZE) + + if (targetIds.isEmpty()) return + + val results = pushNotificationSender.dispatch(targetIds) + val sentCount = results.count { result -> result == PushResult.Success } + + log.info { "푸시 재시도 ${results.size}건 처리 (성공 $sentCount, 실패 ${results.size - sentCount})" } + + if (targetIds.size == BATCH_SIZE) { + log.warn { "재시도 대상이 한 주기 처리량(${BATCH_SIZE}건)을 채웠습니다. 남은 건은 다음 주기에 처리됩니다." } + } + } + + companion object { + private const val BATCH_SIZE = 100 + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt new file mode 100644 index 0000000..55ac573 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt @@ -0,0 +1,103 @@ +package site.billilge.api.backend.domain.notification.service + +import io.github.oshai.kotlinlogging.KotlinLogging +import org.springframework.data.domain.PageRequest +import org.springframework.data.repository.findByIdOrNull +import org.springframework.stereotype.Service +import org.springframework.transaction.annotation.Transactional +import site.billilge.api.backend.domain.member.entity.Member +import site.billilge.api.backend.domain.notification.dto.PushDispatchTarget +import site.billilge.api.backend.domain.notification.entity.Notification +import site.billilge.api.backend.domain.notification.entity.NotificationPushOutbox +import site.billilge.api.backend.domain.notification.enums.PushDeliveryStatus +import site.billilge.api.backend.domain.notification.repository.NotificationPushOutboxRepository +import site.billilge.api.backend.global.external.fcm.PushResult +import java.time.LocalDateTime + +private val log = KotlinLogging.logger {} + +@Service +@Transactional(readOnly = true) +class NotificationPushOutboxService( + private val notificationPushOutboxRepository: NotificationPushOutboxRepository, +) { + /** + * 발송 대기열에 수신자 수만큼 등록한다. + * + * 알림 저장 트랜잭션에 참여하므로, 알림과 발송 대상은 함께 저장되거나 함께 롤백된다. + */ + @Transactional + fun register(notification: Notification, receivers: List): List { + return receivers + .filter { receiver -> receiver.hasFcmToken() } + .map { receiver -> + notificationPushOutboxRepository.save(NotificationPushOutbox(notification, receiver)).id!! + } + } + + fun findRetryTargetIds(limit: Int): List { + return notificationPushOutboxRepository.findDispatchTargetIds( + PushDeliveryStatus.PENDING, + LocalDateTime.now(), + PageRequest.of(0, limit) + ) + } + + /** + * 발송에 필요한 값을 꺼내 온다. 이미 처리됐거나 유효 시간이 지난 건은 null을 반환한다. + */ + @Transactional + fun findDispatchTarget(outboxId: Long): PushDispatchTarget? { + val outbox = notificationPushOutboxRepository.findByIdOrNull(outboxId) ?: return null + + if (!outbox.isPending()) return null + + if (outbox.isExpired()) { + outbox.markExpired() + log.warn { "(outboxId=$outboxId) 유효 시간이 지나 푸시 발송을 포기합니다." } + return null + } + + val receiver = outbox.receiver + val notification = outbox.notification + + return PushDispatchTarget( + outboxId = outboxId, + receiverId = receiver.id!!, + studentId = receiver.studentId, + fcmToken = receiver.fcmToken, + status = notification.status, + formatValues = notification.formatValueList, + ) + } + + @Transactional + fun applyResult(outboxId: Long, result: PushResult) { + val outbox = notificationPushOutboxRepository.findByIdOrNull(outboxId) ?: return + + when (result) { + PushResult.Success -> outbox.markSent() + PushResult.InvalidToken -> outbox.markFailed(INVALID_TOKEN_REASON) + is PushResult.Permanent -> outbox.markFailed(result.reason) + is PushResult.Retryable -> outbox.recordRetryableFailure(result.reason) + } + + if (outbox.deliveryStatus == PushDeliveryStatus.FAILED || outbox.deliveryStatus == PushDeliveryStatus.EXPIRED) { + log.error { + "(outboxId=$outboxId) 푸시 발송을 포기합니다. " + + "status=${outbox.deliveryStatus}, retryCount=${outbox.retryCount}, reason=${outbox.lastError}" + } + } + } + + private fun Member.hasFcmToken(): Boolean { + if (fcmToken != null) return true + + log.warn { "(studentId=$studentId) FCM Token is null" } + return false + } + + companion object { + private const val INVALID_TOKEN_REASON = "INVALID_TOKEN" + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt index f3cc69c..ab8683c 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationService.kt @@ -13,6 +13,7 @@ import site.billilge.api.backend.global.exception.ApiException @Transactional(readOnly = true) class NotificationService( private val notificationRepository: NotificationRepository, + private val notificationPushOutboxService: NotificationPushOutboxService, ) { fun getNotifications(memberId: Long?): List { return notificationRepository.findAllUserNotificationsByMemberId(memberId!!) @@ -36,32 +37,44 @@ class NotificationService( return notificationRepository.findAllAdminNotificationsByMemberId(memberId!!) } + /** + * 알림을 저장하고 푸시 발송 대상을 대기열에 등록한다. 등록된 아웃박스 ID를 반환한다. + * + * 알림과 발송 대상이 하나의 트랜잭션에서 저장되므로, 커밋된 이후에는 발송이 누락되더라도 + * 대기열에 남아 재시도된다. + */ @Transactional fun createNotification( member: Member, status: NotificationStatus, formatValues: List, - ): Notification { - val notification = Notification( - member = member, - status = status, - formatValues = formatValues.joinToString(",") + pushReceivers: List = emptyList(), + ): List { + val notification = notificationRepository.save( + Notification( + member = member, + status = status, + formatValues = formatValues.joinToString(",") + ) ) - return notificationRepository.save(notification) + return notificationPushOutboxService.register(notification, pushReceivers) } @Transactional fun createAdminNotification( status: NotificationStatus, formatValues: List, - ): Notification { - val notification = Notification( - status = status, - formatValues = formatValues.joinToString(",") + pushReceivers: List = emptyList(), + ): List { + val notification = notificationRepository.save( + Notification( + status = status, + formatValues = formatValues.joinToString(",") + ) ) - return notificationRepository.save(notification) + return notificationPushOutboxService.register(notification, pushReceivers) } fun getNotificationCount(memberId: Long?): Int { diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt index af92c53..1ed1223 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/PushNotificationSender.kt @@ -2,60 +2,67 @@ package site.billilge.api.backend.domain.notification.service import io.github.oshai.kotlinlogging.KotlinLogging import org.springframework.stereotype.Component -import site.billilge.api.backend.domain.member.entity.Member import site.billilge.api.backend.domain.member.service.MemberService -import site.billilge.api.backend.domain.notification.enums.NotificationStatus +import site.billilge.api.backend.domain.notification.dto.PushDispatchTarget import site.billilge.api.backend.global.external.fcm.FCMService import site.billilge.api.backend.global.external.fcm.PushResult private val log = KotlinLogging.logger {} /** - * FCM 푸시 발송 담당. + * 아웃박스에 등록된 푸시를 발송한다. * * 알림 저장 트랜잭션 바깥에서 호출된다. 네트워크 I/O가 DB 커넥션을 붙잡지 않도록 * @Transactional을 걸지 않으며, 발송 실패를 예외로 전파하지 않는다. - * 한 수신자의 실패가 다른 수신자나 이미 저장된 알림에 영향을 주면 안 되기 때문이다. + * 한 수신자의 실패가 다른 수신자에게 영향을 주면 안 되기 때문이다. + * + * 알림 발생 직후의 즉시 발송과 [PushRetryScheduler]의 재시도가 이 경로를 공유한다. */ @Component class PushNotificationSender( private val fcmService: FCMService, private val memberService: MemberService, + private val notificationPushOutboxService: NotificationPushOutboxService, ) { - fun send(member: Member, status: NotificationStatus, formatValues: List) { - val studentId = member.studentId - val fcmToken = member.fcmToken + fun dispatch(outboxIds: List): List { + return outboxIds.mapNotNull { outboxId -> dispatchOne(outboxId) } + } + + /** 이미 처리됐거나 유효 시간이 지난 건은 건너뛰고 null을 반환한다 */ + private fun dispatchOne(outboxId: Long): PushResult? { + val target = notificationPushOutboxService.findDispatchTarget(outboxId) ?: return null - if (fcmToken == null) { - log.warn { "(studentId=$studentId) FCM Token is null" } - return + val result = send(target) + + notificationPushOutboxService.applyResult(outboxId, result) + + if (result == PushResult.InvalidToken) { + memberService.clearFcmToken(target.receiverId) } - val result = try { + return result + } + + private fun send(target: PushDispatchTarget): PushResult { + val fcmToken = target.fcmToken + ?: return PushResult.Permanent(TOKEN_NOT_REGISTERED_REASON) + + return try { fcmService.sendPushNotification( fcmToken, - status.title, - status.formattedMessage(*formatValues.toTypedArray()), - status.link, - studentId + target.status.title, + target.status.formattedMessage(*target.formatValues.toTypedArray()), + target.status.link, + target.studentId ) } catch (e: Exception) { // 메시지 포맷 인자 개수 불일치 등 발송 이전 단계에서 발생하는 오류 - log.error(e) { "(studentId=$studentId) 푸시 메시지 생성 실패: ${e.message}" } - return - } - - when (result) { - PushResult.Success -> Unit - PushResult.InvalidToken -> memberService.clearFcmToken(member.id!!) - is PushResult.Retryable -> log.warn { "(studentId=$studentId) 재시도 가능한 푸시 실패: ${result.reason}" } - is PushResult.Permanent -> log.error { "(studentId=$studentId) 재시도 불가능한 푸시 실패: ${result.reason}" } + log.error(e) { "(studentId=${target.studentId}) 푸시 메시지 생성 실패: ${e.message}" } + PushResult.Permanent(e.javaClass.simpleName) } } - fun sendAll(members: List, status: NotificationStatus, formatValues: List) { - members.forEach { member -> - send(member, status, formatValues) - } + companion object { + private const val TOKEN_NOT_REGISTERED_REASON = "FCM_TOKEN_NOT_REGISTERED" } } diff --git a/src/main/kotlin/site/billilge/api/backend/global/config/SchedulingConfig.kt b/src/main/kotlin/site/billilge/api/backend/global/config/SchedulingConfig.kt new file mode 100644 index 0000000..52ccf38 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/global/config/SchedulingConfig.kt @@ -0,0 +1,14 @@ +package site.billilge.api.backend.global.config + +import org.springframework.context.annotation.Configuration +import org.springframework.scheduling.annotation.EnableScheduling + +/** + * 스케줄러는 단일 스레드에서 순차 실행된다. + * + * 인스턴스를 여러 대로 늘리면 같은 발송 건을 동시에 집어갈 수 있으므로, + * 그때는 조회에 잠금(FOR UPDATE SKIP LOCKED)이나 ShedLock이 필요하다. + */ +@EnableScheduling +@Configuration +class SchedulingConfig diff --git a/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt b/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt new file mode 100644 index 0000000..51fc4eb --- /dev/null +++ b/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt @@ -0,0 +1,98 @@ +package site.billilge.api.backend.domain.notification.entity + +import org.junit.jupiter.api.Assertions.assertEquals +import org.junit.jupiter.api.Assertions.assertTrue +import org.junit.jupiter.api.DisplayName +import org.junit.jupiter.api.Test +import site.billilge.api.backend.domain.member.entity.Member +import site.billilge.api.backend.domain.notification.enums.NotificationStatus +import site.billilge.api.backend.domain.notification.enums.PushDeliveryStatus +import java.time.LocalDateTime + +class NotificationPushOutboxTest { + @Test + @DisplayName("생성 직후에는 즉시 발송 시도와 겹치지 않도록 폴러 대상 시각이 뒤로 밀려 있다") + fun `첫 폴링 시각은 생성 시각보다 뒤에 있다`() { + val outbox = createOutbox() + + assertTrue(outbox.nextRetryAt.isAfter(outbox.createdAt)) + assertEquals(PushDeliveryStatus.PENDING, outbox.deliveryStatus) + assertEquals(0, outbox.retryCount) + } + + @Test + @DisplayName("재시도 가능한 실패는 정해진 간격만큼 다음 시도를 미룬다") + fun `백오프 간격이 점점 늘어난다`() { + val outbox = createOutbox() + val now = LocalDateTime.now() + + val expectedBackoffSeconds = listOf(30L, 120L, 300L, 900L) + + expectedBackoffSeconds.forEachIndexed { index, seconds -> + outbox.recordRetryableFailure("UNAVAILABLE", now) + + assertEquals(now.plusSeconds(seconds), outbox.nextRetryAt) + assertEquals(index + 1, outbox.retryCount) + assertEquals(PushDeliveryStatus.PENDING, outbox.deliveryStatus) + } + } + + @Test + @DisplayName("재시도 횟수를 모두 쓰면 발송을 포기한다") + fun `최대 재시도 횟수를 넘기면 FAILED가 된다`() { + val outbox = createOutbox() + val now = LocalDateTime.now() + + repeat(4) { outbox.recordRetryableFailure("UNAVAILABLE", now) } + assertEquals(PushDeliveryStatus.PENDING, outbox.deliveryStatus) + + outbox.recordRetryableFailure("UNAVAILABLE", now) + + assertEquals(PushDeliveryStatus.FAILED, outbox.deliveryStatus) + assertEquals("UNAVAILABLE", outbox.lastError) + } + + @Test + @DisplayName("유효 시간이 지나면 재시도 횟수가 남아 있어도 포기한다") + fun `TTL을 넘기면 EXPIRED가 된다`() { + val outbox = createOutbox() + + outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now().plusHours(2)) + + assertEquals(PushDeliveryStatus.EXPIRED, outbox.deliveryStatus) + assertEquals(0, outbox.retryCount) + } + + @Test + @DisplayName("발송에 성공하면 직전 실패 기록을 지운다") + fun `markSent는 lastError를 비운다`() { + val outbox = createOutbox() + outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now()) + + outbox.markSent() + + assertEquals(PushDeliveryStatus.SENT, outbox.deliveryStatus) + assertEquals(null, outbox.lastError) + } + + @Test + @DisplayName("처리가 끝난 건은 다시 발송 대상이 되지 않는다") + fun `SENT 상태는 isPending이 false다`() { + val outbox = createOutbox() + + outbox.markSent() + + assertTrue(!outbox.isPending()) + } + + private fun createOutbox(): NotificationPushOutbox { + val member = Member(name = "김국민", studentId = "20240001") + val notification = Notification( + member = member, + status = NotificationStatus.USER_RENTAL_APPROVED, + formatValues = "우산" + ) + + return NotificationPushOutbox(notification, member) + } +} From 1a600d2d0804311c5eb6ce8ca0ec6f2f01f8db34 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 19:52:33 +0900 Subject: [PATCH 06/14] =?UTF-8?q?chore:=20=ED=91=B8=EC=8B=9C=20=EC=95=84?= =?UTF-8?q?=EC=9B=83=EB=B0=95=EC=8A=A4=20=EB=B3=B4=EA=B4=80=20=EC=A0=95?= =?UTF-8?q?=EC=B1=85=20=EB=B0=8F=20=EC=A0=95=EB=A6=AC=20=EC=8A=A4=EC=BC=80?= =?UTF-8?q?=EC=A4=84=EB=9F=AC=20(#147)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 발송이 끝난 아웃박스 row가 계속 남았다. 알림 한 건마다 수신자 수만큼 쌓이므로 방치하면 재시도 대상 조회가 느려진다. - 매일 새벽 4시(KST) 보존 기간이 지난 건 삭제 - SENT 7일, FAILED/EXPIRED 30일(실패 원인 확인용), PENDING은 삭제하지 않음 - 배치(500건) 단위로 나눠 삭제하고 배치마다 트랜잭션을 끊어 락 구간을 짧게 유지 - 한 회 처리량 상한(20배치)에 도달하면 남은 건이 있다는 경고 로그 - 정리 조회용 인덱스 (delivery_status, created_at) 추가 Co-Authored-By: Claude Opus 5 --- CLAUDE.md | 11 +++ .../entity/NotificationPushOutbox.kt | 5 +- .../NotificationPushOutboxRepository.kt | 13 ++++ .../scheduler/PushOutboxPurgeScheduler.kt | 71 +++++++++++++++++++ .../service/NotificationPushOutboxService.kt | 25 +++++++ 5 files changed, 124 insertions(+), 1 deletion(-) create mode 100644 src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushOutboxPurgeScheduler.kt diff --git a/CLAUDE.md b/CLAUDE.md index bcf62fd..0532a97 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -117,6 +117,17 @@ PENDING ─┬─ 발송 성공 ──────────────→ SE - **메시지 본문은 저장하지 않는다** — 연결된 `Notification`의 status와 formatValues로 재구성 - 인스턴스를 여러 대로 늘리면 조회에 잠금(`FOR UPDATE SKIP LOCKED`)이나 ShedLock이 필요하다 +**보관 정책** — `PushOutboxPurgeScheduler`가 매일 새벽 4시(KST)에 정리한다. + +| 상태 | 보존 기간 | +|---|---| +| `SENT` | 7일 | +| `FAILED`, `EXPIRED` | 30일 (실패 원인 확인용) | +| `PENDING` | 삭제하지 않음 | + +- **배치(500건)로 나눠 삭제하고 배치마다 트랜잭션을 끊는다** — 락 구간을 짧게 유지 +- **한 회 처리량 상한(20배치)에 도달하면 경고 로그를 남긴다** — 남은 건이 있다는 사실이 묻히지 않도록 + ## 대여 상태 머신 ``` diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt index 548fd58..257f4c2 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt @@ -22,7 +22,10 @@ import java.time.LocalDateTime @Entity @Table( name = "notification_push_outbox", - indexes = [Index(name = "idx_push_outbox_delivery", columnList = "delivery_status, next_retry_at")] + indexes = [ + Index(name = "idx_push_outbox_delivery", columnList = "delivery_status, next_retry_at"), + Index(name = "idx_push_outbox_purge", columnList = "delivery_status, created_at"), + ] ) @EntityListeners(AuditingEntityListener::class) class NotificationPushOutbox( diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt index b7fd2ae..c335bc8 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/repository/NotificationPushOutboxRepository.kt @@ -20,4 +20,17 @@ interface NotificationPushOutboxRepository : JpaRepository + + /** 정렬하지 않는다 — 보존 기간이 지난 건을 모두 지우므로 삭제 순서는 중요하지 않다 */ + @Query( + """ + SELECT o.id FROM NotificationPushOutbox o + WHERE o.deliveryStatus IN :deliveryStatuses AND o.createdAt < :createdBefore + """ + ) + fun findPurgeTargetIds( + deliveryStatuses: Collection, + createdBefore: LocalDateTime, + pageable: Pageable + ): List } diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushOutboxPurgeScheduler.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushOutboxPurgeScheduler.kt new file mode 100644 index 0000000..5d86c7d --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/scheduler/PushOutboxPurgeScheduler.kt @@ -0,0 +1,71 @@ +package site.billilge.api.backend.domain.notification.scheduler + +import io.github.oshai.kotlinlogging.KotlinLogging +import org.springframework.scheduling.annotation.Scheduled +import org.springframework.stereotype.Component +import site.billilge.api.backend.domain.notification.enums.PushDeliveryStatus +import site.billilge.api.backend.domain.notification.service.NotificationPushOutboxService +import java.time.LocalDateTime + +private val log = KotlinLogging.logger {} + +/** + * 보존 기간이 지난 발송 대기열을 정리한다. + * + * 발송이 끝난 건은 폴러가 다시 조회하지 않지만, 알림 한 건마다 수신자 수만큼 쌓이므로 + * 방치하면 재시도 대상 조회가 느려진다. + * + * 재시도 폴러와 같은 스케줄러 스레드를 쓰므로, 한 회 처리량에 상한을 두어 폴러가 밀리지 않게 한다. + */ +@Component +class PushOutboxPurgeScheduler( + private val notificationPushOutboxService: NotificationPushOutboxService, +) { + @Scheduled(cron = "\${notification.push.outbox.purge-cron:0 0 4 * * *}", zone = "Asia/Seoul") + fun purgeExpiredOutbox() { + val now = LocalDateTime.now() + + val sentCount = purge(SENT_STATUSES, now.minusDays(SENT_RETENTION_DAYS)) + val givenUpCount = purge(GIVEN_UP_STATUSES, now.minusDays(GIVEN_UP_RETENTION_DAYS)) + + if (sentCount == 0 && givenUpCount == 0) return + + log.info { "푸시 아웃박스 정리 완료 (발송 완료 ${sentCount}건, 발송 포기 ${givenUpCount}건 삭제)" } + } + + private fun purge(deliveryStatuses: List, createdBefore: LocalDateTime): Int { + var deletedCount = 0 + + repeat(MAX_BATCHES_PER_RUN) { + val deleted = notificationPushOutboxService.deletePurgeTargetBatch( + deliveryStatuses, + createdBefore, + BATCH_SIZE + ) + + deletedCount += deleted + + if (deleted < BATCH_SIZE) return deletedCount + } + + log.warn { + "정리 대상이 한 회 처리량(${MAX_BATCHES_PER_RUN * BATCH_SIZE}건)을 채웠습니다. " + + "남은 건은 다음 주기에 정리됩니다. statuses=$deliveryStatuses" + } + + return deletedCount + } + + companion object { + private val SENT_STATUSES = listOf(PushDeliveryStatus.SENT) + + /** 실패 원인(last_error)을 들여다볼 여지를 남기기 위해 더 오래 보관한다 */ + private val GIVEN_UP_STATUSES = listOf(PushDeliveryStatus.FAILED, PushDeliveryStatus.EXPIRED) + + private const val SENT_RETENTION_DAYS = 7L + private const val GIVEN_UP_RETENTION_DAYS = 30L + + private const val BATCH_SIZE = 500 + private const val MAX_BATCHES_PER_RUN = 20 + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt index 55ac573..ffde208 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/service/NotificationPushOutboxService.kt @@ -90,6 +90,31 @@ class NotificationPushOutboxService( } } + /** + * 보존 기간이 지난 건을 배치 크기만큼 삭제하고 삭제한 수를 반환한다. + * + * 한 번에 다 지우면 락 구간이 길어지므로, 호출부가 반환값을 보고 반복 호출한다. + * 배치마다 트랜잭션이 끊기도록 이 메서드가 트랜잭션 경계를 잡는다. + */ + @Transactional + fun deletePurgeTargetBatch( + deliveryStatuses: Collection, + createdBefore: LocalDateTime, + batchSize: Int, + ): Int { + val targetIds = notificationPushOutboxRepository.findPurgeTargetIds( + deliveryStatuses, + createdBefore, + PageRequest.of(0, batchSize) + ) + + if (targetIds.isEmpty()) return 0 + + notificationPushOutboxRepository.deleteAllByIdInBatch(targetIds) + + return targetIds.size + } + private fun Member.hasFcmToken(): Boolean { if (fcmToken != null) return true From 1f54af04ad3c416f5261dfb753dc991a3144940e Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 20:07:49 +0900 Subject: [PATCH 07/14] =?UTF-8?q?fix:=20=ED=91=B8=EC=8B=9C=20=EC=9C=A0?= =?UTF-8?q?=ED=9A=A8=20=EC=8B=9C=EA=B0=84=EC=9D=84=2010=EB=B6=84=EC=9C=BC?= =?UTF-8?q?=EB=A1=9C=20=EB=8B=A8=EC=B6=95=20(#148)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit TTL 1시간은 이 서비스의 알림 성격에 비해 지나치게 길다. 대여 승인은 사용자가 지금 과방에 갈지 결정하는 정보고, 관리자 알림도 학생이 기다리는 상태에서 처리해야 하는 일이라 늦게 도착하면 의미가 없다. - 유효 시간을 1시간에서 10분으로 단축 - 도달할 수 없게 된 15분 백오프 제거 (30초 → 2분 → 5분, 최대 3회, 누적 7분 30초) - 다음 재시도 시각이 유효 시간을 넘기면 예약하지 않고 즉시 EXPIRED 처리 (기존에는 만료될 것이 뻔한 시도를 예약해 두고 폴러가 집어간 뒤에야 만료를 확인했다) Co-Authored-By: Claude Opus 5 --- CLAUDE.md | 5 +-- .../entity/NotificationPushOutbox.kt | 23 +++++++++--- .../entity/NotificationPushOutboxTest.kt | 36 ++++++++++++++++--- 3 files changed, 53 insertions(+), 11 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 0532a97..949226a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -111,8 +111,9 @@ PENDING ─┬─ 발송 성공 ──────────────→ SE └─ 생성 후 1시간 경과 ─────→ EXPIRED ``` -- **백오프는 `30초 → 2분 → 5분 → 15분`, 최대 4회** — `NotificationPushOutbox`의 상수로 정의 -- **생성 후 1시간이 지나면 포기한다(`EXPIRED`)** — 늦게 도착하는 푸시는 의미가 없다. 인앱 알림은 이미 저장돼 있음 +- **유효 시간(TTL)은 10분** — 사용자 알림은 지금 과방에 갈지를 결정하는 정보고, 관리자 알림도 학생이 기다리는 상태에서 처리해야 하는 일이라 둘 다 실시간성이 중요하다. 지나면 `EXPIRED`로 포기하며, 인앱 알림은 이미 저장돼 있으므로 정보가 사라지는 것은 아니다 +- **백오프는 `30초 → 2분 → 5분`, 최대 3회** — 누적 7분 30초로 유효 시간 안에 들어온다 +- **다음 재시도 시각이 TTL을 넘기면 예약하지 않고 즉시 포기한다** — 어차피 만료될 시도를 기다리지 않는다 - **즉시 발송과 재시도가 같은 경로를 탄다** — 새 row의 `nextRetryAt`은 60초 뒤로 잡혀, 즉시 시도와 폴러가 겹치지 않는다 - **메시지 본문은 저장하지 않는다** — 연결된 `Notification`의 status와 formatValues로 재구성 - 인스턴스를 여러 대로 늘리면 조회에 잠금(`FOR UPDATE SKIP LOCKED`)이나 ShedLock이 필요하다 diff --git a/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt index 257f4c2..ddb79f3 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt @@ -109,7 +109,15 @@ class NotificationPushOutbox( return } - nextRetryAt = now.plusSeconds(BACKOFF_SECONDS[retryCount]) + val nextAttemptAt = now.plusSeconds(BACKOFF_SECONDS[retryCount]) + + // 다음 시도 시각이 이미 유효 시간을 넘긴다면 기다릴 이유가 없다 + if (isExpired(nextAttemptAt)) { + markExpired() + return + } + + nextRetryAt = nextAttemptAt retryCount++ } @@ -122,11 +130,16 @@ class NotificationPushOutbox( /** 즉시 발송 시도와 폴러가 겹치지 않도록 두는 간격 */ private val FIRST_POLL_DELAY: Duration = Duration.ofSeconds(60) - /** 늦게 도착하는 푸시는 의미가 없으므로 1시간까지만 재시도한다 */ - private val TIME_TO_LIVE: Duration = Duration.ofHours(1) + /** + * 늦게 도착하는 푸시는 의미가 없으므로 10분까지만 재시도한다. + * + * 사용자 알림은 지금 과방에 갈지를 결정하는 정보고, 관리자 알림도 학생이 기다리는 + * 상태에서 처리해야 하는 일이라 둘 다 실시간성이 중요하다. + */ + private val TIME_TO_LIVE: Duration = Duration.ofMinutes(10) - /** 재시도 간격(초) — 배열 길이가 곧 최대 재시도 횟수 */ - private val BACKOFF_SECONDS = longArrayOf(30, 120, 300, 900) + /** 재시도 간격(초) — 배열 길이가 곧 최대 재시도 횟수. 누적 7분 30초로 유효 시간 안에 들어온다 */ + private val BACKOFF_SECONDS = longArrayOf(30, 120, 300) private const val MAX_ERROR_LENGTH = 500 } diff --git a/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt b/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt index 51fc4eb..c55f160 100644 --- a/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt +++ b/src/test/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutboxTest.kt @@ -1,6 +1,7 @@ package site.billilge.api.backend.domain.notification.entity import org.junit.jupiter.api.Assertions.assertEquals +import org.junit.jupiter.api.Assertions.assertFalse import org.junit.jupiter.api.Assertions.assertTrue import org.junit.jupiter.api.DisplayName import org.junit.jupiter.api.Test @@ -26,7 +27,7 @@ class NotificationPushOutboxTest { val outbox = createOutbox() val now = LocalDateTime.now() - val expectedBackoffSeconds = listOf(30L, 120L, 300L, 900L) + val expectedBackoffSeconds = listOf(30L, 120L, 300L) expectedBackoffSeconds.forEachIndexed { index, seconds -> outbox.recordRetryableFailure("UNAVAILABLE", now) @@ -37,13 +38,24 @@ class NotificationPushOutboxTest { } } + @Test + @DisplayName("재시도는 모두 유효 시간(10분) 안에서 이뤄진다") + fun `마지막 재시도 시각이 유효 시간을 넘지 않는다`() { + val outbox = createOutbox() + val now = LocalDateTime.now() + + repeat(3) { outbox.recordRetryableFailure("UNAVAILABLE", now) } + + assertFalse(outbox.isExpired(outbox.nextRetryAt)) + } + @Test @DisplayName("재시도 횟수를 모두 쓰면 발송을 포기한다") fun `최대 재시도 횟수를 넘기면 FAILED가 된다`() { val outbox = createOutbox() val now = LocalDateTime.now() - repeat(4) { outbox.recordRetryableFailure("UNAVAILABLE", now) } + repeat(3) { outbox.recordRetryableFailure("UNAVAILABLE", now) } assertEquals(PushDeliveryStatus.PENDING, outbox.deliveryStatus) outbox.recordRetryableFailure("UNAVAILABLE", now) @@ -57,12 +69,28 @@ class NotificationPushOutboxTest { fun `TTL을 넘기면 EXPIRED가 된다`() { val outbox = createOutbox() - outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now().plusHours(2)) + outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now().plusMinutes(11)) assertEquals(PushDeliveryStatus.EXPIRED, outbox.deliveryStatus) assertEquals(0, outbox.retryCount) } + @Test + @DisplayName("다음 시도 시각이 이미 유효 시간을 넘기면 기다리지 않고 바로 포기한다") + fun `유효 시간을 넘길 재시도는 예약하지 않는다`() { + val outbox = createOutbox() + + // 유효 시간 10분을 40초 남긴 시점의 실패 — 다음 간격(30초)은 들어가지만 + outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now().plusMinutes(9).plusSeconds(20)) + assertEquals(PushDeliveryStatus.PENDING, outbox.deliveryStatus) + + // 20초 남은 시점의 실패 — 다음 간격(30초)이면 이미 만료다 + outbox.recordRetryableFailure("UNAVAILABLE", LocalDateTime.now().plusMinutes(9).plusSeconds(40)) + + assertEquals(PushDeliveryStatus.EXPIRED, outbox.deliveryStatus) + assertEquals(1, outbox.retryCount) + } + @Test @DisplayName("발송에 성공하면 직전 실패 기록을 지운다") fun `markSent는 lastError를 비운다`() { @@ -82,7 +110,7 @@ class NotificationPushOutboxTest { outbox.markSent() - assertTrue(!outbox.isPending()) + assertFalse(outbox.isPending()) } private fun createOutbox(): NotificationPushOutbox { From 7c952883ed8f791f7a8f18b97a3fd03d190f5853 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 20:30:48 +0900 Subject: [PATCH 08/14] =?UTF-8?q?fix:=20=EB=82=A9=EB=B6=80=EC=9E=90=20?= =?UTF-8?q?=EB=AA=A9=EB=A1=9D=20=EC=A1=B0=ED=9A=8C=EC=9D=98=20filesort=20?= =?UTF-8?q?=EC=A0=9C=EA=B1=B0=20-=20#142?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #142에서 인덱스를 (enrollment_year DESC, name) 순서로 맞췄지만 정렬 비용은 그대로 남아 있었다. 원인은 두 가지다. 1. ORDER BY가 두 곳에서 지정됨 findAllByNameContaining()의 @Query에 ORDER BY가 하드코딩된 상태에서 PageRequest에도 Sort를 넘기고 있었다. Spring Data는 @Query에 ORDER BY가 있으면 Pageable의 Sort를 지우지 않고 뒤에 이어붙이기 때문에 실제 SQL은 `order by enrollment_year desc, name asc, enrollment_year desc, id asc`가 되고, 정렬 키가 인덱스와 어긋나 매 조회마다 filesort가 발생했다. 덤으로 하드코딩된 키가 항상 앞에 오는 탓에 criteria 파라미터는 무시됐고, 엔티티에 없는 이름을 넣으면 HQL이 깨져 500이 났다. @Query에서 ORDER BY를 걷어내고 정렬 생성을 resolveSort() 한 곳으로 모았다. criteria는 화이트리스트로 받아 알 수 없는 값이면 기본 정렬로 떨어진다. 2. 검색어가 없어도 LIKE '%%'를 태움 SearchCondition.search의 기본값이 ""라 목록 첫 진입에도 술어가 붙었다. 한 건도 걸러내지 못하면서 선행 와일드카드로 인덱스 접근만 막는다. 검색어가 비어 있으면 술어 없이 findAll(pageable)로 보낸다. 응답의 행 순서는 바뀌지 않는다. 기존에도 뒤에 붙던 id asc가 동점 처리 역할을 하고 있어 최종 정렬 결과는 동일하고, 정렬 방법만 filesort에서 인덱스 순서 스캔으로 바뀐다. Co-Authored-By: Claude Opus 5 --- .../payer/repository/PayerRepository.kt | 4 +- .../domain/payer/service/PayerService.kt | 38 +++++++++++++++++-- 2 files changed, 38 insertions(+), 4 deletions(-) diff --git a/src/main/kotlin/site/billilge/api/backend/domain/payer/repository/PayerRepository.kt b/src/main/kotlin/site/billilge/api/backend/domain/payer/repository/PayerRepository.kt index 091cdd8..114cc80 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/payer/repository/PayerRepository.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/payer/repository/PayerRepository.kt @@ -13,7 +13,9 @@ interface PayerRepository : JpaRepository { @Query("select p from Payer p where p.id in :ids") fun findAllByIds(@Param("ids") ids: List): List - @Query("SELECT p FROM Payer p WHERE p.name LIKE CONCAT('%', :name, '%') ORDER BY p.enrollmentYear DESC, p.name") + // 정렬은 Pageable의 Sort에만 맡긴다. 여기에 ORDER BY를 같이 두면 Spring Data가 + // Sort를 지우지 않고 뒤에 이어붙여 정렬 키가 중복된다. (PayerService.resolveSort 참고) + @Query("SELECT p FROM Payer p WHERE p.name LIKE CONCAT('%', :name, '%')") fun findAllByNameContaining(@Param("name") name: String, pageable: Pageable): Page fun findAllByEnrollmentYear(enrollmentYear: String): List diff --git a/src/main/kotlin/site/billilge/api/backend/domain/payer/service/PayerService.kt b/src/main/kotlin/site/billilge/api/backend/domain/payer/service/PayerService.kt index 9e3d767..e475bf4 100644 --- a/src/main/kotlin/site/billilge/api/backend/domain/payer/service/PayerService.kt +++ b/src/main/kotlin/site/billilge/api/backend/domain/payer/service/PayerService.kt @@ -65,10 +65,42 @@ class PayerService( val pageRequest = PageRequest.of( pageableCondition.pageNo, pageableCondition.size, - Sort.by(Sort.Direction.DESC, pageableCondition.criteria ?: "enrollmentYear") - .and(Sort.by(Sort.Direction.ASC, "id")) + resolveSort(pageableCondition.criteria) + ) + val search = searchCondition.search + + // 검색어가 없으면 LIKE '%%'는 한 건도 걸러내지 못하면서 선행 와일드카드 때문에 + // 인덱스 접근만 막는다. 목록 첫 진입이 이 경로이므로 술어 자체를 빼서 + // 정렬 인덱스를 타고 LIMIT에서 끊게 한다. + if (search.isBlank()) { + return payerRepository.findAll(pageRequest) + } + + return payerRepository.findAllByNameContaining(search, pageRequest) + } + + /** + * 납부자 목록의 정렬 기준을 만드는 유일한 지점. + * + * 기본 정렬은 `idx_payer_enrollment_year_name(enrollment_year DESC, name)` 의 순서와 맞춘다. + * InnoDB 보조 인덱스는 뒤에 PK가 붙으므로 `id ASC` 까지 인덱스 순서로 읽을 수 있고, + * 정렬 키가 인덱스와 어긋나면 조건에 걸린 전체 행을 filesort 하게 된다. + * + * criteria는 클라이언트가 넘기는 값이라 화이트리스트로 받는다. 선언형 @Query에는 + * 프로퍼티명이 검증 없이 그대로 붙어서, 없는 이름이 들어오면 쿼리 자체가 깨진다. + */ + private fun resolveSort(criteria: String?): Sort = when (criteria) { + "name" -> Sort.by( + Sort.Order.asc("name"), + Sort.Order.desc("enrollmentYear"), + Sort.Order.asc("id") + ) + + else -> Sort.by( + Sort.Order.desc("enrollmentYear"), + Sort.Order.asc("name"), + Sort.Order.asc("id") ) - return payerRepository.findAllByNameContaining(searchCondition.search, pageRequest) } @Transactional From bbc2c3c6d07f599ea366508c4329085e2ad6c93a Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 20:42:16 +0900 Subject: [PATCH 09/14] =?UTF-8?q?chore:=20dev=20=ED=94=84=EB=A1=9C?= =?UTF-8?q?=ED=8C=8C=EC=9D=BC=EC=9D=98=20SQL=20=EC=BD=98=EC=86=94=20?= =?UTF-8?q?=EC=B6=9C=EB=A0=A5=20=EC=A0=9C=EA=B1=B0=20-=20#151?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit show-sql은 org.hibernate.SQL 로거와 별개로 System.out에 직접 쓴다. 로그 레벨로 끌 수 없고, 비동기 appender로 돌릴 수도 없으며, System.out이 동기화된 스트림이라 요청 스레드들이 출력 락에서 직렬화된다. dev는 부하 테스트 대상 환경이기도 해서 측정에 잡음을 넣는다. format_sql은 BasicFormatterImpl이 쿼리마다 SQL 문자열을 파싱해 들여쓰기를 넣는 비용이고, 출력이 꺼지면 수행되지 않으므로 show-sql과 함께 끈다. 대신 logging.level에 org.hibernate.SQL과 org.hibernate.orm.jdbc.bind를 남겨, SQL을 봐야 할 때 레벨만 올리면 되도록 했다. 이쪽은 Logback을 타므로 레벨과 appender 제어가 정상적으로 된다. application-local.yml은 그대로 둔다. 개발자 개인 머신이라 SQL이 바로 보이는 편이 유용하고 출력 경합이 문제가 되지 않는다. Co-Authored-By: Claude Opus 5 --- src/main/resources/application-dev.yml | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/src/main/resources/application-dev.yml b/src/main/resources/application-dev.yml index 9d8408b..eb2e6b1 100644 --- a/src/main/resources/application-dev.yml +++ b/src/main/resources/application-dev.yml @@ -32,10 +32,14 @@ spring: jpa: properties: hibernate: - format_sql: true + # show-sql 과 함께만 의미가 있고, 켜면 쿼리마다 포매팅 비용이 붙는다 + format_sql: false dialect: org.hibernate.dialect.MySQLDialect dialect.storage_engine: innodb - show-sql: true + # show-sql 은 로거를 거치지 않고 System.out 에 직접 쓴다. + # 레벨로 끌 수도, 비동기 appender 로 돌릴 수도 없고 요청 스레드들이 출력 락에서 직렬화된다. + # SQL 을 봐야 할 때는 아래 logging.level 을 debug 로 올린다 (로거 경로라 제어가 된다). + show-sql: false hibernate: ddl-auto: update @@ -46,6 +50,12 @@ spring: resolve-lazily: true +logging: + level: + org.hibernate.SQL: info # debug 로 올리면 실행 SQL 출력 + org.hibernate.orm.jdbc.bind: info # trace 로 올리면 바인딩 파라미터까지 출력 + + server: tomcat: threads: From 21fbb3a6c006f079ead08225004a5d77533afbdf Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 17 Aug 2026 21:16:02 +0900 Subject: [PATCH 10/14] =?UTF-8?q?chore:=20=EB=A1=9C=EA=B7=B8=20=EC=B6=9C?= =?UTF-8?q?=EB=A0=A5=EC=9D=84=20=EB=B9=84=EB=8F=99=EA=B8=B0=20appender=20?= =?UTF-8?q?=EB=A1=9C=20=EB=B6=84=EB=A6=AC=20-=20#153?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Logback의 ConsoleAppender는 OutputStreamAppender를 상속하고 write가 동기화돼 있다. 톰캣 스레드 100개가 한 스트림에 쓰면 그 락에서 직렬화되고, 로그 한 줄의 비용이 그대로 응답시간에 실린다. #151에서 dev의 SQL 콘솔 출력을 끄자 납부자 목록 조회 p95가 452ms에서 240ms로 줄었다. 출력량을 줄여 절반을 회수했지만 구조는 그대로였다. LoggingFilter가 요청마다 남기는 한 줄이 여전히 같은 경로로 나간다. 출력을 더 줄이는 대신 요청 스레드에서 I/O를 떼어낸다. AsyncAppender 기본값 두 개는 의도와 맞지 않아 명시적으로 바꿨다. - discardingThreshold: 기본값 20은 큐가 80% 차면 INFO 이하를 조용히 버린다. LoggingFilter의 요청 로그가 INFO라 부하 상황에서 소리 없이 사라진다. 0으로 두어 레벨과 무관하게 큐에 자리가 있는 한 남긴다. - neverBlock: 기본값 false는 큐가 가득 차면 요청 스레드를 블로킹한다. 비동기로 만든 이유가 사라지므로 true로 둔다. 응답시간을 지키는 게 목적이라 로그 유실보다 블로킹을 더 나쁘게 봤다. 커스텀 설정 파일이 있으면 Spring Boot 기본 로깅 설정이 통째로 대체되므로, 로그 포맷과 CONSOLE appender 정의는 defaults.xml과 console-appender.xml을 include해 그대로 쓴다. 목적지는 콘솔 그대로 두었다. CapRover가 stdout을 수집하는 구조라 파일 appender는 필요하지 않다. Co-Authored-By: Claude Opus 5 --- src/main/resources/logback-spring.xml | 42 +++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 src/main/resources/logback-spring.xml diff --git a/src/main/resources/logback-spring.xml b/src/main/resources/logback-spring.xml new file mode 100644 index 0000000..284ec42 --- /dev/null +++ b/src/main/resources/logback-spring.xml @@ -0,0 +1,42 @@ + + + + + + + + + + + + true + + + 0 + + + 4096 + + + false + + + + + + From aec699ea6bf221e40f9abc4b58ea12e4e43f8751 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Mon, 21 Sep 2026 17:48:55 +0900 Subject: [PATCH 11/14] =?UTF-8?q?deploy:=20CD=20=EB=B0=B0=ED=8F=AC?= =?UTF-8?q?=EB=A5=BC=20CapRover=EC=97=90=EC=84=9C=20Coolify=EB=A1=9C=20?= =?UTF-8?q?=EB=A7=88=EC=9D=B4=EA=B7=B8=EB=A0=88=EC=9D=B4=EC=85=98=20-=20#1?= =?UTF-8?q?55?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - build-docker-image 잡(Docker Hub, latest 태그)은 그대로 유지 - deploy 잡의 CapRover 액션을 Coolify API(GET /api/v1/deploy?uuid=...&force=true) 호출로 교체 - prod/dev 각각 COOLIFY_PROD_RESOURCE_UUID / COOLIFY_DEV_RESOURCE_UUID 사용 Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01BwEtkafDnUZh8TeKrrzuEo --- .github/workflows/ci-cd_dev.yml | 12 +++++------- .github/workflows/ci-cd_prod.yml | 12 +++++------- 2 files changed, 10 insertions(+), 14 deletions(-) diff --git a/.github/workflows/ci-cd_dev.yml b/.github/workflows/ci-cd_dev.yml index c7b1cc3..89cf968 100644 --- a/.github/workflows/ci-cd_dev.yml +++ b/.github/workflows/ci-cd_dev.yml @@ -60,10 +60,8 @@ jobs: if: github.event_name == 'push' runs-on: ubuntu-latest steps: - - name: Deploy to CapRover - uses: caprover/deploy-from-github@v1.1.2 - with: - server: ${{ secrets.CAPROVER_SERVER }} - app: ${{ secrets.CAPROVER_DEV_APP_NAME }} - token: ${{ secrets.CAPROVER_DEV_APP_TOKEN }} - image: ${{ env.DOCKER_IMAGE }}:latest + - name: Trigger Coolify deploy + run: | + curl --fail --show-error --silent --request GET \ + "${{ secrets.COOLIFY_URL }}/api/v1/deploy?uuid=${{ secrets.COOLIFY_DEV_RESOURCE_UUID }}&force=true" \ + --header "Authorization: Bearer ${{ secrets.COOLIFY_API_TOKEN }}" diff --git a/.github/workflows/ci-cd_prod.yml b/.github/workflows/ci-cd_prod.yml index c0b2e27..e04cd81 100644 --- a/.github/workflows/ci-cd_prod.yml +++ b/.github/workflows/ci-cd_prod.yml @@ -59,10 +59,8 @@ jobs: if: github.event_name == 'push' runs-on: ubuntu-latest steps: - - name: Deploy to CapRover - uses: caprover/deploy-from-github@v1.1.2 - with: - server: ${{ secrets.CAPROVER_SERVER }} - app: ${{ secrets.CAPROVER_PROD_APP_NAME }} - token: ${{ secrets.CAPROVER_PROD_APP_TOKEN }} - image: ${{ env.DOCKER_IMAGE }}:latest + - name: Trigger Coolify deploy + run: | + curl --fail --show-error --silent --request GET \ + "${{ secrets.COOLIFY_URL }}/api/v1/deploy?uuid=${{ secrets.COOLIFY_PROD_RESOURCE_UUID }}&force=true" \ + --header "Authorization: Bearer ${{ secrets.COOLIFY_API_TOKEN }}" From 9b783447b1960be4b1c13ba5093fa0db30721ee7 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Thu, 15 Oct 2026 16:49:11 +0900 Subject: [PATCH 12/14] =?UTF-8?q?docs:=20README=20=EC=9E=91=EC=84=B1=20?= =?UTF-8?q?=EB=B0=8F=20=EB=8B=A4=EC=9D=B4=EC=96=B4=EA=B7=B8=EB=9E=A8=20?= =?UTF-8?q?=EC=9D=B4=EB=AF=B8=EC=A7=80=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 242 ++++++++++++++++++++++++++ images/push-notification-sequence.png | Bin 0 -> 148030 bytes images/rental-status-flow.png | Bin 0 -> 90861 bytes 3 files changed, 242 insertions(+) create mode 100644 README.md create mode 100644 images/push-notification-sequence.png create mode 100644 images/rental-status-flow.png diff --git a/README.md b/README.md new file mode 100644 index 0000000..2527daa --- /dev/null +++ b/README.md @@ -0,0 +1,242 @@ +# 빌릴게 (Billilge) — 국민대학교 소프트웨어융합대학 복지물품 대여 서비스 + +> 학생회실 방문·엑셀 대조에 의존하던 복지물품 대여를 **온라인 신청, 납부자 검증, 재고·대여 상태 관리, 관리자 알림**으로 연결한 서비스입니다. +> +> **이 저장소는 빌릴게 백엔드**를 다룹니다. 개발 후 실제 학생회 운영 과정에서 발생한 정책·안정성·성능 문제를 지속적으로 개선하고 있습니다. + +## 1. 프로젝트 소개 + +국민대학교 소프트웨어융합대학 학생회는 우산, 충전기 등 학생들이 잠시 필요로 하는 물품을 대여합니다. 하지만 기존 운영 방식에서는 학생이 물품 현황을 확인하거나 신청하려면 학생회실을 방문해야 했고, 운영진은 학생회비 납부 여부와 재고·대여 기록을 엑셀 및 수작업으로 관리해야 했습니다. + +빌릴게는 이러한 과정을 시스템으로 옮겨 **학생은 방문 전에 대여를 신청하고, 운영진은 승인·대여·반납 업무에 집중**할 수 있도록 만들었습니다. 단순 신청 폼에서 끝내지 않고, 학생회 정책과 실제 운영 흐름을 서버의 비즈니스 규칙으로 구현했습니다. + +### 해결하고자 한 문제 + + +| 기존 문제 | 빌릴게의 해결 방향 | +| ---------------------------- | ----------------------- | +| 방문해야만 확인할 수 있는 물품·재고 | 물품 목록 및 재고 현황 온라인 제공 | +| 운영진이 엑셀에서 직접 확인하던 회비 납부 여부 | 가입·납부자 명단 연동을 통한 자격 확인 | +| 신청·승인·수령·반납 상태를 사람마다 다르게 기록 | 대여 상태와 처리 이력의 일원화 | +| 근무자가 현장에 상주하거나 반복 안내해야 하는 부담 | 사전 신청, 관리자 대시보드 및 알림 제공 | +| 학기별 정책 변경에 따른 반복적인 코드 수정 | 시험 기간 등 운영 설정의 데이터화 | + + +### 운영 성과 + + +| 지표 | 결과 | +| ----------------- | ------------------------------------------------------- | +| 연간 대여 이용 | **101건 → 178건** (**약 76% 증가**, 도입 첫해 전후 비교) | +| 누적 대여 이용 | **627건** (서비스 운영 집계 기준) | +| 관리자 알림 모델 | 동일 공지를 관리자 수만큼 저장하던 방식에서 **공지 1건 저장**으로 변경 | +| 납부자 목록 조회 API p95 | 약 47% 감소 (스테이징 환경에서 SQL 콘솔 로깅 제거 전후) | + + +> 이용 건수는 학생회 운영 집계에 기반한 지표입니다. API 지연 수치는 **가상 사용자 100명 · 5분 · 납부자 약 2,000건** 조건에서 측정한 특정 API(`GET /admin/members/payers`) 결과로, 서비스 전체 응답 속도를 의미하지 않습니다. 비동기 로깅 도입의 추가 개선량은 별도 측정이 필요합니다. [관련 PR #152](https://github.com/billilge/backend/pull/152) + +## 2. 주요 기능 + +### 학생 + +- Google OAuth2 로그인 및 JWT 기반 인증 +- 복지물품 목록·재고 조회, 대여 신청 및 신청 취소 +- 대여 진행 상태 및 이력 조회, 반납 신청 +- 신청·승인·반려·반납 관련 인앱 알림 및 FCM 푸시 + +### 운영진 + +- 신청 승인·반려, 대여·반납 상태 관리 및 처리자 기록 +- 물품 등록·수정·재고 관리, 관리자 대시보드 +- 학생회비 납부자 명단 관리와 엑셀 다운로드 +- 관리자 권한 구분(`ADMIN`, `WORKER`, `GA`) 및 관리 기능 접근 통제 +- 시험 기간 등 운영 정책 설정, 디스플레이 일정·포스터 관리 + +## 3. 서비스 정책과 도메인 설계 + +### 3.1 학생회비 납부자 검증: 불완전한 원천 데이터와 오인증 위험 + +**문제** — 운영 명단은 학번의 일부가 마스킹되거나 누락될 수 있고, 이름만으로 검증하면 동명이인에게 잘못 대여 자격을 부여할 수 있습니다. 회원가입 흐름에 엑셀의 불완전한 데이터 모델을 그대로 옮길 수 없었습니다. + +**설계** — 납부자(`Payer`)와 서비스 회원(`Member`)을 분리하고, 회원가입 시 이름·입학연도로 납부자 후보를 조회한 다음 후보 수와 학번 일치 여부를 검토합니다. 이름 하나만으로 납부자를 확정하지 않으며, 납부자 명단의 등록·삭제에 따라 회원의 `isFeePaid`도 갱신합니다. 이름과 입학연도 조회, 전체 학번 비교, 마스킹 값(`XXXX`) 처리 분기를 별도로 둔 것이 특징입니다. + +**의사결정** — 인증 정보와 회비 납부 기록은 출처·갱신 주기가 다르므로 하나의 회원 엔티티로 합치지 않았습니다. 다만 현재 코드는 모든 부분 누락 사례를 일반화해 해결하는 정교한 신원확인 시스템이 아니며, 명단 형식과 매칭 예외 케이스에 대한 추가 검증이 필요합니다. + +- 구현: [`PayerService.isPayer()`](https://github.com/billilge/backend/blob/develop/src/main/kotlin/site/billilge/api/backend/domain/payer/service/PayerService.kt) + +### 3.2 대여 정책을 서버에서 검증 + +대여 신청은 화면의 버튼 표시 여부에 의존하지 않고 **서버에서 자격·재고·시간 규칙을 확인**합니다. + + +| 정책 | 현재 동작 | +| ------ | -------------------------------------------------- | +| 이용 자격 | 학생회비 납부자로 등록된 회원만 신청 가능 | +| 수량 | 신청 수량이 가용 재고를 초과하면 거절 | +| 중복 대여 | 동일 회원의 동일 물품 대여 중복 검증 (`ignoreDuplicate` 예외 경로 존재) | +| 운영 시간 | 주말·지난 시각·설정된 시간 범위 외 신청 제한 (기본 로직 10\~17시) | +| 시험 기간 | DB에 등록한 시작·종료일 동안 대여 신청 제한 | +| 관리자 등록 | 관리자 수기 등록은 일반 학생 신청과 별도의 처리 흐름 제공 | +| 소모품 | 반환 재고 복원을 하지 않고 지급 완료 상태로 처리 | + + +시험 기간의 시작·종료일은 `ConfigValue`에 저장해 운영진이 변경할 수 있도록 했습니다. **정책을 소스코드 상수에서 운영 데이터로 분리**한 사례입니다. + +> 현재 구현의 대여 시간 검사는 `hour > 17`만 거절하므로 **17시대 시각을 허용**합니다. 운영 정책을 ‘17:00까지’로 정의하려면 분 단위 경계까지 추가 확인해야 합니다. + +- 구현: [`RentalService`](https://github.com/billilge/backend/blob/develop/src/main/kotlin/site/billilge/api/backend/domain/rental/service/RentalService.kt), [`ConfigValueService`](https://github.com/billilge/backend/blob/develop/src/main/kotlin/site/billilge/api/backend/domain/configvalue/service/ConfigValueService.kt) + +### 3.3 대여 상태 관리 + +![대여 상태 흐름](images/rental-status-flow.png) + +- **승인 시 재고 차감**, **반납 완료 시 재고 복원**(소모품은 제외) +- 관리자 처리자(`worker`)와 상태별 로그(`RentalStatusWorkerLog`) 저장 +- 소모품은 대여 중 상태 대신 최종 완료 상태로 전환하는 별도 규칙 적용 + +> 다이어그램은 정상 흐름을 이해하기 위한 대표 경로입니다. 실제 코드는 상태 변경 API로 처리하며, 모든 상태 간 전이를 전용 상태 머신이 강제하는 것은 아닙니다. + +## 4. 기술적 문제 해결 + +### 4.1 관리자 알림의 데이터 모델 재정의 + +**문제** — 관리자가 약 40명인 환경에서 동일한 대여 공지를 관리자별로 저장하면 **하나의 사건으로부터 여러 개의 동일한 알림 레코드**가 생성됩니다. 또한 푸시를 대여 요청 흐름에서 동기 발송하면 FCM 호출 시간이 응답 지연으로 이어집니다. + +**해결** — 관리자 알림은 개인에게 귀속된 메시지가 아니라 운영진 모두가 보는 **공통 공지**라는 점에 착안했습니다. + +- `Notification.member = null`인 관리자 공지 레코드를 **1건만 저장** +- 푸시 전송은 별도의 수신자 목록과 발송 Outbox로 관리 +- 대여 트랜잭션 커밋 후 `@TransactionalEventListener(AFTER_COMMIT)` + `@Async`로 후속 알림 작업 실행 + +**효과** — 동일 공지의 중복 저장을 제거하고 대여 비즈니스 트랜잭션과 알림 후속 처리를 분리했습니다. [관련 PR #93](https://github.com/billilge/backend/pull/93), [#116](https://github.com/billilge/backend/pull/116) + +### 4.2 FCM 실패에 대비한 Outbox 기반 재시도 + +**문제** — 단순 비동기화만으로는 FCM 일시 장애·네트워크 오류 발생 시 푸시가 조용히 누락될 수 있습니다. 이전 구현에서는 외부 호출이 알림 저장 트랜잭션 안에 있어 DB 커넥션 점유가 길어지고, 예외가 저장된 인앱 알림까지 롤백시킬 가능성도 있었습니다. + +**해결** — 알림 저장, 발송 대상 기록, 외부 네트워크 호출의 책임과 트랜잭션 경계를 분리했습니다. + +![푸시 알림 발송 시퀀스](images/push-notification-sequence.png) + + +| 설계 요소 | 결정과 이유 | +| ------ | --------------------------------------------------------- | +| 저장 원자성 | **Notification + 수신자별 Outbox**를 같은 트랜잭션에서 저장 | +| 외부 API | FCM 호출을 DB 트랜잭션 밖에서 수행해 커넥션 장기 점유 및 알림 롤백 방지 | +| 실패 분류 | `Success` / `InvalidToken` / `Retryable` / `Permanent` 구분 | +| 재시도 | 30초 → 2분 → 5분 백오프, 최대 3회 재시도 | +| 유효 시간 | **10분 TTL** 이후 `EXPIRED` 처리: 늦은 푸시보다 인앱 알림 확인을 우선 | +| 보관 | 전송 완료 7일, 실패·만료 30일 후 배치 정리 | +| 작업 실행 | 전용 스레드 풀(코어 4, 최대 8, 큐 500)과 종료 대기 설정 | + + +**트레이드오프** — 10분을 넘긴 푸시는 이미 지나간 대여 안내를 뒤늦게 전달할 수 있어 의도적으로 포기합니다. 인앱 알림은 남겨 둡니다. 또한 **대여 커밋 이후의 인메모리 이벤트 처리까지 Outbox로 원자화한 것은 아니므로**, 커밋 직후 프로세스가 종료되는 경우 알림 생성 자체가 누락될 가능성은 남아 있습니다. 다중 인스턴스에서 재시도 스케줄러가 동시에 실행되는 문제도 추가적인 잠금 설계가 필요합니다. + +- 구현: [`NotificationEventHandler`](https://github.com/billilge/backend/blob/develop/src/main/kotlin/site/billilge/api/backend/domain/notification/handler/NotificationEventHandler.kt), [`NotificationPushOutbox`](https://github.com/billilge/backend/blob/develop/src/main/kotlin/site/billilge/api/backend/domain/notification/entity/NotificationPushOutbox.kt) +- 설계 변경: [PR #145](https://github.com/billilge/backend/pull/145), [TTL 조정 PR #149](https://github.com/billilge/backend/pull/149) + +## 5. 아키텍처 및 기술 스택 + +### 백엔드 구조 + +```text +Controller ── HTTP 요청·응답, 인증 정보 추출 + ↓ +Facade ── DTO 변환, 여러 도메인 Service 조합 + ↓ +Service ── 도메인 규칙, 트랜잭션 경계 + ↓ +Repository ── Spring Data JPA, QueryDSL 기반 데이터 접근 +``` + +주요 도메인은 `member`, `payer`, `item`, `rental`, `notification`, `configvalue`, `display`로 나누었습니다. **Service에서 타 도메인 Repository를 직접 호출하지 않고 Facade에서 조합**하는 것을 기본 규칙으로 삼았습니다(일부 예외 존재). + +### 기술 스택 (현재 `develop` 브랜치 기준) + + +| 영역 | 기술 | +| ------------------ | ------------------------------------------------------------------ | +| Language / Runtime | **Kotlin 1.9.25, JDK 21** | +| Framework | **Spring Boot 3.4.1**, Spring MVC | +| Persistence | **Spring Data JPA, Hibernate, QueryDSL 5.0** | +| Database | **MySQL**, HikariCP / 테스트용 H2 | +| Security | Spring Security, Google OAuth2, JWT | +| Messaging | Firebase Cloud Messaging, Spring Application Event, `@Async`, 스케줄러 | +| File Storage | **MinIO** (기존 AWS S3에서 이전) | +| Documentation | Springdoc OpenAPI / Swagger UI | +| Build & Deploy | Gradle Kotlin DSL, Docker, Docker Hub, GitHub Actions, Coolify | +| Logging | Kotlin Logging, Logback AsyncAppender | + + +### 배포 흐름 + +```text +GitHub push (develop / main) + → GitHub Actions: Gradle 빌드 + → Docker 이미지 빌드·Docker Hub push + → Coolify API 배포 트리거 + → 개발 / 운영 서버 배포 +``` + +기존 CapRover에서 **Coolify**로 배포 트리거를 전환했고, 파일 저장소는 **S3 → MinIO**로 이전했습니다. 배포 파이프라인은 현재 `latest` 태그를 사용하므로, 추적·롤백 편의성을 높이기 위한 불변 이미지 태그 도입은 후속 개선 과제입니다. [PR #156](https://github.com/billilge/backend/pull/156), [PR #113](https://github.com/billilge/backend/pull/113) + +## 6. 실행 방법 + +**요구 환경:** JDK 21, MySQL, MinIO, Google OAuth2 및 Firebase 자격증명. + +```bash +# 프로젝트 클론 +git clone https://github.com/billilge/backend.git +cd backend + +# 빌드 (CI와 동일하게 테스트 실행 제외) +./gradlew clean build -x test + +# 개발 프로파일 실행 (사전 환경변수·외부 서비스 설정 필요) +profile=dev ./gradlew bootRun +``` + +주요 환경변수는 `DB_URL`, `DB_USERNAME`, `DB_PASSWORD`, `JWT_SECRET_KEY`, `JWT_ISSUER`, `OAUTH2_GOOGLE_CLIENT_ID`, `OAUTH2_GOOGLE_CLIENT_SECRET`, `MINIO_ENDPOINT`, `MINIO_ACCESS_KEY`, `MINIO_SECRET_KEY`, `MINIO_BUCKET`, `MINIO_BASE_URL`, `CORS_ALLOWED_ORIGINS`, `SWAGGER_SERVER_BASE_URL`, `LOGIN_REDIRECT_URL`입니다. Firebase 서비스 계정 설정도 필요합니다. 실제 값은 저장소에 커밋하지 않습니다. + +- API 명세: 앱 실행 후 `/swagger` (Swagger UI), `/api-docs` (OpenAPI JSON) +- 자세한 프로파일 설정: [`application-dev.yml`](https://github.com/billilge/backend/blob/develop/src/main/resources/application-dev.yml) + +## 7. 개발자 + + + + + + +
+ + 황수민 프로필
+ 황수민 +

+ Backend · Infra +
+ + 이정욱 프로필
+ 이정욱 +

+ Backend +
+ +### 황수민 — 백엔드 · 인프라 + +- **기반 설계** — 프로젝트 초기 세팅, JPA 엔티티 설계, Controller–Facade–Service 계층 구조와 QueryDSL 기반 조회 도입 +- **인증·회원** — Google OAuth2 로그인, JWT 인증, 회원가입 시 학생회비 납부자 판별 (3.1) +- **운영진 기능** — 물품·회원·관리자 관리, 관리자 역할 분리(`ADMIN`, `WORKER`, `GA`), 대시보드, 대여 상태 변경과 처리자 기록, 납부자 명단 관리·엑셀 다운로드 +- **대여 정책** — 승인 시 재고 차감, 소모품 처리, 주말·시험 기간 제한, 운영 설정(`ConfigValue`) DB화 (3.2, 3.3) +- **알림** — FCM 푸시 구축, 관리자 공지형 알림 재설계, 이벤트 기반 발행 전환, Outbox 기반 재시도 (4.1, 4.2) +- **인프라·성능** — Docker·GitHub Actions 배포, CapRover → Coolify 전환, S3 → MinIO 이전, 납부자 조회 지연 진단과 로깅 개선 +- **디스플레이** — 디스플레이용 포스터·일정 API + +### 이정욱 — 백엔드 + +- **사용자 대여** — 대여 신청 API(중복 대여 검증, 한국 시간 기준 대여 시간 검증), 대여 이력 조회, 신청 취소, 반납 신청, 반납 필요 물품 조회 +- **사용자 알림** — 알림 목록 조회, 개별 알림 읽음 처리, 알림 타입 정의 +- **물품** — 물품 검색 조회 API +- **문서화** — Swagger API 명세 작성 + +> 프론트엔드는 [billilge/frontend](https://github.com/billilge/frontend), 관리자 웹은 [billilge/admin](https://github.com/billilge/admin) 저장소에서 확인할 수 있습니다. \ No newline at end of file diff --git a/images/push-notification-sequence.png b/images/push-notification-sequence.png new file mode 100644 index 0000000000000000000000000000000000000000..aa737d5ce5b0e1ebc18519304dd45f407cb54a80 GIT binary patch literal 148030 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

4TB;z| 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 Jw%&g7e*o%pcR2t6 literal 0 HcmV?d00001 diff --git a/images/rental-status-flow.png b/images/rental-status-flow.png new file mode 100644 index 0000000000000000000000000000000000000000..aa688feb851a6314780dbecff83d2ca29f61c674 GIT binary patch literal 90861 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%0Dkv1vV;hyq0SC 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 Date: Thu, 15 Oct 2026 17:00:38 +0900 Subject: [PATCH 13/14] =?UTF-8?q?docs:=20README=20=EB=88=84=EC=A0=81=20?= =?UTF-8?q?=EB=8C=80=EC=97=AC=20=EC=9D=B4=EC=9A=A9=20=EA=B1=B4=EC=88=98=20?= =?UTF-8?q?=EA=B0=B1=EC=8B=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2527daa..2a54f9b 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ | 지표 | 결과 | | ----------------- | ------------------------------------------------------- | | 연간 대여 이용 | **101건 → 178건** (**약 76% 증가**, 도입 첫해 전후 비교) | -| 누적 대여 이용 | **627건** (서비스 운영 집계 기준) | +| 누적 대여 이용 | **668건** (2026년 10월 15일 기준, 서비스 운영 집계) | | 관리자 알림 모델 | 동일 공지를 관리자 수만큼 저장하던 방식에서 **공지 1건 저장**으로 변경 | | 납부자 목록 조회 API p95 | 약 47% 감소 (스테이징 환경에서 SQL 콘솔 로깅 제거 전후) | From 4d5146df0e19ff1292341532ee2265ad371be8f2 Mon Sep 17 00:00:00 2001 From: Sumin Hwang <163857590+tnals0924@users.noreply.github.com> Date: Wed, 11 Nov 2026 16:08:59 +0900 Subject: [PATCH 14/14] =?UTF-8?q?refactor:=20=ED=8C=8C=EC=9D=BC=20?= =?UTF-8?q?=EC=A0=80=EC=9E=A5=EC=86=8C=EB=A5=BC=20MinIO=EC=97=90=EC=84=9C?= =?UTF-8?q?=20Cloudflare=20R2=EB=A1=9C=20=EA=B5=90=EC=B2=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - MinIO SDK를 AWS SDK v2(S3 호환)로 교체하고 R2Config/R2Service 구현 - R2 공개 URL은 버킷에 직접 연결되므로 이미지 URL에서 버킷명 제거 - R2 비호환 기본 체크섬 계산을 WHEN_REQUIRED로 제한 - 설정 키를 minio.* 에서 r2.* 로 변경 (R2_ENDPOINT, R2_ACCESS_KEY, R2_SECRET_KEY, R2_BUCKET, R2_PUBLIC_URL) Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 6 +- README.md | 6 +- build.gradle.kts | 2 +- .../global/external/minio/MinioConfig.kt | 27 ------ .../global/external/minio/MinioService.kt | 73 ---------------- .../backend/global/external/r2/R2Config.kt | 40 +++++++++ .../backend/global/external/r2/R2Service.kt | 83 +++++++++++++++++++ src/main/resources/application-dev.yml | 12 +-- src/main/resources/application-prod.yml | 12 +-- 9 files changed, 142 insertions(+), 119 deletions(-) delete mode 100644 src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioConfig.kt delete mode 100644 src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioService.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Config.kt create mode 100644 src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Service.kt diff --git a/CLAUDE.md b/CLAUDE.md index 949226a..257d148 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ - **JPA + QueryDSL** (MySQL) - **Spring Security** (JWT + Google OAuth2) - **Firebase Cloud Messaging** (푸시 알림) -- **AWS S3** (이미지 업로드) +- **Cloudflare R2** (이미지 업로드, AWS SDK v2 S3 호환 API) - **Apache POI** (Excel 생성) ## 빌드 & 실행 @@ -72,7 +72,7 @@ domain/{name}/ ## 서비스 의존성 ``` -ItemService → ItemRepository, S3Service +ItemService → ItemRepository, FileStorageService(R2Service) MemberService → MemberRepository, TokenProvider, PayerService NotificationService → NotificationRepository, NotificationPushOutboxService NotificationPushOutboxService → NotificationPushOutboxRepository @@ -223,7 +223,7 @@ global/ ├── exception/ # ApiException, ErrorCode, GlobalExceptionHandler ├── external/ │ ├── fcm/ # FCMConfig, FCMService -│ └── s3/ # S3Config, S3Service +│ └── r2/ # R2Config, R2Service (FileStorageService 구현체) ├── logging/ # LoggingFilter ├── security/ │ ├── jwt/ # TokenProvider, TokenAuthenticationFilter diff --git a/README.md b/README.md index 2a54f9b..5b985e0 100644 --- a/README.md +++ b/README.md @@ -162,7 +162,7 @@ Repository ── Spring Data JPA, QueryDSL 기반 데이터 접근 | Database | **MySQL**, HikariCP / 테스트용 H2 | | Security | Spring Security, Google OAuth2, JWT | | Messaging | Firebase Cloud Messaging, Spring Application Event, `@Async`, 스케줄러 | -| File Storage | **MinIO** (기존 AWS S3에서 이전) | +| File Storage | **Cloudflare R2** (AWS S3 → MinIO → R2 이전) | | Documentation | Springdoc OpenAPI / Swagger UI | | Build & Deploy | Gradle Kotlin DSL, Docker, Docker Hub, GitHub Actions, Coolify | | Logging | Kotlin Logging, Logback AsyncAppender | @@ -182,7 +182,7 @@ GitHub push (develop / main) ## 6. 실행 방법 -**요구 환경:** JDK 21, MySQL, MinIO, Google OAuth2 및 Firebase 자격증명. +**요구 환경:** JDK 21, MySQL, Cloudflare R2, Google OAuth2 및 Firebase 자격증명. ```bash # 프로젝트 클론 @@ -196,7 +196,7 @@ cd backend profile=dev ./gradlew bootRun ``` -주요 환경변수는 `DB_URL`, `DB_USERNAME`, `DB_PASSWORD`, `JWT_SECRET_KEY`, `JWT_ISSUER`, `OAUTH2_GOOGLE_CLIENT_ID`, `OAUTH2_GOOGLE_CLIENT_SECRET`, `MINIO_ENDPOINT`, `MINIO_ACCESS_KEY`, `MINIO_SECRET_KEY`, `MINIO_BUCKET`, `MINIO_BASE_URL`, `CORS_ALLOWED_ORIGINS`, `SWAGGER_SERVER_BASE_URL`, `LOGIN_REDIRECT_URL`입니다. Firebase 서비스 계정 설정도 필요합니다. 실제 값은 저장소에 커밋하지 않습니다. +주요 환경변수는 `DB_URL`, `DB_USERNAME`, `DB_PASSWORD`, `JWT_SECRET_KEY`, `JWT_ISSUER`, `OAUTH2_GOOGLE_CLIENT_ID`, `OAUTH2_GOOGLE_CLIENT_SECRET`, `R2_ENDPOINT`, `R2_ACCESS_KEY`, `R2_SECRET_KEY`, `R2_BUCKET`, `R2_PUBLIC_URL`, `CORS_ALLOWED_ORIGINS`, `SWAGGER_SERVER_BASE_URL`, `LOGIN_REDIRECT_URL`입니다. Firebase 서비스 계정 설정도 필요합니다. 실제 값은 저장소에 커밋하지 않습니다. - API 명세: 앱 실행 후 `/swagger` (Swagger UI), `/api-docs` (OpenAPI JSON) - 자세한 프로파일 설정: [`application-dev.yml`](https://github.com/billilge/backend/blob/develop/src/main/resources/application-dev.yml) diff --git a/build.gradle.kts b/build.gradle.kts index b60b484..4b8b3dd 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -47,7 +47,7 @@ dependencies { implementation("org.thymeleaf.extras:thymeleaf-extras-springsecurity6") - implementation("io.minio:minio:8.5.7") + implementation("software.amazon.awssdk:s3:2.54.15") implementation("javax.xml.bind:jaxb-api:2.3.1") implementation("org.apache.tika:tika-core:2.9.2") implementation("org.apache.tika:tika-parsers-standard-package:2.9.2") diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioConfig.kt b/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioConfig.kt deleted file mode 100644 index c18ce8f..0000000 --- a/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioConfig.kt +++ /dev/null @@ -1,27 +0,0 @@ -package site.billilge.api.backend.global.external.minio - -import io.minio.MinioClient -import org.springframework.beans.factory.annotation.Value -import org.springframework.context.annotation.Bean -import org.springframework.context.annotation.Configuration - -@Configuration -class MinioConfig( - @Value("\${minio.endpoint}") - private val endpoint: String, - - @Value("\${minio.access-key}") - private val accessKey: String, - - @Value("\${minio.secret-key}") - private val secretKey: String, -) { - - @Bean - fun minioClient(): MinioClient { - return MinioClient.builder() - .endpoint(endpoint) - .credentials(accessKey, secretKey) - .build() - } -} diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioService.kt b/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioService.kt deleted file mode 100644 index c8f2bd4..0000000 --- a/src/main/kotlin/site/billilge/api/backend/global/external/minio/MinioService.kt +++ /dev/null @@ -1,73 +0,0 @@ -package site.billilge.api.backend.global.external.minio - -import io.minio.MinioClient -import io.minio.PutObjectArgs -import io.minio.RemoveObjectArgs -import io.minio.StatObjectArgs -import io.minio.errors.ErrorResponseException -import org.springframework.beans.factory.annotation.Value -import org.springframework.stereotype.Service -import org.springframework.web.multipart.MultipartFile -import site.billilge.api.backend.global.exception.ApiException -import site.billilge.api.backend.global.exception.GlobalErrorCode -import site.billilge.api.backend.global.external.FileStorageService -import java.io.IOException -import java.util.* - -@Service -class MinioService( - private val minioClient: MinioClient, - @Value("\${minio.bucket}") - private val bucket: String, - @Value("\${minio.base-url}") - private val baseUrl: String, -) : FileStorageService { - - override fun uploadImageFile(imageFile: MultipartFile, newFileName: String): String? { - val originalName = imageFile.originalFilename ?: return null - - val ext = originalName.substring(originalName.lastIndexOf(".")) - val changedName = newFileName + ext - - try { - minioClient.putObject( - PutObjectArgs.builder() - .bucket(bucket) - .`object`(changedName) - .stream(imageFile.inputStream, imageFile.size, -1) - .contentType(imageFile.contentType) - .build() - ) - } catch (e: IOException) { - throw ApiException(GlobalErrorCode.IMAGE_UPLOAD_FAILED, e) - } - - return "${baseUrl}/${bucket}/${changedName}" - } - - override fun deleteImageFile(fileName: String) { - val imageKey = fileName.replace("${baseUrl}/${bucket}/", "") - - try { - minioClient.statObject( - StatObjectArgs.builder() - .bucket(bucket) - .`object`(imageKey) - .build() - ) - } catch (e: ErrorResponseException) { - throw ApiException(GlobalErrorCode.IMAGE_NOT_FOUND) - } - - try { - minioClient.removeObject( - RemoveObjectArgs.builder() - .bucket(bucket) - .`object`(imageKey) - .build() - ) - } catch (e: IOException) { - throw ApiException(GlobalErrorCode.IMAGE_DELETE_FAILED, e) - } - } -} diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Config.kt b/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Config.kt new file mode 100644 index 0000000..af00d9b --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Config.kt @@ -0,0 +1,40 @@ +package site.billilge.api.backend.global.external.r2 + +import org.springframework.beans.factory.annotation.Value +import org.springframework.context.annotation.Bean +import org.springframework.context.annotation.Configuration +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider +import software.amazon.awssdk.core.checksums.RequestChecksumCalculation +import software.amazon.awssdk.core.checksums.ResponseChecksumValidation +import software.amazon.awssdk.regions.Region +import software.amazon.awssdk.services.s3.S3Client +import java.net.URI + +@Configuration +class R2Config( + @Value("\${r2.endpoint}") + private val endpoint: String, + + @Value("\${r2.access-key}") + private val accessKey: String, + + @Value("\${r2.secret-key}") + private val secretKey: String, +) { + + @Bean + fun r2Client(): S3Client { + return S3Client.builder() + .endpointOverride(URI.create(endpoint)) + .region(Region.of("auto")) + .credentialsProvider( + StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secretKey)) + ) + .forcePathStyle(true) + // R2는 AWS SDK 기본값(모든 요청에 CRC 체크섬 부착)을 완전히 지원하지 않으므로 필요한 경우에만 계산 + .requestChecksumCalculation(RequestChecksumCalculation.WHEN_REQUIRED) + .responseChecksumValidation(ResponseChecksumValidation.WHEN_REQUIRED) + .build() + } +} diff --git a/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Service.kt b/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Service.kt new file mode 100644 index 0000000..1619506 --- /dev/null +++ b/src/main/kotlin/site/billilge/api/backend/global/external/r2/R2Service.kt @@ -0,0 +1,83 @@ +package site.billilge.api.backend.global.external.r2 + +import org.springframework.beans.factory.annotation.Value +import org.springframework.stereotype.Service +import org.springframework.web.multipart.MultipartFile +import site.billilge.api.backend.global.exception.ApiException +import site.billilge.api.backend.global.exception.GlobalErrorCode +import site.billilge.api.backend.global.external.FileStorageService +import software.amazon.awssdk.core.exception.SdkException +import software.amazon.awssdk.core.sync.RequestBody +import software.amazon.awssdk.services.s3.S3Client +import software.amazon.awssdk.services.s3.model.DeleteObjectRequest +import software.amazon.awssdk.services.s3.model.HeadObjectRequest +import software.amazon.awssdk.services.s3.model.PutObjectRequest +import software.amazon.awssdk.services.s3.model.S3Exception +import java.io.IOException + +@Service +class R2Service( + private val r2Client: S3Client, + @Value("\${r2.bucket}") + private val bucket: String, + @Value("\${r2.public-url}") + publicUrl: String, +) : FileStorageService { + + // R2 공개 URL(r2.dev 또는 커스텀 도메인)은 버킷에 직접 연결되므로 경로에 버킷명이 들어가지 않는다 + private val publicUrl = publicUrl.trimEnd('/') + + override fun uploadImageFile(imageFile: MultipartFile, newFileName: String): String? { + val originalName = imageFile.originalFilename ?: return null + + val ext = originalName.substring(originalName.lastIndexOf(".")) + val key = newFileName + ext + + val request = PutObjectRequest.builder() + .bucket(bucket) + .key(key) + .contentType(imageFile.contentType) + .build() + + try { + imageFile.inputStream.use { + r2Client.putObject(request, RequestBody.fromInputStream(it, imageFile.size)) + } + } catch (e: IOException) { + throw ApiException(GlobalErrorCode.IMAGE_UPLOAD_FAILED, e) + } catch (e: SdkException) { + throw ApiException(GlobalErrorCode.IMAGE_UPLOAD_FAILED, e) + } + + return "$publicUrl/$key" + } + + override fun deleteImageFile(fileName: String) { + val key = fileName.removePrefix("$publicUrl/") + + try { + r2Client.headObject( + HeadObjectRequest.builder() + .bucket(bucket) + .key(key) + .build() + ) + } catch (e: S3Exception) { + if (e.statusCode() == 404) throw ApiException(GlobalErrorCode.IMAGE_NOT_FOUND) + throw ApiException(GlobalErrorCode.IMAGE_DELETE_FAILED, e) + } catch (e: SdkException) { + throw ApiException(GlobalErrorCode.IMAGE_DELETE_FAILED, e) + } + + try { + r2Client.deleteObject( + DeleteObjectRequest.builder() + .bucket(bucket) + .key(key) + .build() + ) + } catch (e: SdkException) { + throw ApiException(GlobalErrorCode.IMAGE_DELETE_FAILED, e) + } + } +} diff --git a/src/main/resources/application-dev.yml b/src/main/resources/application-dev.yml index eb2e6b1..ee52c14 100644 --- a/src/main/resources/application-dev.yml +++ b/src/main/resources/application-dev.yml @@ -77,12 +77,12 @@ login: cors: allowed-origins: ${CORS_ALLOWED_ORIGINS} -minio: - endpoint: ${MINIO_ENDPOINT} - access-key: ${MINIO_ACCESS_KEY} - secret-key: ${MINIO_SECRET_KEY} - bucket: ${MINIO_BUCKET} - base-url: ${MINIO_BASE_URL} +r2: + endpoint: ${R2_ENDPOINT} + access-key: ${R2_ACCESS_KEY} + secret-key: ${R2_SECRET_KEY} + bucket: ${R2_BUCKET} + public-url: ${R2_PUBLIC_URL} swagger: server: diff --git a/src/main/resources/application-prod.yml b/src/main/resources/application-prod.yml index 8774db8..ac013fe 100644 --- a/src/main/resources/application-prod.yml +++ b/src/main/resources/application-prod.yml @@ -68,12 +68,12 @@ login: cors: allowed-origins: ${CORS_ALLOWED_ORIGINS} -minio: - endpoint: ${MINIO_ENDPOINT} - access-key: ${MINIO_ACCESS_KEY} - secret-key: ${MINIO_SECRET_KEY} - bucket: ${MINIO_BUCKET} - base-url: ${MINIO_BASE_URL} +r2: + endpoint: ${R2_ENDPOINT} + access-key: ${R2_ACCESS_KEY} + secret-key: ${R2_SECRET_KEY} + bucket: ${R2_BUCKET} + public-url: ${R2_PUBLIC_URL} swagger: server: