🔨 Refactor: 알림 자동 생성 및 관리 API 추가

src/main/java/com/dodo/backend/admin/controller/AdminController.java

@@ -17,6 +17,9 @@
 import com.dodo.backend.common.exception.ErrorResponse;
 import com.dodo.backend.notification.dto.request.NotificationRequest.NotificationScheduleCreateRequest;
 import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationScheduleCreateResponse;
+import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationScheduleListResponse;
+import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationSimpleResponse;
+import com.dodo.backend.notification.entity.NotificationScheduleStatus;
 import com.dodo.backend.notification.service.NotificationScheduleService;
 import com.dodo.backend.report.entity.ReportStatus;
 import com.dodo.backend.user.entity.UserStatus;
@@ -460,6 +463,13 @@ public ResponseEntity<AdminSimpleResponse> createAnnouncement(
                 .body(adminService.createAnnouncement(adminId, request));
     }
 
+    /**
+     * 알림 스케줄을 등록합니다.
+     *
+     * @param request 알림 스케줄 등록 요청
+     * @param userDetails 인증 관리자 정보
+     * @return 알림 스케줄 등록 결과
+     */
     @Operation(summary = "알림 스케줄 등록", description = "관리자가 지정 시간에 발송될 알림 스케줄을 등록합니다.")
     @ApiResponses(value = {
             @ApiResponse(responseCode = "200", description = "알림 스케줄 등록 성공",
@@ -491,6 +501,55 @@ public ResponseEntity<NotificationScheduleCreateResponse> createNotificationSche
         return ResponseEntity.ok(notificationScheduleService.createSchedule(adminId, request));
     }
 
+    /**
+     * 알림 스케줄 목록을 조회합니다.
+     *
+     * @param page 조회할 페이지 번호
+     * @param size 페이지당 알림 스케줄 수
+     * @param status 알림 스케줄 상태 필터
+     * @param userDetails 인증 관리자 정보
+     * @return 알림 스케줄 목록 조회 결과
+     */
+    @Operation(summary = "알림 스케줄 목록 조회", description = "관리자가 등록된 알림 스케줄 목록을 조회합니다.")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "200", description = "알림 스케줄 목록 조회 성공",
+                    content = @Content(schema = @Schema(implementation = NotificationScheduleListResponse.class)))
+    })
+    @GetMapping("/notification-schedules")
+    public ResponseEntity<NotificationScheduleListResponse> getNotificationSchedules(
+            @RequestParam(defaultValue = "1") int page,
+            @RequestParam(defaultValue = "20") int size,
+            @RequestParam(required = false) NotificationScheduleStatus status,
+            @AuthenticationPrincipal UserDetails userDetails
+    ) {
+        UUID adminId = UUID.fromString(userDetails.getUsername());
+        log.info("관리자 알림 스케줄 목록 조회 요청 - AdminId: {}, Page: {}, Size: {}, Status: {}",
+                adminId, page, size, status);
+        return ResponseEntity.ok(notificationScheduleService.getSchedules(adminId, page, size, status));
+    }
+
+    /**
+     * 알림 스케줄을 취소합니다.
+     *
+     * @param scheduleId 취소할 알림 스케줄 ID
+     * @param userDetails 인증 관리자 정보
+     * @return 알림 스케줄 취소 성공 메시지
+     */
+    @Operation(summary = "알림 스케줄 취소", description = "관리자가 등록된 알림 스케줄을 취소합니다.")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "200", description = "알림 스케줄 취소 성공",
+                    content = @Content(schema = @Schema(implementation = NotificationSimpleResponse.class)))
+    })
+    @DeleteMapping("/notification-schedules/{scheduleId}")
+    public ResponseEntity<NotificationSimpleResponse> cancelNotificationSchedule(
+            @PathVariable Long scheduleId,
+            @AuthenticationPrincipal UserDetails userDetails
+    ) {
+        UUID adminId = UUID.fromString(userDetails.getUsername());
+        log.info("관리자 알림 스케줄 취소 요청 - AdminId: {}, ScheduleId: {}", adminId, scheduleId);
+        return ResponseEntity.ok(notificationScheduleService.cancelSchedule(adminId, scheduleId));
+    }
+
     /**
      * 공지를 삭제합니다.
      *

src/main/java/com/dodo/backend/comment/service/CommentServiceImpl.java

@@ -16,6 +16,7 @@
 import com.dodo.backend.comment.exception.CommentException;
 import com.dodo.backend.comment.mapper.CommentMapper;
 import com.dodo.backend.comment.repository.CommentRepository;
+import com.dodo.backend.notification.service.NotificationService;
 import com.dodo.backend.user.entity.User;
 import com.dodo.backend.user.service.UserService;
 import lombok.RequiredArgsConstructor;
@@ -45,6 +46,7 @@ public class CommentServiceImpl implements CommentService {
     private final CommentMapper commentMapper;
     private final BoardService boardService;
     private final UserService userService;
+    private final NotificationService notificationService;
 
     /**
      * 댓글을 작성합니다.
@@ -72,6 +74,7 @@ public CommentCreateResponse createComment(UUID userId, CommentCreateRequest req
 
         Comment comment = request.toEntity(board, user, parentComment);
         Comment savedComment = commentRepository.save(comment);
+        notificationService.notifyCommentCreated(savedComment);
 
         return CommentCreateResponse.toDto(savedComment, "댓글이 성공적으로 작성되었습니다.");
     }

src/main/java/com/dodo/backend/notification/controller/NotificationController.java

@@ -71,7 +71,7 @@ public class NotificationController {
     })
     @GetMapping
     public ResponseEntity<NotificationListResponse> getNotifications(
-            @RequestParam(defaultValue = "0") int page,
+            @RequestParam(defaultValue = "1") int page,
             @RequestParam(defaultValue = "20") int size,
             @RequestParam(required = false) Boolean isRead,
             @RequestParam(required = false) String type,
@@ -131,12 +131,12 @@ public ResponseEntity<NotificationSimpleResponse> updateReadStatus(
      *
      * @param notificationId 삭제할 알림 ID
      * @param userDetails 인증 사용자 정보
-     * @return 알림 삭제 성공 메시지
+     * @return 응답 본문이 없는 204 응답
      */
     @Operation(summary = "알림 삭제", description = "특정 알림을 삭제합니다.")
     @ApiResponses(value = {
-            @ApiResponse(responseCode = "200", description = "알림이 성공적으로 삭제되었습니다.",
-                    content = @Content(schema = @Schema(implementation = NotificationSimpleResponse.class))),
+            @ApiResponse(responseCode = "204", description = "알림이 성공적으로 삭제되었습니다.",
+                    content = @Content),
             @ApiResponse(responseCode = "400", description = "잘못된 요청입니다.",
                     content = @Content(mediaType = "application/json",
                             schema = @Schema(implementation = ErrorResponse.class),
@@ -159,14 +159,14 @@ public ResponseEntity<NotificationSimpleResponse> updateReadStatus(
                             examples = @ExampleObject(name = "서버 내부 오류가 발생했습니다.", value = "{\"status\": 500, \"message\": \"서버 내부 오류가 발생했습니다.\"}")))
     })
     @DeleteMapping("/{notificationId}")
-    public ResponseEntity<NotificationSimpleResponse> deleteNotification(
+    public ResponseEntity<Void> deleteNotification(
             @PathVariable Long notificationId,
             @AuthenticationPrincipal UserDetails userDetails
     ) {
         UUID userId = UUID.fromString(userDetails.getUsername());
         log.info("알림 삭제 요청 - UserId: {}, NotificationId: {}", userId, notificationId);
         notificationService.deleteNotification(userId, notificationId);
-        return ResponseEntity.ok(NotificationSimpleResponse.toDto("알림이 성공적으로 삭제되었습니다."));
+        return ResponseEntity.noContent().build();
     }
 
     /**
@@ -237,12 +237,12 @@ public ResponseEntity<NotificationSimpleResponse> readAll(
      * 모든 알림을 삭제합니다.
      *
      * @param userDetails 인증 사용자 정보
-     * @return 전체 알림 삭제 성공 메시지
+     * @return 응답 본문이 없는 204 응답
      */
     @Operation(summary = "모든 알림 삭제", description = "로그인 사용자의 모든 알림을 삭제합니다.")
     @ApiResponses(value = {
-            @ApiResponse(responseCode = "200", description = "모든 알림이 성공적으로 삭제되었습니다.",
-                    content = @Content(schema = @Schema(implementation = NotificationSimpleResponse.class))),
+            @ApiResponse(responseCode = "204", description = "모든 알림이 성공적으로 삭제되었습니다.",
+                    content = @Content),
             @ApiResponse(responseCode = "400", description = "잘못된 요청입니다.",
                     content = @Content(mediaType = "application/json",
                             schema = @Schema(implementation = ErrorResponse.class),
@@ -257,12 +257,12 @@ public ResponseEntity<NotificationSimpleResponse> readAll(
                             examples = @ExampleObject(name = "서버 내부 오류가 발생했습니다.", value = "{\"status\": 500, \"message\": \"서버 내부 오류가 발생했습니다.\"}")))
     })
     @DeleteMapping("/all")
-    public ResponseEntity<NotificationSimpleResponse> deleteAll(
+    public ResponseEntity<Void> deleteAll(
             @AuthenticationPrincipal UserDetails userDetails
     ) {
         UUID userId = UUID.fromString(userDetails.getUsername());
         log.info("모든 알림 삭제 요청 - UserId: {}", userId);
         notificationService.deleteAll(userId);
-        return ResponseEntity.ok(NotificationSimpleResponse.toDto("모든 알림이 성공적으로 삭제되었습니다."));
+        return ResponseEntity.noContent().build();
     }
 }

src/main/java/com/dodo/backend/notification/dto/response/NotificationResponse.java

@@ -2,7 +2,9 @@
 
 import com.dodo.backend.notification.entity.Notification;
 import com.dodo.backend.notification.entity.NotificationSchedule;
+import com.dodo.backend.notification.entity.NotificationScheduleRepeatType;
 import com.dodo.backend.notification.entity.NotificationScheduleStatus;
+import com.dodo.backend.notification.entity.NotificationScheduleTargetType;
 import com.dodo.backend.notification.entity.NotificationType;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.AllArgsConstructor;
@@ -11,7 +13,9 @@
 import org.springframework.data.domain.Page;
 
 import java.time.LocalDateTime;
+import java.util.Arrays;
 import java.util.List;
+import java.util.UUID;
 
 /**
  * 알림 API에서 사용하는 응답 DTO를 모아 둔 클래스입니다.
@@ -80,7 +84,7 @@ public static class NotificationItemResponse {
         private String notificationBody;
         @Schema(description = "알림 유형", example = "SYSTEM")
         private NotificationType notificationType;
-        @Schema(description = "알림과 연결된 리소스 ID. 연결 대상이 없으면 null입니다.", example = "31", nullable = true)
+        @Schema(description = "알림과 연결된 리소스 ID. COMMENT/게시글 REACTION은 boardId, 활동기록 REACTION은 historyId입니다.", example = "31", nullable = true)
         private Long relatedId;
         @Schema(description = "알림 읽음 여부", example = "false")
         private Boolean isRead;
@@ -132,6 +136,9 @@ public static UnreadNotificationCountResponse toDto(long unreadCount) {
         }
     }
 
+    /**
+     * 알림 스케줄 등록 응답 DTO입니다.
+     */
     @Getter
     @Builder
     @AllArgsConstructor
@@ -155,4 +162,77 @@ public static NotificationScheduleCreateResponse toDto(NotificationSchedule sche
                     .build();
         }
     }
+
+    /**
+     * 알림 스케줄 목록 아이템 응답 DTO입니다.
+     */
+    @Getter
+    @Builder
+    @AllArgsConstructor
+    @Schema(description = "알림 스케줄 목록 아이템")
+    public static class NotificationScheduleItemResponse {
+        @Schema(description = "알림 스케줄 ID", example = "10")
+        private Long scheduleId;
+        @Schema(description = "알림 제목", example = "공지 알림")
+        private String notificationTitle;
+        @Schema(description = "알림 본문", example = "새로운 공지가 등록되었습니다.")
+        private String notificationBody;
+        @Schema(description = "알림 유형", example = "SYSTEM")
+        private NotificationType notificationType;
+        @Schema(description = "발송 대상 유형", example = "ALL")
+        private NotificationScheduleTargetType targetType;
+        @Schema(description = "targetType이 USERS일 때 발송 대상 사용자 ID 목록")
+        private List<UUID> targetUserIds;
+        @Schema(description = "반복 유형", example = "NONE")
+        private NotificationScheduleRepeatType repeatType;
+        @Schema(description = "알림 스케줄 처리 상태", example = "PENDING")
+        private NotificationScheduleStatus scheduleStatus;
+        @Schema(description = "알림 발송 예정 일시", example = "2026-09-20T09:00:00")
+        private LocalDateTime scheduledAt;
+        @Schema(description = "알림 스케줄 생성 일시", example = "2026-09-14T15:30:00")
+        private LocalDateTime createdAt;
+        @Schema(description = "알림 스케줄 마지막 실행 일시", example = "2026-09-20T09:00:00", nullable = true)
+        private LocalDateTime executedAt;
+
+        public static NotificationScheduleItemResponse toDto(NotificationSchedule schedule) {
+            return NotificationScheduleItemResponse.builder()
+                    .scheduleId(schedule.getNotificationScheduleId())
+                    .notificationTitle(schedule.getNotificationTitle())
+                    .notificationBody(schedule.getNotificationBody())
+                    .notificationType(schedule.getNotificationType())
+                    .targetType(schedule.getTargetType())
+                    .targetUserIds(parseTargetUserIds(schedule.getTargetUserIds()))
+                    .repeatType(schedule.getRepeatType())
+                    .scheduleStatus(schedule.getScheduleStatus())
+                    .scheduledAt(schedule.getScheduledAt())
+                    .createdAt(schedule.getCreatedAt())
+                    .executedAt(schedule.getExecutedAt())
+                    .build();
+        }
+
+        private static List<UUID> parseTargetUserIds(String targetUserIds) {
+            if (targetUserIds == null || targetUserIds.isBlank()) {
+                return List.of();
+            }
+            return Arrays.stream(targetUserIds.split(","))
+                    .map(String::trim)
+                    .filter(value -> !value.isBlank())
+                    .map(UUID::fromString)
+                    .toList();
+        }
+    }
+
+    /**
+     * 알림 스케줄 목록 조회 응답 DTO입니다.
+     */
+    @Getter
+    @Builder
+    @AllArgsConstructor
+    @Schema(description = "알림 스케줄 목록 조회 응답")
+    public static class NotificationScheduleListResponse {
+        @Schema(description = "알림 스케줄 목록의 페이지 정보")
+        private PageInfoResponse pageInfo;
+        @Schema(description = "조회된 알림 스케줄 목록")
+        private List<NotificationScheduleItemResponse> data;
+    }
 }

src/main/java/com/dodo/backend/notification/entity/NotificationSchedule.java

@@ -100,6 +100,11 @@ public void reschedule(LocalDateTime nextScheduledAt, LocalDateTime executedAt)
         clearProcessing();
     }
 
