[TSK-69] 어드민 공지사항 관리 CRUD 기능 구현

build.gradle

@@ -26,6 +26,7 @@ repositories {
 dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'org.springframework.boot:spring-boot-starter-mail'
 //    implementation 'io.micrometer:micrometer-registry-datadog'

src/main/java/kr/allcll/backend/admin/notice/AdminNoticeApi.java

@@ -0,0 +1,74 @@
+package kr.allcll.backend.admin.notice;
+
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.validation.Valid;
+import kr.allcll.backend.admin.AdminRequestValidator;
+import kr.allcll.backend.admin.notice.dto.CreateNoticeRequest;
+import kr.allcll.backend.admin.notice.dto.CreateNoticeResponse;
+import kr.allcll.backend.admin.notice.dto.NoticesResponse;
+import kr.allcll.backend.admin.notice.dto.UpdateNoticeRequest;
+import kr.allcll.backend.admin.notice.dto.UpdateNoticeResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+public class AdminNoticeApi {
+
+    private final AdminNoticeService adminNoticeService;
+    private final AdminRequestValidator validator;
+
+    @GetMapping("/api/admin/notices")
+    public ResponseEntity<NoticesResponse> getAllNotice(HttpServletRequest request) {
+        if (validator.isRateLimited(request) || validator.isUnauthorized(request)) {
+            return ResponseEntity.status(401).build();
+        }
+        NoticesResponse response = adminNoticeService.getAllNotice();
+        return ResponseEntity.ok(response);
+    }
+
+    @PostMapping("/api/admin/notices")
+    public ResponseEntity<CreateNoticeResponse> createNotice(
+        HttpServletRequest request,
+        @Valid @RequestBody CreateNoticeRequest createNoticeRequest
+    ) {
+        if (validator.isRateLimited(request) || validator.isUnauthorized(request)) {
+            return ResponseEntity.status(401).build();
+        }
+        CreateNoticeResponse response = adminNoticeService.createNewNotice(createNoticeRequest);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    @PatchMapping("/api/admin/notices/{id}")
+    public ResponseEntity<UpdateNoticeResponse> modifyNotice(
+        HttpServletRequest request,
+        @PathVariable Long id,
+        @Valid @RequestBody UpdateNoticeRequest updateNoticeRequest
+    ) {
+        if (validator.isRateLimited(request) || validator.isUnauthorized(request)) {
+            return ResponseEntity.status(401).build();
+        }
+        UpdateNoticeResponse response = adminNoticeService.updateNotice(id, updateNoticeRequest);
+        return ResponseEntity.ok(response);
+    }
+
+    @DeleteMapping("/api/admin/notices/{id}")
+    public ResponseEntity<Void> deleteNotice(
+        HttpServletRequest request,
+        @PathVariable Long id
+    ) {
+        if (validator.isRateLimited(request) || validator.isUnauthorized(request)) {
+            return ResponseEntity.status(401).build();
+        }
+        adminNoticeService.deleteNotice(id);
+        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/AdminNoticeService.java

@@ -0,0 +1,61 @@
+package kr.allcll.backend.admin.notice;
+
+import java.util.List;
+import kr.allcll.backend.admin.notice.dto.CreateNoticeRequest;
+import kr.allcll.backend.admin.notice.dto.CreateNoticeResponse;
+import kr.allcll.backend.admin.notice.dto.NoticesResponse;
+import kr.allcll.backend.admin.notice.dto.UpdateNoticeRequest;
+import kr.allcll.backend.admin.notice.dto.UpdateNoticeResponse;
+import kr.allcll.backend.domain.notice.Notice;
+import kr.allcll.backend.domain.notice.NoticeRepository;
+import kr.allcll.backend.support.exception.AllcllErrorCode;
+import kr.allcll.backend.support.exception.AllcllException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+public class AdminNoticeService {
+
+    private final NoticeRepository noticeRepository;
+
+    public NoticesResponse getAllNotice() {
+        List<Notice> allNotices = noticeRepository.findAllOrderedByCreatedAt();
+        return NoticesResponse.from(allNotices);
+    }
+
+    @Transactional
+    public CreateNoticeResponse createNewNotice(CreateNoticeRequest createNoticeRequest) {
+        Notice notice = noticeRepository.save(Notice.of(
+            createNoticeRequest.title(),
+            createNoticeRequest.content(),
+            createNoticeRequest.operationType()
+        ));
+        return CreateNoticeResponse.from(notice);
+    }
+
+    @Transactional
+    public UpdateNoticeResponse updateNotice(Long id, UpdateNoticeRequest updateNoticeRequest) {
+        Notice notice = noticeRepository.findActiveById(id)
+            .orElseThrow(() -> new AllcllException(AllcllErrorCode.NOTICE_NOT_FOUND, id));
+        notice.update(
+            updateNoticeRequest.title(),
+            updateNoticeRequest.content(),
+            updateNoticeRequest.operationType()
+        );
+        return UpdateNoticeResponse.from(notice);
+    }
+
+    @Transactional
+    public void deleteNotice(Long id) {
+        Notice notice = noticeRepository.findActiveById(id)
+            .orElseThrow(() -> new AllcllException(AllcllErrorCode.NOTICE_NOT_FOUND, id));
+        softDeleteNotice(notice);
+    }
+
+    private void softDeleteNotice(Notice notice) {
+        notice.delete();
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/dto/CreateNoticeRequest.java

@@ -0,0 +1,21 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+
+public record CreateNoticeRequest(
+    @NotBlank
+    @Size(max = 250)
+    String title,
+
+    @NotBlank
+    @Size(max = 1000)
+    String content,
+
+    @NotNull
+    OperationType operationType
+) {
+
+}

src/main/java/kr/allcll/backend/admin/notice/dto/CreateNoticeResponse.java

@@ -0,0 +1,24 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import java.time.LocalDateTime;
+import kr.allcll.backend.domain.notice.Notice;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+
+public record CreateNoticeResponse(
+    long id,
+    String title,
+    String content,
+    OperationType operationType,
+    LocalDateTime createdAt
+) {
+
+    public static CreateNoticeResponse from(Notice notice) {
+        return new CreateNoticeResponse(
+            notice.getId(),
+            notice.getTitle(),
+            notice.getContent(),
+            notice.getOperationType(),
+            notice.getCreatedAt()
+        );
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/dto/NoticeResponse.java

@@ -0,0 +1,24 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import java.time.LocalDateTime;
+import kr.allcll.backend.domain.notice.Notice;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+
+public record NoticeResponse(
+    long id,
+    String title,
+    String content,
+    OperationType operationType,
+    LocalDateTime createdAt
+) {
+
+    public static NoticeResponse from(Notice notice) {
+        return new NoticeResponse(
+            notice.getId(),
+            notice.getTitle(),
+            notice.getContent(),
+            notice.getOperationType(),
+            notice.getCreatedAt()
+        );
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/dto/NoticesResponse.java

@@ -0,0 +1,17 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import java.util.List;
+import kr.allcll.backend.domain.notice.Notice;
+
+public record NoticesResponse(
+    List<NoticeResponse> notices
+) {
+
+    public static NoticesResponse from(List<Notice> allNotices) {
+        return new NoticesResponse(
+            allNotices.stream()
+                .map(NoticeResponse::from)
+                .toList()
+        );
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/dto/UpdateNoticeRequest.java

@@ -0,0 +1,16 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import jakarta.validation.constraints.Size;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+
+public record UpdateNoticeRequest(
+    @Size(max = 250)
+    String title,
+
+    @Size(max = 1000)
+    String content,
+
+    OperationType operationType
+) {
+
+}

src/main/java/kr/allcll/backend/admin/notice/dto/UpdateNoticeResponse.java

@@ -0,0 +1,24 @@
+package kr.allcll.backend.admin.notice.dto;
+
+import java.time.LocalDateTime;
+import kr.allcll.backend.domain.notice.Notice;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+
+public record UpdateNoticeResponse(
+    long id,
+    String title,
+    String content,
+    OperationType operationType,
+    LocalDateTime createdAt
+) {
+
+    public static UpdateNoticeResponse from(Notice notice) {
+        return new UpdateNoticeResponse(
+            notice.getId(),
+            notice.getTitle(),
+            notice.getContent(),
+            notice.getOperationType(),
+            notice.getCreatedAt()
+        );
+    }
+}

src/main/java/kr/allcll/backend/domain/notice/Notice.java

@@ -0,0 +1,65 @@
+package kr.allcll.backend.domain.notice;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import kr.allcll.backend.domain.operationPeriod.OperationType;
+import kr.allcll.backend.support.entity.BaseEntity;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Table(name = "notices")
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class Notice extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, length = 250)
+    private String title;
+
+    @Column(nullable = false, length = 1000)
+    private String content;
+
+    @Enumerated(EnumType.STRING)
+    private OperationType operationType;
+
+    private Notice(String title, String content, OperationType operationType) {
+        this.title = title;
+        this.content = content;
+        this.operationType = operationType;
+    }
+
+    public static Notice of(String title, String content, OperationType operationType) {
+        return new Notice(
+            title,
+            content,
+            operationType
+        );
+    }
+
+    public void update(String title, String content, OperationType operationType) {
+        if (title != null) {
+            this.title = title;
+        }
+        if (content != null) {
+            this.content = content;
+        }
+        if (operationType != null) {
+            this.operationType = operationType;
+        }
+    }
+
+    public void delete() {
+        super.delete();
+    }
+}

src/main/java/kr/allcll/backend/domain/notice/NoticeRepository.java

@@ -0,0 +1,23 @@
+package kr.allcll.backend.domain.notice;
+
+import java.util.List;
+import java.util.Optional;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+
+public interface NoticeRepository extends JpaRepository<Notice, Long> {
+
+    @Query("""
+        select n from Notice n
+        where n.isDeleted = false
+        order by n.createdAt desc
+        """)
+    List<Notice> findAllOrderedByCreatedAt();
+
+    @Query("""
+        select n from Notice n
+        where n.id = :id
+        and n.isDeleted = false
+        """)
+    Optional<Notice> findActiveById(Long id);
+}

src/main/java/kr/allcll/backend/domain/operationPeriod/OperationType.java

@@ -4,12 +4,15 @@
 
 @Getter
 public enum OperationType {
+    ALL("all"),
     TIMETABLE("timetable"),
     BASKETS("baskets"),
     SIMULATION("simulation"),
     LIVE("live"),
     PRESEAT("preseat"),
-    GRADUATION("graduation");
+    GRADUATION("graduation"),
+    REVIEW("review"),
+    ;
 
     private final String value;
 

src/main/java/kr/allcll/backend/domain/review/UserReview.java

@@ -1,5 +1,6 @@
 package kr.allcll.backend.domain.review;
 
+import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.EnumType;
 import jakarta.persistence.Enumerated;
@@ -27,6 +28,7 @@ public class UserReview {
     @Enumerated(EnumType.STRING)
     private OperationType operationType;
 
+    @Column(nullable = false, length = 1000)
     private String detail;
 
     public UserReview(String studentId, Short rate, OperationType operationType, String detail) {