feat : 추천/추천 취소 기능 -> 추천/비추천 기능으로 변경 + 테스트 코드 작성 (#69)

* refactor : 도메인 model 패키지 구조 변경

* feat : 커뮤니티 추천, 비추천 기능 구현 완료

- 추천 요청 또는 상태 조회 시 VoteResponse 반환
  - VoteResponse는 추천 상태, 해당 토론글 또는 댓글의 추천, 비추천 개수를 포함하고 있음
- 알림 관련 버그
  - VoteType=UP인 상태로 추천 요청을 날리면 이전 상태와 상관 없이 그 때마다 알림이 발생함

* feat : 알림 도배 버그 수정

- afterVote() 메서드 호출 시 이전 추천 상태를 확인하도록 함

* feat : 알림 상태 저장 로직 버그 수정

- VoteType NONE 요청을 계속 날리면 에러가 발생하는 버그를 수정함
  - `could not execute statement [Data truncated for column 'vote_type' at row 1] [insert into discussion_vote (created_at,discussion_id,vote_type,voter_id) values (?,?,?,?)]`
- 로직을 수정해서 NONE 요청이라면 가장 먼저 처리하도록 함

* feat : 추천 관련 도메인 서비스 - 단위 테스트 작성 완료

- 애플리케이션 서비스는 추후 통합 테스트로 커버할 예정

* docs : 추천 관련 swagger 어노테이션 추가

* feat : request DTO null 제약 조건 추가

* feat : 추천, 비추천 카운트 쿼리에서 enum과 관련된 타입 안정성 문제 해결

- VoteType 값을 파라미터로 받아서 적용함

Author: NCookies

src/main/java/org/ezcode/codetest/application/community/dto/request/DiscussionCreateRequest.java

@@ -2,7 +2,7 @@
 
 import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
 
-import org.ezcode.codetest.domain.community.model.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
 import org.ezcode.codetest.domain.language.model.entity.Language;
 import org.ezcode.codetest.domain.problem.model.entity.Problem;
 import org.ezcode.codetest.domain.user.model.entity.User;

src/main/java/org/ezcode/codetest/application/community/dto/request/ReplyCreateRequest.java

@@ -2,8 +2,8 @@
 
 import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
 
-import org.ezcode.codetest.domain.community.model.Discussion;
-import org.ezcode.codetest.domain.community.model.Reply;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.Reply;
 import org.ezcode.codetest.domain.user.model.entity.User;
 
 import io.swagger.v3.oas.annotations.media.Schema;

src/main/java/org/ezcode/codetest/application/community/dto/request/VoteRequest.java

@@ -0,0 +1,22 @@
+package org.ezcode.codetest.application.community.dto.request;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
+
+import org.ezcode.codetest.domain.community.model.enums.VoteType;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+@Schema(name = "VoteRequest", description = "추천 요청 DTO")
+public record VoteRequest(
+
+	@Schema(
+		description = "투표 유형 (UP / DOWN / NONE)",
+		example = "UP",
+		requiredMode = REQUIRED
+	)
+	@NotNull
+	VoteType voteType
+
+) {
+}

src/main/java/org/ezcode/codetest/application/community/dto/response/DiscussionResponse.java

@@ -3,7 +3,7 @@
 import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
 
 import org.ezcode.codetest.application.usermanagement.user.dto.response.SimpleUserInfoResponse;
-import org.ezcode.codetest.domain.community.model.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 

src/main/java/org/ezcode/codetest/application/community/dto/response/ReplyResponse.java

@@ -3,7 +3,7 @@
 import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
 
 import org.ezcode.codetest.application.usermanagement.user.dto.response.SimpleUserInfoResponse;
-import org.ezcode.codetest.domain.community.model.Reply;
+import org.ezcode.codetest.domain.community.model.entity.Reply;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 

src/main/java/org/ezcode/codetest/application/community/dto/response/VoteResponse.java

@@ -2,19 +2,43 @@
 
 import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.*;
 
+import org.ezcode.codetest.domain.community.model.VoteResult;
+import org.ezcode.codetest.domain.community.model.enums.VoteType;
+
 import io.swagger.v3.oas.annotations.media.Schema;
 
 @Schema(name = "VoteResponse", description = "추천 상태 응답 DTO")
 public record VoteResponse(
+
+	@Schema(
+		description = "현재 투표 유형",
+		example = "UP / DOWN / NONE",
+		requiredMode = REQUIRED
+	)
+	VoteType voteType,
+
 	@Schema(
-		description = "추천 상태 (추천되어 있으면 true, 취소되면 false)",
-		example = "true",
+		description = "총 UPVOTE 수",
+		example = "10",
 		requiredMode = REQUIRED
 	)
-	boolean voteStatus
+	Long upvoteCount,
+
+	@Schema(
+		description = "총 DOWNVOTE 수",
+		example = "2",
+		requiredMode = REQUIRED
+	)
+	Long downvoteCount
+
 ) {
 
-	public static VoteResponse of(boolean voteStatus) {
-		return new VoteResponse(voteStatus);
+	public static VoteResponse from(VoteResult voteResult) {
+
+		return new VoteResponse(
+			voteResult.voteType(),
+			voteResult.upvoteCount(),
+			voteResult.downvoteCount()
+		);
 	}
 }

src/main/java/org/ezcode/codetest/application/community/service/BaseVoteService.java

@@ -1,7 +1,9 @@
 package org.ezcode.codetest.application.community.service;
 
 import org.ezcode.codetest.application.community.dto.response.VoteResponse;
-import org.ezcode.codetest.domain.community.model.BaseVote;
+import org.ezcode.codetest.domain.community.model.VoteResult;
+import org.ezcode.codetest.domain.community.model.entity.BaseVote;
+import org.ezcode.codetest.domain.community.model.enums.VoteType;
 import org.ezcode.codetest.domain.community.service.BaseVoteDomainService;
 import org.ezcode.codetest.domain.user.model.entity.User;
 import org.ezcode.codetest.domain.user.service.UserDomainService;
@@ -15,34 +17,27 @@ public abstract class BaseVoteService<T extends BaseVote, D extends BaseVoteDoma
 	protected final D voteDomainService;
 	private final UserDomainService userDomainService;
 
-	/**
-	 * 추천 애플리케이션 서비스 공통 로직
-	 * - 각자 도메인에 맞는 검증 로직을 수행하고 호출됨
-	 * - 추천 토글 (추천 또는 추천 취소)
-	 * - 추천 했다면 알림 등의 후속 동작 수행
-	 *
-	 * @param voterId 추천한 유저 id
-	 * @param targetId 추천 대상 entity id (자유글, 댓글 등)
-	 * @return 추천이 됐는지, 취소가 됐는지 등의 정보를 담은 VoteResponse 반환
-	 */
-	protected VoteResponse toggleVote(Long voterId, Long targetId) {
+	protected VoteResponse manageVote(Long voterId, Long targetId, VoteType voteType) {
 
 		User voter = userDomainService.getUserById(voterId);
 
-		boolean isVoted = voteDomainService.toggleVote(voter, targetId);
+		VoteResult voteResult = voteDomainService.manageVote(voter, targetId, voteType);
 
-		if (isVoted) {
+		// 알림 도배 방지용 검증 로직
+		// voteType=UP인 요청을 반복해서 날릴 경우 알림이 도배될 수 있는 문제를 방지
+		if (voteResult.voteType() == VoteType.UP && voteResult.prevVoteType() != VoteType.UP) {
 			afterVote(voter, targetId);
 		}
 
-		return VoteResponse.of(isVoted);
+		return VoteResponse.from(voteResult);
 	}
 
 	@Transactional(readOnly = true)
 	public VoteResponse getVoteStatus(Long userId, Long targetId) {
 
-		boolean voteStatus = voteDomainService.getVoteStatus(userId, targetId);
-		return new VoteResponse(voteStatus);
+		VoteResult voteResult = voteDomainService.getVoteStatus(userId, targetId);
+
+		return VoteResponse.from(voteResult);
 	}
 
 	protected abstract void afterVote(User voter, Long targetId);

src/main/java/org/ezcode/codetest/application/community/service/DiscussionService.java

@@ -3,7 +3,7 @@
 import org.ezcode.codetest.application.community.dto.request.DiscussionCreateRequest;
 import org.ezcode.codetest.application.community.dto.request.DiscussionModifyRequest;
 import org.ezcode.codetest.application.community.dto.response.DiscussionResponse;
-import org.ezcode.codetest.domain.community.model.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
 import org.ezcode.codetest.domain.community.service.DiscussionDomainService;
 import org.ezcode.codetest.domain.language.model.entity.Language;
 import org.ezcode.codetest.domain.problem.model.entity.Problem;

src/main/java/org/ezcode/codetest/application/community/service/DiscussionVoteService.java

@@ -2,11 +2,12 @@
 
 import java.util.Optional;
 
+import org.ezcode.codetest.application.community.dto.request.VoteRequest;
 import org.ezcode.codetest.application.community.dto.response.VoteResponse;
 import org.ezcode.codetest.application.notification.event.NotificationCreateEvent;
 import org.ezcode.codetest.application.notification.port.NotificationEventService;
-import org.ezcode.codetest.domain.community.model.Discussion;
-import org.ezcode.codetest.domain.community.model.DiscussionVote;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.DiscussionVote;
 import org.ezcode.codetest.domain.community.service.DiscussionDomainService;
 import org.ezcode.codetest.domain.community.service.DiscussionVoteDomainService;
 import org.ezcode.codetest.domain.user.model.entity.User;
@@ -32,11 +33,11 @@ public DiscussionVoteService(
 	}
 
 	@Transactional
-	public VoteResponse toggleVoteOnDiscussion(Long problemId, Long discussionId, Long userId) {
+	public VoteResponse manageVoteOnDiscussion(Long problemId, Long discussionId, VoteRequest request, Long userId) {
 
 		Discussion discussion = voteDomainService.getValidatedDiscussion(discussionId, problemId);
 
-		return super.toggleVote(userId, discussion.getId());
+		return super.manageVote(userId, discussion.getId(), request.voteType());
 	}
 
 	@Override

src/main/java/org/ezcode/codetest/application/community/service/ReplyService.java

@@ -7,8 +7,8 @@
 import org.ezcode.codetest.application.community.dto.response.ReplyResponse;
 import org.ezcode.codetest.application.notification.event.NotificationCreateEvent;
 import org.ezcode.codetest.application.notification.port.NotificationEventService;
-import org.ezcode.codetest.domain.community.model.Discussion;
-import org.ezcode.codetest.domain.community.model.Reply;
+import org.ezcode.codetest.domain.community.model.entity.Discussion;
+import org.ezcode.codetest.domain.community.model.entity.Reply;
 import org.ezcode.codetest.domain.community.service.DiscussionDomainService;
 import org.ezcode.codetest.domain.community.service.ReplyDomainService;
 import org.ezcode.codetest.domain.user.model.entity.User;