[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.AdminNoticesResponse;
+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<AdminNoticesResponse> getAllNotice(HttpServletRequest request) {
+        if (validator.isRateLimited(request) || validator.isUnauthorized(request)) {
+            return ResponseEntity.status(401).build();
+        }
+        AdminNoticesResponse 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,58 @@
+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.AdminNoticesResponse;
+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 AdminNoticesResponse getAllNotice() {
+        List<Notice> allNotices = noticeRepository.findAllOrderedByCreatedAt();
+        return AdminNoticesResponse.from(allNotices);
+    }
+
+    @Transactional
+    public CreateNoticeResponse createNewNotice(CreateNoticeRequest createNoticeRequest) {
+        Notice notice = noticeRepository.save(createNoticeRequest.toEntity());
+        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()
+        );
+        noticeRepository.flush();
+        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/AdminNoticeResponse.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 AdminNoticeResponse(
+    long id,
+    String title,
+    String content,
+    OperationType operationType,
+    LocalDateTime createdAt
+) {
+
+    public static AdminNoticeResponse from(Notice notice) {
+        return new AdminNoticeResponse(
+            notice.getId(),
+            notice.getTitle(),
+            notice.getContent(),
+            notice.getOperationType(),
+            notice.getCreatedAt()
+        );
+    }
+}

src/main/java/kr/allcll/backend/admin/notice/dto/AdminNoticesResponse.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 AdminNoticesResponse(
+    List<AdminNoticeResponse> notices
+) {
+
+    public static AdminNoticesResponse from(List<Notice> allNotices) {
+        return new AdminNoticesResponse(
+            allNotices.stream()
+                .map(AdminNoticeResponse::from)
+                .toList()
+        );
+    }
+}

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

@@ -0,0 +1,29 @@
+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.notice.Notice;
+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
+) {
+
+    public Notice toEntity() {
+        return Notice.of(
+            title,
+            content,
+            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/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 updatedAt
+) {
+
+    public static UpdateNoticeResponse from(Notice notice) {
+        return new UpdateNoticeResponse(
+            notice.getId(),
+            notice.getTitle(),
+            notice.getContent(),
+            notice.getOperationType(),
+            notice.getUpdatedAt()
+        );
+    }
+}

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

@@ -0,0 +1,66 @@
+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;
+
+    @Column(nullable = false)
+    @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/NoticeApi.java

@@ -0,0 +1,20 @@
+package kr.allcll.backend.domain.notice;
+
+import kr.allcll.backend.domain.notice.dto.NoticesResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+public class NoticeApi {
+
+    private final NoticeService noticeService;
+
+    @GetMapping("/api/notices")
+    public ResponseEntity<NoticesResponse> getAllNotice() {
+        NoticesResponse response = noticeService.getAllNotice();
+        return ResponseEntity.ok(response);
+    }
+}

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);
+}