feat: 마이페이지 맞춤형 배너 알림 조회 API 구현

src/main/java/com/ongil/backend/domain/banner/controller/BannerController.java

@@ -0,0 +1,33 @@
+package com.ongil.backend.domain.banner.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.ongil.backend.domain.banner.dto.response.BannerResponse;
+import com.ongil.backend.domain.banner.service.BannerService;
+import com.ongil.backend.global.common.dto.DataResponse;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@Tag(name = "Banner", description = "배너 알림 관련 API")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/banner")
+public class BannerController {
+
+	private final BannerService bannerService;
+
+	@GetMapping
+	@Operation(summary = "배너 조회 API", description = "토큰 필요. 현재 사용자에게 보여줄 배너를 조회합니다. 구매 직후 리뷰 유도, 한달 후기 유도, 매거진 추천 중 우선순위에 따라 반환됩니다.")
+	public ResponseEntity<DataResponse<BannerResponse>> getBanner(
+		@AuthenticationPrincipal Long userId
+	) {
+		BannerResponse response = bannerService.getBanner(userId);
+		return ResponseEntity.ok(DataResponse.from(response));
+	}
+}

src/main/java/com/ongil/backend/domain/banner/converter/BannerConverter.java

@@ -0,0 +1,22 @@
+package com.ongil.backend.domain.banner.converter;
+
+import org.springframework.stereotype.Component;
+
+import com.ongil.backend.domain.banner.dto.response.BannerResponse;
+import com.ongil.backend.domain.banner.enums.BannerType;
+
+@Component
+public class BannerConverter {
+
+	public BannerResponse toResponse(BannerType type, String title, String buttonText,
+		String targetUrl, Long targetId, boolean enabled) {
+		return BannerResponse.builder()
+			.type(type)
+			.title(title)
+			.buttonText(buttonText)
+			.targetUrl(targetUrl)
+			.targetId(targetId)
+			.enabled(enabled)
+			.build();
+	}
+}

src/main/java/com/ongil/backend/domain/banner/dto/response/BannerResponse.java

@@ -0,0 +1,16 @@
+package com.ongil.backend.domain.banner.dto.response;
+
+import com.ongil.backend.domain.banner.enums.BannerType;
+
+import lombok.Builder;
+
+@Builder
+public record BannerResponse(
+	BannerType type,
+	String title,
+	String buttonText,
+	String targetUrl,
+	Long targetId,
+	boolean enabled
+) {
+}

src/main/java/com/ongil/backend/domain/banner/enums/BannerType.java

@@ -0,0 +1,14 @@
+package com.ongil.backend.domain.banner.enums;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum BannerType {
+	MAGAZINE("매거진 유도"),
+	REVIEW_PROMPT("구매 직후 리뷰 작성 유도"),
+	MONTHLY_REVIEW_PROMPT("한달 후 리뷰 작성 유도");
+
+	private final String description;
+}

src/main/java/com/ongil/backend/domain/banner/service/BannerService.java

