[COT-118] Feature: 랜덤 퀴즈 제출 API 구현 (#246)

* feat: develop reply to randomQuiz API

* style: rename parameter

quizId -> randomQuizId

* refactor: change RandomQuiz reply API from POST to GET

* refactor: change type of randomquiz result

* refactor: change type of quiz result

* refactor: change api path

* Revert "refactor: change type of quiz result"

This reverts commit fe14323.

src/main/java/org/cotato/csquiz/api/quiz/controller/RandomQuizController.java

@@ -3,11 +3,14 @@
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
+import org.cotato.csquiz.api.quiz.dto.RandomQuizReplyResponse;
 import org.cotato.csquiz.api.quiz.dto.RandomTutorialQuizResponse;
 import org.cotato.csquiz.domain.education.service.RandomQuizService;
 import org.springframework.http.ResponseEntity;
 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.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 @Tag(name = "CS 퀴즈 탭 정보", description = "외부인용 CS 퀴즈 탭 관련 API 입니다.")
@@ -23,4 +26,11 @@ public class RandomQuizController {
     public ResponseEntity<RandomTutorialQuizResponse> pickRandomQuiz() {
         return ResponseEntity.ok().body(randomQuizService.pickRandomQuiz());
     }
+
+    @Operation(summary = "외부인용 랜덤 퀴즈 제출 API")
+    @GetMapping("/{randomQuizId}/reply")
+    public ResponseEntity<RandomQuizReplyResponse> replyToRandomQuiz(@PathVariable(name = "randomQuizId") final Long randomQuizId,
+                                                                     @RequestParam(name = "input") Integer input) {
+        return ResponseEntity.ok().body(randomQuizService.replyToRandomQuiz(randomQuizId, input));
+    }
 }

src/main/java/org/cotato/csquiz/api/quiz/dto/RandomQuizReplyRequest.java

@@ -0,0 +1,9 @@
+package org.cotato.csquiz.api.quiz.dto;
+
+import jakarta.validation.constraints.NotNull;
+
+public record RandomQuizReplyRequest(
+        @NotNull
+        Integer input
+) {
+}

src/main/java/org/cotato/csquiz/api/quiz/dto/RandomQuizReplyResponse.java

@@ -0,0 +1,13 @@
+package org.cotato.csquiz.api.quiz.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.media.Schema.RequiredMode;
+
+public record RandomQuizReplyResponse(
+        @Schema(requiredMode = RequiredMode.REQUIRED)
+        boolean result
+) {
+    public static RandomQuizReplyResponse from(Boolean isCorrect) {
+        return new RandomQuizReplyResponse(isCorrect);
+    }
+}

src/main/java/org/cotato/csquiz/common/config/SecurityConfig.java

@@ -36,7 +36,7 @@ public class SecurityConfig {
             "/v2/api/policies",
             "/v2/api/events/**",
             "/v1/api/generation/current",
-            "/v2/api/random-quizzes"
+            "/v2/api/random-quizzes/**"
     };
 
     private final JwtTokenProvider jwtTokenProvider;

src/main/java/org/cotato/csquiz/domain/education/entity/RandomQuiz.java

@@ -56,4 +56,8 @@ public String getImageUrl() {
         }
         return image.getUrl();
     }
+
+    public boolean isCorrect(Integer input) {
+        return answerNumber.equals(input);
+    }
 }

src/main/java/org/cotato/csquiz/domain/education/service/RandomQuizService.java

@@ -1,7 +1,9 @@
 package org.cotato.csquiz.domain.education.service;
 
 import lombok.RequiredArgsConstructor;
+import org.cotato.csquiz.api.quiz.dto.RandomQuizReplyResponse;
 import org.cotato.csquiz.api.quiz.dto.RandomTutorialQuizResponse;
+import org.cotato.csquiz.domain.education.entity.RandomQuiz;
 import org.cotato.csquiz.domain.education.service.component.RandomQuizReader;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -16,4 +18,9 @@ public class RandomQuizService {
     public RandomTutorialQuizResponse pickRandomQuiz() {
         return RandomTutorialQuizResponse.from(randomQuizReader.getRandomQuiz());
     }
+
+    public RandomQuizReplyResponse replyToRandomQuiz(final Long quizId, final Integer input) {
+        RandomQuiz randomQuiz = randomQuizReader.findById(quizId);
+        return RandomQuizReplyResponse.from(randomQuiz.isCorrect(input));
+    }
 }

src/main/java/org/cotato/csquiz/domain/education/service/component/RandomQuizReader.java

@@ -28,4 +28,9 @@ public RandomQuiz getRandomQuiz() {
         Page<RandomQuiz> quizPage = randomQuizRepository.findAll(PageRequest.of(randomPage, 1));
         return quizPage.getContent().get(0);
     }
+
+    public RandomQuiz findById(Long id) {
+        return randomQuizRepository.findById(id)
+                .orElseThrow(() -> new EntityNotFoundException("해당 퀴즈가 존재하지 않습니다."));
+    }
 }