[FEAT] 주제, 선택지 조회 기능 구현

backend/build.gradle

@@ -43,6 +43,7 @@ dependencies {
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'org.springframework.restdocs:spring-restdocs-mockmvc'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    testImplementation 'io.rest-assured:rest-assured:5.5.0'
 }
 
 tasks.named('test') {

backend/src/main/java/ddangkong/controller/content/BalanceContentController.java

@@ -0,0 +1,22 @@
+package ddangkong.controller.content;
+
+import ddangkong.controller.content.dto.BalanceContentResponse;
+import ddangkong.service.content.BalanceContentService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api")
+@RequiredArgsConstructor
+public class BalanceContentController {
+
+    private final BalanceContentService balanceContentService;
+
+    @GetMapping("/balances/rooms/{roomId}/question")
+    public BalanceContentResponse getBalanceContent(@PathVariable Long roomId) {
+        return balanceContentService.findRecentBalanceContent(roomId);
+    }
+}

backend/src/main/java/ddangkong/controller/content/dto/BalanceContentResponse.java

@@ -0,0 +1,27 @@
+package ddangkong.controller.content.dto;
+
+import ddangkong.controller.option.dto.BalanceOptionResponse;
+import ddangkong.domain.content.BalanceContent;
+import ddangkong.domain.content.Category;
+import ddangkong.domain.option.BalanceOption;
+import lombok.Builder;
+
+public record BalanceContentResponse(
+        Long questionId,
+        Category category,
+        String title,
+        BalanceOptionResponse firstOption,
+        BalanceOptionResponse secondOption
+) {
+
+    @Builder
+    private BalanceContentResponse(BalanceContent balanceContent,
+                                   BalanceOption firstOption,
+                                   BalanceOption secondOption) {
+        this(balanceContent.getId(),
+                balanceContent.getCategory(),
+                balanceContent.getName(),
+                BalanceOptionResponse.from(firstOption),
+                BalanceOptionResponse.from(secondOption));
+    }
+}

backend/src/main/java/ddangkong/controller/exception/GlobalExceptionHandler.java

@@ -1,5 +1,7 @@
 package ddangkong.controller.exception;
 
+import ddangkong.service.excpetion.BusinessLogicException;
+import ddangkong.service.excpetion.ViolateDataException;
 import jakarta.validation.ConstraintViolationException;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
@@ -12,6 +14,8 @@
 @Slf4j
 public class GlobalExceptionHandler {
 
+    private static final String SERVER_ERROR_MESSAGE = "서버 오류가 발생했습니다. 관리자에게 문의하세요.";
+
     @ExceptionHandler
     public ErrorResponse handleBindingException(BindException e) {
         log.warn(e.getMessage());
@@ -26,11 +30,27 @@ public ErrorResponse handleConstraintViolationException(ConstraintViolationExcep
         return new ErrorResponse(e.getConstraintViolations());
     }
 
+    @ExceptionHandler
+    @ResponseStatus(HttpStatus.BAD_REQUEST)
+    public ErrorResponse handleBusinessLogicException(BusinessLogicException e) {
+        log.warn(e.getMessage());
+
+        return new ErrorResponse(e.getMessage());
+    }
+
+    @ExceptionHandler
+    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
+    public ErrorResponse handleViolateDataException(ViolateDataException e) {
+        log.error(e.getMessage());
+
+        return new ErrorResponse(SERVER_ERROR_MESSAGE);
+    }
+
     @ExceptionHandler
     @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
     public ErrorResponse handleException(Exception e) {
         log.error(e.getMessage());
 
-        return new ErrorResponse("서버 오류가 발생했습니다. 관리자에게 문의하세요.");
+        return new ErrorResponse(SERVER_ERROR_MESSAGE);
     }
 }

backend/src/main/java/ddangkong/controller/option/dto/BalanceOptionResponse.java

@@ -0,0 +1,12 @@
+package ddangkong.controller.option.dto;
+
+import ddangkong.domain.option.BalanceOption;
+
+public record BalanceOptionResponse(
+        Long optionId,
+        String content
+) {
+    public static BalanceOptionResponse from(BalanceOption balanceOption) {
+        return new BalanceOptionResponse(balanceOption.getId(), balanceOption.getName());
+    }
+}

backend/src/main/java/ddangkong/domain/BaseEntity.java

@@ -0,0 +1,19 @@
+package ddangkong.domain;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.MappedSuperclass;
+import java.time.LocalDateTime;
+import lombok.Getter;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener.class)
+@Getter
+public class BaseEntity {
+
+    @CreatedDate
+    @Column(updatable = false, nullable = false)
+    private LocalDateTime createdAt;
+}

backend/src/main/java/ddangkong/domain/question/BalanceQuestion.java → backend/src/main/java/ddangkong/domain/content/BalanceContent.java

@@ -1,4 +1,4 @@
-package ddangkong.domain.question;
+package ddangkong.domain.content;
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
@@ -8,17 +8,13 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
-public class BalanceQuestion {
+public class BalanceContent {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -29,5 +25,5 @@ public class BalanceQuestion {
     private Category category;
 
     @Column(nullable = false)
-    private String content;
+    private String name;
 }

backend/src/main/java/ddangkong/domain/question/Category.java → backend/src/main/java/ddangkong/domain/content/Category.java

@@ -1,4 +1,4 @@
-package ddangkong.domain.question;
+package ddangkong.domain.content;
 
 public enum Category {
     EXAMPLE,

backend/src/main/java/ddangkong/domain/content/RoomContentRepository.java

@@ -0,0 +1,10 @@
+package ddangkong.domain.content;
+
+import ddangkong.domain.room.RoomContent;
+import java.util.Optional;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface RoomContentRepository extends JpaRepository<RoomContent, Long> {
+
+    Optional<RoomContent> findTopByRoomIdOrderByCreatedAtDesc(Long roomId);
+}

backend/src/main/java/ddangkong/domain/member/Member.java

@@ -10,16 +10,12 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
 public class Member {
 
     @Id

backend/src/main/java/ddangkong/domain/option/BalanceOption.java

@@ -1,6 +1,6 @@
 package ddangkong.domain.option;
 
-import ddangkong.domain.question.BalanceQuestion;
+import ddangkong.domain.content.BalanceContent;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.FetchType;
@@ -10,26 +10,22 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
 public class BalanceOption {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     private Long id;
 
     @Column(nullable = false)
-    private String content;
+    private String name;
 
     @ManyToOne(optional = false, fetch = FetchType.LAZY)
-    @JoinColumn(name = "balance_question_id", nullable = false)
-    private BalanceQuestion balanceQuestion;
+    @JoinColumn(name = "balance_content_id", nullable = false)
+    private BalanceContent balanceContent;
 }

backend/src/main/java/ddangkong/domain/option/BalanceOptionRepository.java

@@ -0,0 +1,10 @@
+package ddangkong.domain.option;
+
+import ddangkong.domain.content.BalanceContent;
+import java.util.List;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface BalanceOptionRepository extends JpaRepository<BalanceOption, Long> {
+
+    List<BalanceOption> findByBalanceContent(BalanceContent balanceContent);
+}

backend/src/main/java/ddangkong/domain/room/Room.java

@@ -5,16 +5,12 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
 public class Room {
 
     @Id

backend/src/main/java/ddangkong/domain/room/RoomQuestion.java → backend/src/main/java/ddangkong/domain/room/RoomContent.java

@@ -1,6 +1,7 @@
 package ddangkong.domain.room;
 
-import ddangkong.domain.question.BalanceQuestion;
+import ddangkong.domain.BaseEntity;
+import ddangkong.domain.content.BalanceContent;
 import jakarta.persistence.Entity;
 import jakarta.persistence.FetchType;
 import jakarta.persistence.GeneratedValue;
@@ -9,17 +10,13 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
-public class RoomQuestion {
+public class RoomContent extends BaseEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -30,6 +27,6 @@ public class RoomQuestion {
     private Room room;
 
     @ManyToOne(optional = false, fetch = FetchType.LAZY)
-    @JoinColumn(name = "balance_question_id")
-    private BalanceQuestion balanceQuestion;
+    @JoinColumn(name = "balance_content_id")
+    private BalanceContent balanceContent;
 }

backend/src/main/java/ddangkong/domain/vote/BalanceVote.java

@@ -10,16 +10,12 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import lombok.AccessLevel;
-import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import lombok.ToString;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @Getter
-@EqualsAndHashCode
-@ToString
 public class BalanceVote {
 
     @Id

backend/src/main/java/ddangkong/service/content/BalanceContentService.java

@@ -0,0 +1,54 @@
+package ddangkong.service.content;
+
+import ddangkong.controller.content.dto.BalanceContentResponse;
+import ddangkong.domain.option.BalanceOption;
+import ddangkong.domain.option.BalanceOptionRepository;
+import ddangkong.domain.content.BalanceContent;
+import ddangkong.domain.content.RoomContentRepository;
+import ddangkong.service.excpetion.BusinessLogicException;
+import ddangkong.service.excpetion.ViolateDataException;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+public class BalanceContentService {
+
+    private static final int BALANCE_OPTION_SIZE = 2;
+
+    private final RoomContentRepository roomContentRepository;
+
+    private final BalanceOptionRepository balanceOptionRepository;
+
+    @Transactional(readOnly = true)
+    public BalanceContentResponse findRecentBalanceContent(Long roomId) {
+        BalanceContent balanceContent = findRecentContent(roomId);
+        List<BalanceOption> balanceOptions = findBalanceOptions(balanceContent);
+
+        return BalanceContentResponse.builder()
+                .balanceContent(balanceContent)
+                .firstOption(balanceOptions.get(0))
+                .secondOption(balanceOptions.get(1))
+                .build();
+    }
+
+    private BalanceContent findRecentContent(Long roomId) {
+        return roomContentRepository.findTopByRoomIdOrderByCreatedAtDesc(roomId)
+                .orElseThrow(() -> new BusinessLogicException("해당 방의 질문이 존재하지 않습니다."))
+                .getBalanceContent();
+    }
+
+    private List<BalanceOption> findBalanceOptions(BalanceContent balanceContent) {
+        List<BalanceOption> balanceOptions = balanceOptionRepository.findByBalanceContent(balanceContent);
+        validateBalanceOptions(balanceOptions);
+        return balanceOptions;
+    }
+
+    private void validateBalanceOptions(List<BalanceOption> balanceOptions) {
+        if (balanceOptions.size() != BALANCE_OPTION_SIZE) {
+            throw new ViolateDataException("밸런스 게임의 선택지가 %d개입니다".formatted(balanceOptions.size()));
+        }
+    }
+}

backend/src/main/java/ddangkong/service/excpetion/BusinessLogicException.java

@@ -0,0 +1,8 @@
+package ddangkong.service.excpetion;
+
+public class BusinessLogicException extends RuntimeException {
+
+    public BusinessLogicException(String message) {
+        super(message);
+    }
+}

backend/src/main/java/ddangkong/service/excpetion/ViolateDataException.java

@@ -0,0 +1,8 @@
+package ddangkong.service.excpetion;
+
+public class ViolateDataException extends RuntimeException {
+
+    public ViolateDataException(String message) {
+        super(message);
+    }
+}