[BE] Feat/#587 핀 댓글 기능 추가 구현

backend/src/docs/asciidoc/pin.adoc

@@ -27,3 +27,23 @@ operation::pin-controller-test/add-image[snippets='http-request,http-response']
 === 핀 이미지 삭제
 
 operation::pin-controller-test/remove-image[snippets='http-request,http-response']
+
+=== 핀 댓글 생성
+
+operation::pin-controller-test/create-parent-pin-comment[snippets='http-request,http-response']
+
+=== 핀 대댓글 생성
+
+operation::pin-controller-test/create-child-pin-comment[snippets='http-request,http-response']
+
+=== 핀 댓글 조회
+
+operation::pin-controller-test/find-all-pin-comment-by-pin-id[snippets='http-request,http-response']
+
+=== 핀 댓글 수정
+
+operation::pin-controller-test/update-pin-comment[snippets='http-request,http-response']
+
+=== 핀 댓글 삭제
+
+operation::pin-controller-test/remove-pin-comment[snippets='http-request,http-response']

backend/src/main/java/com/mapbefine/mapbefine/auth/domain/AuthMember.java

@@ -27,6 +27,8 @@ protected AuthMember(
     public abstract boolean canTopicUpdate(Topic topic);
 
     public abstract boolean canPinCreateOrUpdate(Topic topic);
+
+    public abstract boolean canPinCommentCreate(Topic topic);
 
     public Long getMemberId() {
         return memberId;
@@ -36,4 +38,10 @@ public boolean isSameMember(Long memberId) {
         return Objects.equals(memberId, this.memberId);
     }
 
+    public abstract boolean isAdmin();
+
+    public abstract boolean isUser();
+
+    public abstract boolean isGuest();
+
 }

backend/src/main/java/com/mapbefine/mapbefine/auth/domain/member/Admin.java

@@ -34,4 +34,24 @@ public boolean canPinCreateOrUpdate(Topic topic) {
         return true;
     }
 
-}
+    @Override
+    public boolean canPinCommentCreate(Topic topic) {
+        return true;
+    }
+
+    @Override
+    public boolean isAdmin() {
+        return true;
+    }
+
+    @Override
+    public boolean isUser() {
+        return false;
+    }
+
+    @Override
+    public boolean isGuest() {
+        return false;
+    }
+
+}

backend/src/main/java/com/mapbefine/mapbefine/auth/domain/member/Guest.java

@@ -36,4 +36,24 @@ public boolean canPinCreateOrUpdate(Topic topic) {
         return false;
     }
 
-}
+    @Override
+    public boolean canPinCommentCreate(Topic topic) {
+        return false;
+    }
+
+    @Override
+    public boolean isAdmin() {
+        return false;
+    }
+
+    @Override
+    public boolean isUser() {
+        return false;
+    }
+
+    @Override
+    public boolean isGuest() {
+        return true;
+    }
+
+}

backend/src/main/java/com/mapbefine/mapbefine/auth/domain/member/User.java

@@ -1,6 +1,7 @@
 package com.mapbefine.mapbefine.auth.domain.member;
 
 import com.mapbefine.mapbefine.auth.domain.AuthMember;
+import com.mapbefine.mapbefine.topic.domain.Publicity;
 import com.mapbefine.mapbefine.topic.domain.Topic;
 import com.mapbefine.mapbefine.topic.domain.TopicStatus;
 import java.util.List;
@@ -42,6 +43,28 @@ public boolean canPinCreateOrUpdate(Topic topic) {
         return topicStatus.isAllMembers() || hasPermission(topic.getId());
     }
 
+    @Override
+    public boolean canPinCommentCreate(Topic topic) {
+        Publicity publicity = topic.getPublicity();
+
+        return publicity == Publicity.PUBLIC || isGroup(topic.getId());
+    }
+
+    @Override
+    public boolean isAdmin() {
+        return false;
+    }
+
+    @Override
+    public boolean isUser() {
+        return true;
+    }
+
+    @Override
+    public boolean isGuest() {
+        return false;
+    }
+
     private boolean isCreator(Long topicId) {
         return createdTopic.contains(topicId);
     }

backend/src/main/java/com/mapbefine/mapbefine/pin/application/PinCommandService.java

@@ -1,6 +1,10 @@
 package com.mapbefine.mapbefine.pin.application;
 
 import static com.mapbefine.mapbefine.image.exception.ImageErrorCode.IMAGE_FILE_IS_NULL;
