#323 [Merge] v2.0.16 업데이트

Author: si-zero

docs/api-specs/notification-api.md

@@ -158,7 +158,35 @@
 
 ---
 
-### 3.2 `GET /api/v1/notifications/{notificationId}`
+### 3.2 `GET /api/v1/notifications/unread`
+
+알림함 벨 아이콘 배지 표시용으로, 미읽음 알림 존재 여부만 가볍게 확인합니다. 목록 조회와 달리 페이지네이션 없이 boolean 하나만 반환합니다.
+
+요청 헤더:
+
+- `Authorization: Bearer {access_token}`
+
+쿼리 파라미터:
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---|---|---|---|
+| `category` | `string` | N | `ALL` \| `CONTENT` \| `NOTICE` \| `EVENT` (생략 시 전체 기준) |
+
+성공 응답 `200 OK`:
+
+```json
+{
+  "statusCode": 200,
+  "data": {
+    "hasUnread": true
+  },
+  "error": null
+}
+```
+
+---
+
+### 3.3 `GET /api/v1/notifications/{notificationId}`
 
 알림 상세를 조회합니다. (목록과 동일한 필드 + `readAt`)
 
@@ -202,7 +230,7 @@
 
 ---
 
-### 3.3 `PATCH /api/v1/notifications/{notificationId}/read`
+### 3.4 `PATCH /api/v1/notifications/{notificationId}/read`
 
 알림 1건을 읽음 처리합니다.
 
@@ -222,7 +250,7 @@
 
 ---
 
-### 3.4 `PATCH /api/v1/notifications/read-all`
+### 3.5 `PATCH /api/v1/notifications/read-all`
 
 알림함의 모든 알림을 읽음 처리합니다.
 

src/main/java/com/swyp/picke/domain/notification/controller/NotificationController.java

@@ -2,6 +2,7 @@
 
 import com.swyp.picke.domain.notification.dto.response.NotificationDetailResponse;
 import com.swyp.picke.domain.notification.dto.response.NotificationListResponse;
+import com.swyp.picke.domain.notification.dto.response.NotificationUnreadResponse;
 import com.swyp.picke.domain.notification.enums.NotificationCategory;
 import com.swyp.picke.domain.notification.service.NotificationService;
 import com.swyp.picke.global.common.response.ApiResponse;
@@ -35,6 +36,15 @@ public ApiResponse<NotificationListResponse> getNotifications(
         return ApiResponse.onSuccess(notificationService.getNotifications(userId, category, page, size));
     }
 
+    @Operation(summary = "알림 미읽음 여부 확인 (배지용)")
+    @GetMapping("/unread")
+    public ApiResponse<NotificationUnreadResponse> hasUnread(
+            @AuthenticationPrincipal Long userId,
+            @RequestParam(required = false) NotificationCategory category
+    ) {
+        return ApiResponse.onSuccess(notificationService.hasUnread(userId, category));
+    }
+
     @Operation(summary = "알림 상세 조회")
     @GetMapping("/{notificationId}")
     public ApiResponse<NotificationDetailResponse> getNotificationDetail(

src/main/java/com/swyp/picke/domain/notification/dto/response/NotificationUnreadResponse.java

@@ -0,0 +1,5 @@
+package com.swyp.picke.domain.notification.dto.response;
+
+public record NotificationUnreadResponse(
+        boolean hasUnread
+) {}

src/main/java/com/swyp/picke/domain/notification/repository/NotificationRepository.java

@@ -38,6 +38,20 @@ AND NOT EXISTS (
         """)
     boolean hasUnreadBroadcast(@Param("userId") Long userId, @Param("category") NotificationCategory category);
 
+    @Query("""
+        SELECT CASE WHEN COUNT(n) > 0 THEN true ELSE false END
+        FROM Notification n
+        WHERE (:category IS NULL OR n.category = :category)
+          AND (
+              (n.user.id = :userId AND n.read = false)
+              OR (n.user IS NULL AND NOT EXISTS (
+                  SELECT 1 FROM NotificationRead nr
+                  WHERE nr.notification = n AND nr.userId = :userId
+              ))
+          )
+        """)
+    boolean existsUnread(@Param("userId") Long userId, @Param("category") NotificationCategory category);
+
     @Modifying
     @Query("""
             UPDATE Notification n SET n.read = true, n.readAt = CURRENT_TIMESTAMP

src/main/java/com/swyp/picke/domain/notification/service/NotificationService.java

@@ -3,6 +3,7 @@
 import com.swyp.picke.domain.notification.dto.response.NotificationDetailResponse;
 import com.swyp.picke.domain.notification.dto.response.NotificationListResponse;
 import com.swyp.picke.domain.notification.dto.response.NotificationSummaryResponse;
+import com.swyp.picke.domain.notification.dto.response.NotificationUnreadResponse;
 import com.swyp.picke.domain.notification.entity.Notification;
 import com.swyp.picke.domain.notification.entity.NotificationRead;
 import com.swyp.picke.domain.notification.enums.NotificationCategory;
@@ -146,6 +147,11 @@ public boolean hasNewBroadcast(Long userId, NotificationCategory category) {
         return notificationRepository.hasUnreadBroadcast(userId, category);
     }
 
+    public NotificationUnreadResponse hasUnread(Long userId, NotificationCategory category) {
+        NotificationCategory filterCategory = (category == null || category == NotificationCategory.ALL) ? null : category;
+        return new NotificationUnreadResponse(notificationRepository.existsUnread(userId, filterCategory));
+    }
+
     private Notification getAccessibleNotification(Long userId, Long notificationId) {
         Notification notification = notificationRepository.findById(notificationId)
                 .orElseThrow(() -> new CustomException(ErrorCode.NOTIFICATION_NOT_FOUND));

src/test/java/com/swyp/picke/domain/notification/service/NotificationServiceTest.java

@@ -283,6 +283,30 @@ void markAllAsRead_calls_repository() {
         verify(notificationReadRepository).markAllBroadcastAsRead(userId);
     }
 
+    @Test
+    @DisplayName("ALL 카테고리로 미읽음 여부를 확인하면 카테고리 필터 없이 조회한다")
+    void hasUnread_withAllCategory_queriesWithoutCategoryFilter() {
+        Long userId = 1L;
+        when(notificationRepository.existsUnread(userId, null)).thenReturn(true);
+
+        var response = notificationService.hasUnread(userId, NotificationCategory.ALL);
+
+        assertThat(response.hasUnread()).isTrue();
+        verify(notificationRepository).existsUnread(userId, null);
+    }
+
+    @Test
+    @DisplayName("카테고리를 지정하면 해당 카테고리로 미읽음 여부를 확인한다")
+    void hasUnread_withSpecificCategory_queriesWithCategoryFilter() {
+        Long userId = 1L;
+        when(notificationRepository.existsUnread(userId, NotificationCategory.CONTENT)).thenReturn(false);
+
+        var response = notificationService.hasUnread(userId, NotificationCategory.CONTENT);
+
+        assertThat(response.hasUnread()).isFalse();
+        verify(notificationRepository).existsUnread(userId, NotificationCategory.CONTENT);
+    }
+
     private User createMockUser() {
         return User.builder()
                 .userTag("test-user-tag")