+    public void cancel() {
+        this.scheduleStatus = NotificationScheduleStatus.CANCELED;
+        clearProcessing();
+    }
+
     private void clearProcessing() {
         this.processingToken = null;
         this.processingStartedAt = null;

src/main/java/com/dodo/backend/notification/exception/NotificationErrorCode.java

@@ -22,6 +22,11 @@ public enum NotificationErrorCode implements BaseErrorCode {
      */
     NOTIFICATION_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 ID의 알림을 찾을 수 없습니다."),
 
+    /**
+     * 알림 스케줄을 찾을 수 없는 경우 사용합니다.
+     */
+    NOTIFICATION_SCHEDULE_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 ID의 알림 스케줄을 찾을 수 없습니다."),
+
     /**
      * 알림 수정 권한이 없는 경우 사용합니다.
      */

src/main/java/com/dodo/backend/notification/repository/NotificationScheduleRepository.java

@@ -2,6 +2,7 @@
 
 import com.dodo.backend.notification.entity.NotificationSchedule;
 import com.dodo.backend.notification.entity.NotificationScheduleStatus;
+import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Modifying;
@@ -16,6 +17,8 @@
 @Repository
 public interface NotificationScheduleRepository extends JpaRepository<NotificationSchedule, Long> {
 
+    Page<NotificationSchedule> findAllByScheduleStatus(NotificationScheduleStatus scheduleStatus, Pageable pageable);
+
     @Query("""
             select ns.notificationScheduleId
             from NotificationSchedule ns

src/main/java/com/dodo/backend/notification/service/NotificationScheduleService.java

@@ -2,10 +2,43 @@
 
 import com.dodo.backend.notification.dto.request.NotificationRequest.NotificationScheduleCreateRequest;
 import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationScheduleCreateResponse;
+import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationScheduleListResponse;
+import com.dodo.backend.notification.dto.response.NotificationResponse.NotificationSimpleResponse;
+import com.dodo.backend.notification.entity.NotificationScheduleStatus;
 
 import java.util.UUID;
 
+/**
+ * 알림 스케줄 비즈니스 로직을 정의하는 서비스 인터페이스입니다.
+ */
 public interface NotificationScheduleService {
 
+    /**
+     * 알림 스케줄을 생성합니다.
+     *
+     * @param adminId 요청 관리자 ID
+     * @param request 알림 스케줄 생성 요청
+     * @return 알림 스케줄 생성 결과
+     */
     NotificationScheduleCreateResponse createSchedule(UUID adminId, NotificationScheduleCreateRequest request);
+
+    /**
+     * 알림 스케줄 목록을 조회합니다.
+     *
+     * @param adminId 요청 관리자 ID
+     * @param page 조회할 페이지 번호
+     * @param size 페이지당 알림 스케줄 수
+     * @param status 알림 스케줄 상태 필터
+     * @return 알림 스케줄 목록 조회 결과
+     */
+    NotificationScheduleListResponse getSchedules(UUID adminId, int page, int size, NotificationScheduleStatus status);
+
+    /**
+     * 알림 스케줄을 취소합니다.
+     *
+     * @param adminId 요청 관리자 ID
+     * @param scheduleId 취소할 알림 스케줄 ID
+     * @return 알림 스케줄 취소 성공 메시지
+     */
+    NotificationSimpleResponse cancelSchedule(UUID adminId, Long scheduleId);
 }