+import static com.mapbefine.mapbefine.pin.exception.PinCommentErrorCode.FORBIDDEN_PIN_COMMENT_CREATE;
+import static com.mapbefine.mapbefine.pin.exception.PinCommentErrorCode.FORBIDDEN_PIN_COMMENT_DELETE;
+import static com.mapbefine.mapbefine.pin.exception.PinCommentErrorCode.FORBIDDEN_PIN_COMMENT_UPDATE;
+import static com.mapbefine.mapbefine.pin.exception.PinCommentErrorCode.PIN_COMMENT_NOT_FOUND;
 import static com.mapbefine.mapbefine.pin.exception.PinErrorCode.FORBIDDEN_PIN_CREATE_OR_UPDATE;
 import static com.mapbefine.mapbefine.pin.exception.PinErrorCode.ILLEGAL_PIN_ID;
 import static com.mapbefine.mapbefine.pin.exception.PinErrorCode.ILLEGAL_PIN_IMAGE_ID;
@@ -16,12 +20,18 @@
 import com.mapbefine.mapbefine.member.domain.Member;
 import com.mapbefine.mapbefine.member.domain.MemberRepository;
 import com.mapbefine.mapbefine.pin.domain.Pin;
+import com.mapbefine.mapbefine.pin.domain.PinComment;
+import com.mapbefine.mapbefine.pin.domain.PinCommentRepository;
 import com.mapbefine.mapbefine.pin.domain.PinImage;
 import com.mapbefine.mapbefine.pin.domain.PinImageRepository;
 import com.mapbefine.mapbefine.pin.domain.PinRepository;
+import com.mapbefine.mapbefine.pin.dto.request.PinCommentCreateRequest;
+import com.mapbefine.mapbefine.pin.dto.request.PinCommentUpdateRequest;
 import com.mapbefine.mapbefine.pin.dto.request.PinCreateRequest;
 import com.mapbefine.mapbefine.pin.dto.request.PinImageCreateRequest;
 import com.mapbefine.mapbefine.pin.dto.request.PinUpdateRequest;
+import com.mapbefine.mapbefine.pin.exception.PinCommentException.PinCommentForbiddenException;
+import com.mapbefine.mapbefine.pin.exception.PinCommentException.PinCommentNotFoundException;
 import com.mapbefine.mapbefine.pin.exception.PinException.PinBadRequestException;
 import com.mapbefine.mapbefine.pin.exception.PinException.PinForbiddenException;
 import com.mapbefine.mapbefine.topic.domain.Topic;