@@ -0,0 +1,132 @@
+package com.ongil.backend.domain.banner.service;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.ongil.backend.domain.banner.converter.BannerConverter;
+import com.ongil.backend.domain.banner.dto.response.BannerResponse;
+import com.ongil.backend.domain.banner.enums.BannerType;
+import com.ongil.backend.domain.order.entity.Order;
+import com.ongil.backend.domain.order.entity.OrderItem;
+import com.ongil.backend.domain.order.enums.OrderStatus;
+import com.ongil.backend.domain.order.repository.OrderRepository;
+import com.ongil.backend.domain.review.enums.ReviewType;
+import com.ongil.backend.domain.review.repository.ReviewRepository;
+
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class BannerService {
+
+	private final OrderRepository orderRepository;
+	private final ReviewRepository reviewRepository;
+	private final BannerConverter bannerConverter;
+
+	public BannerResponse getBanner(Long userId) {
+		// 1순위: 구매직후 후기 미작성
+		BannerResponse initialReviewBanner = checkInitialReviewBanner(userId);
+		if (initialReviewBanner != null) {
+			return initialReviewBanner;
+		}
+
+		// 2순위: 한달 후 후기 미작성
+		BannerResponse monthlyReviewBanner = checkMonthlyReviewBanner(userId);
+		if (monthlyReviewBanner != null) {
+			return monthlyReviewBanner;
+		}
+
+		// 3순위: 매거진 유도 알림
+		return createMagazineBanner();
+	}
+
+	private BannerResponse checkInitialReviewBanner(Long userId) {
+		List<Order> confirmedOrders = orderRepository.findByUserIdAndStatus(
+			userId,
+			OrderStatus.CONFIRMED
+		);
+
+		for (Order order : confirmedOrders) {
+			OrderItem pendingItem = findPendingInitialReviewItem(order);
+			if (pendingItem != null) {
+				return bannerConverter.toResponse(
+					BannerType.REVIEW_PROMPT,
+					"구매하신 상품은 어떠셨나요?",
+					"작성하러 가기",
+					"/review/write",
+					order.getId(),
+					true
+				);
+			}
+		}
+
+		return null;
+	}
+
+	private BannerResponse checkMonthlyReviewBanner(Long userId) {
+		LocalDateTime fiveDaysAgo = LocalDateTime.now().minusDays(5);
+
+		List<Order> orders = orderRepository.findByUserIdAndStatusAndConfirmedAtBefore(
+			userId,
+			OrderStatus.CONFIRMED,
+			fiveDaysAgo
+		);
+
+		for (Order order : orders) {
+			OrderItem pendingItem = findPendingMonthlyReviewItem(order);
+			if (pendingItem != null) {
+				return bannerConverter.toResponse(
+					BannerType.MONTHLY_REVIEW_PROMPT,
+					"한달 후기를 작성해주세요!",
+					"작성하러 가기",
+					"/review/monthly/write",
+					order.getId(),
+					true
+				);
+			}
+		}
+
+		return null;
+	}
+
+	private BannerResponse createMagazineBanner() {
+		return bannerConverter.toResponse(
+			BannerType.MAGAZINE,
+			"추천 매거진을 확인해보세요",
+			"보러가기",
+			"/magazine",
+			null,
+			true
+		);
+	}
+
+	private OrderItem findPendingInitialReviewItem(Order order) {
+		for (OrderItem item : order.getOrderItems()) {
+			boolean hasInitialReview = reviewRepository.existsByOrderItemIdAndReviewType(
+				item.getId(),
+				ReviewType.INITIAL
+			);
+			if (!hasInitialReview) {
+				return item;
+			}
+		}
+		return null;
+	}
+
+	private OrderItem findPendingMonthlyReviewItem(Order order) {
+		for (OrderItem item : order.getOrderItems()) {
+			boolean hasMonthlyReview = reviewRepository.existsByOrderItemIdAndReviewType(
+				item.getId(),
+				ReviewType.ONE_MONTH
+			);
+			if (!hasMonthlyReview) {
+				return item;
+			}
+		}
+		return null;
+	}
+}

src/main/java/com/ongil/backend/domain/order/repository/OrderRepository.java

@@ -1,8 +1,62 @@
 package com.ongil.backend.domain.order.repository;
 
+import java.time.LocalDateTime;
+import java.util.List;
+
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
 
 import com.ongil.backend.domain.order.entity.Order;
+import com.ongil.backend.domain.order.enums.OrderStatus;
 
 public interface OrderRepository extends JpaRepository<Order, Long> {
+
+	// 특정 사용자의 주문 확정 시간 범위로 주문 조회
+	@Query("SELECT o FROM Order o " +
+		"WHERE o.user.id = :userId " +
+		"AND o.orderStatus = :status " +
+		"AND o.confirmedAt >= :startTime " +
+		"AND o.confirmedAt < :endTime " +
+		"ORDER BY o.confirmedAt DESC")
+	List<Order> findByUserIdAndStatusAndConfirmedAtBetween(
+		@Param("userId") Long userId,
+		@Param("status") OrderStatus status,
+		@Param("startTime") LocalDateTime startTime,
+		@Param("endTime") LocalDateTime endTime
+	);
+
+	// 특정 사용자의 주문 확정 시간 이후 주문 조회 (5일 전 이후 확정된 주문)
+	@Query("SELECT o FROM Order o " +
+		"WHERE o.user.id = :userId " +
+		"AND o.orderStatus = :status " +
+		"AND o.confirmedAt >= :afterTime " +
+		"ORDER BY o.confirmedAt ASC")
+	List<Order> findByUserIdAndStatusAndConfirmedAtAfter(
+		@Param("userId") Long userId,
+		@Param("status") OrderStatus status,
+		@Param("afterTime") LocalDateTime afterTime
+	);
+
+	// 특정 사용자의 특정 상태 주문 조회
+	@Query("SELECT o FROM Order o " +
+		"WHERE o.user.id = :userId " +
+		"AND o.orderStatus = :status " +
+		"ORDER BY o.confirmedAt DESC")
+	List<Order> findByUserIdAndStatus(
+		@Param("userId") Long userId,
+		@Param("status") OrderStatus status
+	);
+
+	// 특정 사용자의 주문 확정 시간 이전 주문 조회 (한달 이상 경과)
+	@Query("SELECT o FROM Order o " +
+		"WHERE o.user.id = :userId " +
+		"AND o.orderStatus = :status " +
+		"AND o.confirmedAt <= :beforeTime " +
+		"ORDER BY o.confirmedAt DESC")
+	List<Order> findByUserIdAndStatusAndConfirmedAtBefore(
+		@Param("userId") Long userId,
+		@Param("status") OrderStatus status,
+		@Param("beforeTime") LocalDateTime beforeTime
+	);
 }