[Feat] 댓글 기능 구현

src/main/java/com/kustacks/kuring/admin/adapter/in/web/AdminCommandApiV2.java

@@ -83,10 +83,12 @@ public ResponseEntity<BaseResponse<String>> createAlert(
     @Secured(AdminRole.ROLE_ROOT)
     @ResponseStatus(HttpStatus.NO_CONTENT)
     @DeleteMapping("/alerts/{id}")
-    public void cancelAlert(
+    public ResponseEntity cancelAlert(
             @Parameter(description = "알림 아이디") @NotNull @PathVariable("id") Long id
     ) {
         adminCommandUseCase.cancelAlertSchedule(id);
+
+        return ResponseEntity.noContent().build();
     }
 
     @Operation(summary = "파일 임베딩", description = "어드민이 원하는 파일을 임베딩 하여 쿠링봇에서 사용할 수 있다")

src/main/java/com/kustacks/kuring/common/data/Cursor.java

@@ -0,0 +1,29 @@
+package com.kustacks.kuring.common.data;
+
+public class Cursor {
+
+    private static final String AUTO_ADJUST_DEFAULT_CURSOR = "1";
+    private static final String DEFAULT_CURSOR = "0";
+
+    private final String stringCursor;
+
+    private Cursor(String stringCursor) {
+        this.stringCursor = stringCursor;
+    }
+
+    public String getStringCursor() {
+        return stringCursor;
+    }
+
+    public static Cursor from(String cursor) {
+        if (cursor != null && cursor.equals(AUTO_ADJUST_DEFAULT_CURSOR)) {
+            return new Cursor(DEFAULT_CURSOR);
+        }
+
+        if (cursor == null) {
+            return new Cursor(DEFAULT_CURSOR);
+        }
+
+        return new Cursor(cursor);
+    }
+}

src/main/java/com/kustacks/kuring/common/data/CursorBasedList.java

@@ -0,0 +1,169 @@
+package com.kustacks.kuring.common.data;
+
+import java.util.Collection;
+import java.util.Iterator;
+import java.util.List;
+import java.util.ListIterator;
+import java.util.function.Function;
+
+public class CursorBasedList<T> implements List<T> {
+
+    private final List<T> contents;
+    private final String endCursor;
+    private final boolean hasNext;
+
+    private static final int NEXT_CURSOR_SIZE = 1;
+
+    public CursorBasedList(List<T> contents, String endCursor, boolean hasNext) {
+        this.contents = contents;
+        this.endCursor = endCursor;
+        this.hasNext = hasNext;
+    }
+
+    public List<T> getContents() {
+        return contents;
+    }
+
+    public String getEndCursor() {
+        return endCursor;
+    }
+
+    public boolean hasNext() {
+        return hasNext;
+    }
+
+    @Override
+    public int size() {
+        return contents.size();
+    }
+
+    @Override
+    public boolean isEmpty() {
+        return contents.isEmpty();
+    }
+
+    @Override
+    public boolean contains(Object o) {
+        return contents.contains(o);
+    }
+
+    @Override
+    public Iterator<T> iterator() {
+        return contents.listIterator();
+    }
+
+    @Override
+    public Object[] toArray() {
+        return contents.toArray();
+    }
+
+    @Override
+    public <T1> T1[] toArray(T1[] a) {
+        return contents.toArray(a);
+    }
+
+    @Override
+    public boolean add(T t) {
+        return contents.add(t);
+    }
+
+    @Override
+    public boolean remove(Object o) {
+        return contents.remove(o);
+    }
+
+    @Override
+    public boolean containsAll(Collection<?> c) {
+        return false;
+    }
+
+    @Override
+    public boolean addAll(Collection<? extends T> c) {
+        return false;
+    }
+
+    @Override
+    public boolean addAll(int index, Collection<? extends T> c) {
+        return false;
+    }
+
+    @Override
+    public boolean removeAll(Collection<?> c) {
+        return false;
+    }
+
+    @Override
+    public boolean retainAll(Collection<?> c) {
+        return false;
+    }
+
+    @Override
+    public void clear() {
+        contents.clear();
+    }
+
+    @Override
+    public T get(int index) {
+        return contents.get(index);
+    }
+
+    @Override
+    public T set(int index, T element) {
+        return contents.set(index, element);
+    }
+
+    @Override
+    public void add(int index, T element) {
+        contents.add(index, element);
+    }
+
+    @Override
+    public T remove(int index) {
+        return contents.remove(index);
+    }
+
+    @Override
+    public int indexOf(Object o) {
+        return contents.indexOf(o);
+    }
+
+    @Override
+    public int lastIndexOf(Object o) {
+        return contents.lastIndexOf(o);
+    }
+
+    @Override
+    public ListIterator<T> listIterator() {
+        return contents.listIterator();
+    }
+
+    @Override
+    public ListIterator<T> listIterator(int index) {
+        return contents.listIterator(index);
+    }
+
+    @Override
+    public List<T> subList(int fromIndex, int toIndex) {
+        return contents.subList(fromIndex, toIndex);
+    }
+
+    public static <T> CursorBasedList<T> empty() {
+        return new CursorBasedList<>(List.of(), null, false);
+    }
+
+    public static <T> CursorBasedList<T> of(
+            int limit,
+            CursorGenerator<T> cursorGenerator,
+            Function<Integer, List<T>> sourceContentsLoader
+    ) {
+        List<T> sourceContents = sourceContentsLoader.apply(limit + NEXT_CURSOR_SIZE);
+
+        int subListSize = Math.min(limit, sourceContents.size());
+        List<T> contents = sourceContents.subList(0, subListSize);
+
+        boolean hasNext = limit < sourceContents.size();
+        String endCursor = hasNext ? cursorGenerator.generate(contents.get(limit - 1)) : null;
+
+        return new CursorBasedList<>(contents, endCursor, hasNext);
+    }
+}

src/main/java/com/kustacks/kuring/common/data/CursorGenerator.java

@@ -0,0 +1,6 @@
+package com.kustacks.kuring.common.data;
+
+@FunctionalInterface
+public interface CursorGenerator<T> {
+    String generate(T content);
+}

src/main/java/com/kustacks/kuring/user/domain/Content.java → src/main/java/com/kustacks/kuring/common/domain/Content.java

@@ -1,10 +1,9 @@
-package com.kustacks.kuring.user.domain;
-
-import lombok.AccessLevel;
-import lombok.NoArgsConstructor;
+package com.kustacks.kuring.common.domain;
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Embeddable;
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
 
 @Embeddable
 @NoArgsConstructor(access = AccessLevel.PROTECTED)

src/main/java/com/kustacks/kuring/common/dto/ResponseCodeAndMessages.java

@@ -33,6 +33,8 @@ public enum ResponseCodeAndMessages {
     FEEDBACK_SAVE_SUCCESS(HttpStatus.OK.value(), "피드백 저장에 성공하였습니다"),
     FEEDBACK_SEARCH_SUCCESS(HttpStatus.OK.value(), "피드백 조회에 성공하였습니다"),
     ASK_COUNT_LOOKUP_SUCCESS(HttpStatus.OK.value(), "질문 가능 횟수 조회에 성공하였습니다"),
+    NOTICE_COMMENT_SAVE_SUCCESS(HttpStatus.OK.value(), "공지에 댓글 추가를 성공하였습니다"),
+    NOTICE_COMMENT_EDIT_SUCCESS(HttpStatus.OK.value(), "공지에 댓글 편집을 성공하였습니다"),
 
     /* Alert */
     ALERT_SEARCH_SUCCESS(HttpStatus.OK.value(), "예약 알림 조회에 성공하였습니다"),

src/main/java/com/kustacks/kuring/common/exception/NoPermissionException.java

@@ -0,0 +1,10 @@
+package com.kustacks.kuring.common.exception;
+
+import com.kustacks.kuring.common.exception.code.ErrorCode;
+
+public class NoPermissionException extends BusinessException {
+
+    public NoPermissionException(ErrorCode errorCode) {
+        super(errorCode);
+    }
+}

src/main/java/com/kustacks/kuring/common/exception/code/ErrorCode.java

@@ -62,6 +62,8 @@ public enum ErrorCode {
 
     NOTICE_SCRAPER_CANNOT_SCRAP("학과 홈페이지가 불안정합니다. 공지 정보를 가져올 수 없습니다."),
     NOTICE_SCRAPER_CANNOT_PARSE("공지 페이지 HTML 파싱에 실패했습니다."),
+    NOTICE_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 공지를 찾을 수 없습니다."),
+
 
     FB_FAIL_SUBSCRIBE(HttpStatus.INTERNAL_SERVER_ERROR, "카테고리 구독에 실패했습니다."),
     FB_FAIL_UNSUBSCRIBE(HttpStatus.INTERNAL_SERVER_ERROR, "카테고리 구독 해제에 실패했습니다."),
@@ -75,6 +77,7 @@ public enum ErrorCode {
     AD_UNAUTHENTICATED("관리자가 아닙니다."),
 
     USER_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 사용자를 찾을 수 없습니다."),
+    COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 댓글을 찾을 수 없습니다."),
 
     EMAIL_NO_SUCH_ALGORITHM(HttpStatus.INTERNAL_SERVER_ERROR, "랜덤 숫자 생성 간 알고리즘을 찾을 수 없습니다."),
     EMAIL_INVALID_SUFFIX(HttpStatus.BAD_REQUEST, "건국대학교 이메일 도메인이 아닙니다."),

src/main/java/com/kustacks/kuring/notice/adapter/in/web/NoticeCommandApiV2.java

@@ -0,0 +1,98 @@
+package com.kustacks.kuring.notice.adapter.in.web;
+
+import com.kustacks.kuring.common.annotation.RestWebAdapter;
+import com.kustacks.kuring.common.dto.BaseResponse;
+import com.kustacks.kuring.notice.adapter.in.web.dto.NoticeCommentCreateRequest;
+import com.kustacks.kuring.notice.adapter.in.web.dto.NoticeCommentEditRequest;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentDeletingUseCase;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentDeletingUseCase.DeleteCommentCommand;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentEditingUseCase;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentEditingUseCase.EditCommentCommand;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentWritingUseCase;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentWritingUseCase.WriteCommentCommand;
+import com.kustacks.kuring.notice.application.port.in.NoticeCommentWritingUseCase.WriteReplyCommand;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static com.kustacks.kuring.common.dto.ResponseCodeAndMessages.NOTICE_COMMENT_EDIT_SUCCESS;
+import static com.kustacks.kuring.common.dto.ResponseCodeAndMessages.NOTICE_COMMENT_SAVE_SUCCESS;
+
+@Tag(name = "Notice-Command", description = "공지 가공")
+@Validated
+@RequiredArgsConstructor
+@RestWebAdapter(path = "/api/v2/notices")
+public class NoticeCommandApiV2 {
+
+    private static final String USER_TOKEN_HEADER_KEY = "User-Token";
+
+    private final NoticeCommentWritingUseCase noticeCommentWritingUseCase;
+    private final NoticeCommentEditingUseCase noticeCommentEditingUseCase;
+    private final NoticeCommentDeletingUseCase noticeCommentDeletingUseCase;
+
+    @Operation(summary = "공지 댓글 추가", description = "공지에 댓글을 추가합니다")
+    @SecurityRequirement(name = USER_TOKEN_HEADER_KEY)
+    @PostMapping("/{id}/comments")
+    public ResponseEntity<BaseResponse> createComment(
+            @Parameter(description = "공지 ID") @PathVariable("id") Long id,
+            @RequestHeader(USER_TOKEN_HEADER_KEY) String userToken,
+            @RequestBody NoticeCommentCreateRequest request
+    ) {
+        if (request.parentId() == null) {
+            var command = new WriteCommentCommand(
+                    userToken,
+                    id,
+                    request.content()
+            );
+
+            noticeCommentWritingUseCase.process(command);
+        } else {
+            var command = new WriteReplyCommand(
+                    userToken,
+                    id,
+                    request.content(),
+                    request.parentId()
+            );
+
+            noticeCommentWritingUseCase.process(command);
+        }
+
+        return ResponseEntity.ok().body(new BaseResponse<>(NOTICE_COMMENT_SAVE_SUCCESS, null));
+    }
+
+    @Operation(summary = "공지 댓글 편집", description = "공지에 있는 기존의 댓글을 수정합니다")
+    @SecurityRequirement(name = USER_TOKEN_HEADER_KEY)
+    @PostMapping("/{id}/comments/{commentId}")
+    public ResponseEntity<BaseResponse> editComment(
+            @Parameter(description = "공지 ID") @PathVariable("id") Long id,
+            @Parameter(description = "댓글 ID") @PathVariable("commentId") Long commentId,
+            @RequestHeader(USER_TOKEN_HEADER_KEY) String userToken,
+            @RequestBody NoticeCommentEditRequest request
+    ) {
+        var command = new EditCommentCommand(userToken, id, commentId, request.content());
+
+        noticeCommentEditingUseCase.process(command);
+
+        return ResponseEntity.ok().body(new BaseResponse<>(NOTICE_COMMENT_EDIT_SUCCESS, null));
+    }
+
+    @Operation(summary = "공지 댓글 삭제", description = "공지에 있는 기존의 댓글을 삭제합니다")
+    @SecurityRequirement(name = USER_TOKEN_HEADER_KEY)
+    @DeleteMapping("/{id}/comments/{commentId}")
+    public ResponseEntity deleteComment(
+            @Parameter(description = "공지 ID") @PathVariable("id") Long id,
+            @Parameter(description = "댓글 ID") @PathVariable("commentId") Long commentId,
+            @RequestHeader(USER_TOKEN_HEADER_KEY) String userToken
+    ) {
+        var command = new DeleteCommentCommand(userToken, id, commentId);
+
+        noticeCommentDeletingUseCase.process(command);
+
+        return ResponseEntity.noContent().build();
+    }
+}