@@ -46,21 +56,24 @@ public class PinCommandService {
     private final MemberRepository memberRepository;
     private final PinImageRepository pinImageRepository;
     private final ImageService imageService;
+    private final PinCommentRepository pinCommentRepository;
 
     public PinCommandService(
             PinRepository pinRepository,
             LocationRepository locationRepository,
             TopicRepository topicRepository,
             MemberRepository memberRepository,
             PinImageRepository pinImageRepository,
-            ImageService imageService
+            ImageService imageService,
+            PinCommentRepository pinCommentRepository
     ) {
         this.pinRepository = pinRepository;
         this.locationRepository = locationRepository;
         this.topicRepository = topicRepository;
         this.memberRepository = memberRepository;
         this.pinImageRepository = pinImageRepository;
         this.imageService = imageService;
+        this.pinCommentRepository = pinCommentRepository;
     }
 
     public long save(
@@ -193,4 +206,81 @@ private void validatePinCreateOrUpdate(AuthMember authMember, Topic topic) {
 
         throw new PinForbiddenException(FORBIDDEN_PIN_CREATE_OR_UPDATE);
     }
+
+    public Long savePinComment(AuthMember authMember, PinCommentCreateRequest request) {
+        Pin pin = findPin(request.pinId());
+        validatePinCommentCreate(authMember, pin);
+        Member member = findMember(authMember.getMemberId());
+        PinComment parentPinComment = findParentPinComment(request.parentPinCommentId());
+
+        PinComment pinComment = PinComment.of(pin, parentPinComment, member, request.content());
+        pinCommentRepository.save(pinComment);
+
+        return pinComment.getId();
+    }
+
+    private void validatePinCommentCreate(AuthMember authMember, Pin pin) {
+        if (authMember.canPinCommentCreate(pin.getTopic())) {
+            return;
+        }
+
+        throw new PinCommentForbiddenException(FORBIDDEN_PIN_COMMENT_CREATE);
+    }
+
+    private PinComment findParentPinComment(Long parentPinComment) {
+        if (Objects.isNull(parentPinComment)) {
+            return null;
+        }
+
+        return pinCommentRepository.findById(parentPinComment)
+                .orElseThrow(() -> new PinCommentNotFoundException(PIN_COMMENT_NOT_FOUND, parentPinComment));
+    }
+
+    public void updatePinComment(
+            AuthMember member,
+            Long pinCommentId,
+            PinCommentUpdateRequest request
+    ) {
+        PinComment pinComment = findPinComment(pinCommentId);
+
+        validatePinCommentUpdate(member, pinComment);
+
+        pinComment.updateContent(request.content());
+    }
+
+    private void validatePinCommentUpdate(AuthMember authMember, PinComment pinComment) {
+        if (isPinCommentCreatorOrAdmin(authMember, pinComment)) {
+            return;
+        }
+
+        throw new PinCommentForbiddenException(FORBIDDEN_PIN_COMMENT_UPDATE);
+    }
+
+    private boolean isPinCommentCreatorOrAdmin(AuthMember authMember, PinComment pinComment) {
+        Long creatorId = pinComment.getCreator().getId();
+
+        return authMember.isSameMember(creatorId) || authMember.isAdmin();
+    }
+
+    private PinComment findPinComment(Long pinCommentId) {
+        return pinCommentRepository.findById(pinCommentId)
+                .orElseThrow(() -> new PinCommentNotFoundException(PIN_COMMENT_NOT_FOUND, pinCommentId));
+    }
+
+    public void deletePinComment(AuthMember member, Long pinCommentId) {
+        PinComment pinComment = findPinComment(pinCommentId);
+
+        validatePinCommentDelete(member, pinComment);
+
+        pinCommentRepository.delete(pinComment);
+    }
+
+    private void validatePinCommentDelete(AuthMember authMember, PinComment pinComment) {
+        if (isPinCommentCreatorOrAdmin(authMember, pinComment)) {
+            return;
+        }
+
+        throw new PinCommentForbiddenException(FORBIDDEN_PIN_COMMENT_DELETE);
+    }
+
 }

backend/src/main/java/com/mapbefine/mapbefine/pin/application/PinQueryService.java

@@ -5,13 +5,17 @@
 
 import com.mapbefine.mapbefine.auth.domain.AuthMember;
 import com.mapbefine.mapbefine.pin.domain.Pin;
+import com.mapbefine.mapbefine.pin.domain.PinComment;
+import com.mapbefine.mapbefine.pin.domain.PinCommentRepository;
 import com.mapbefine.mapbefine.pin.domain.PinRepository;
+import com.mapbefine.mapbefine.pin.dto.response.PinCommentResponse;
 import com.mapbefine.mapbefine.pin.dto.response.PinDetailResponse;
 import com.mapbefine.mapbefine.pin.dto.response.PinResponse;
 import com.mapbefine.mapbefine.pin.exception.PinException.PinForbiddenException;
 import com.mapbefine.mapbefine.pin.exception.PinException.PinNotFoundException;
 import com.mapbefine.mapbefine.topic.domain.Topic;
 import java.util.List;
+import java.util.Objects;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -20,8 +24,10 @@
 public class PinQueryService {
 
     private final PinRepository pinRepository;
+    private final PinCommentRepository pinCommentRepository;
 
-    public PinQueryService(PinRepository pinRepository) {
+    public PinQueryService(PinRepository pinRepository, PinCommentRepository pinCommentRepository) {
+        this.pinCommentRepository = pinCommentRepository;
         this.pinRepository = pinRepository;
     }
 
@@ -56,4 +62,35 @@ public List<PinResponse> findAllPinsByMemberId(AuthMember authMember, Long membe
                 .map(PinResponse::from)
                 .toList();
     }
+
+    public List<PinCommentResponse> findAllPinCommentByPinId(AuthMember member, Long pinId) {
+        Pin pin = findPin(pinId);
+        validateReadAuth(member, pin.getTopic());
+
+        List<PinComment> pinComments = pinCommentRepository.findAllByPinId(pinId);
+
+        return pinComments.stream()
+                .map(pinComment -> pinCommentToResponse(member, pinComment))
+                .toList();
+    }
+
+    private Pin findPin(Long pinId) {
+        return pinRepository.findById(pinId)
+                .orElseThrow(() -> new PinNotFoundException(PIN_NOT_FOUND, pinId));
+    }
+
+    private PinCommentResponse pinCommentToResponse(AuthMember member, PinComment pinComment) {
+        Long creatorId = pinComment.getCreator().getId();
+
+        boolean canChange = (Objects.nonNull(member.getMemberId())
+                && member.isSameMember(creatorId))
+                || member.isAdmin();
+
+        if (pinComment.isParentComment()) {
+            return PinCommentResponse.ofParentComment(pinComment, canChange);
+        }
+
+        return PinCommentResponse.ofChildComment(pinComment, canChange);
+    }
+
 }

backend/src/main/java/com/mapbefine/mapbefine/pin/domain/Pin.java

@@ -48,7 +48,7 @@ public class Pin extends BaseTimeEntity {
     private Topic topic;
 
     @ManyToOne
-    @JoinColumn(name = "member_id")
+    @JoinColumn(name = "member_id", nullable = false)
     private Member creator;
 
     @Column(nullable = false)