내가 푼 테스트 조회 API를 구현한다. (#62)

feat: implement my exam read

Author: earlgrey02

api/src/main/kotlin/com/gotchai/api/presentation/v1/exam/ExamController.kt

@@ -22,6 +22,15 @@ class ExamController(
     fun getExamById(
         @AuthenticationPrincipal
         userId: Long,
-        @PathVariable(name = "id") examId: Long
+        @PathVariable(name = "id")
+        examId: Long
     ): ExamDetailResponse = ExamDetailResponse.from(examQueryUseCase.getExamById(examId))
+
+    @GetMapping("/users/me/exam/solved")
+    fun getMyExams(
+        @AuthenticationPrincipal
+        userId: Long
+    ): ExamListResponse =
+        examQueryUseCase.getExamsByUserId(userId)
+            .let { ExamListResponse.from(it) }
 }

api/src/test/kotlin/com/gotchai/api/presentation/v1/exam/ExamControllerTest.kt

@@ -18,7 +18,6 @@ import com.gotchai.domain.global.exception.NotFoundDataException
 import com.ninjasquad.springmockk.MockkBean
 import io.mockk.every
 import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest
-import org.springframework.restdocs.payload.PayloadDocumentation.responseBody
 import org.springframework.test.web.reactive.server.expectBody
 
 @WebMvcTest(ExamController::class)
@@ -66,6 +65,26 @@ class ExamControllerTest : ControllerTest() {
             }
         }
 
+        describe("getMyExams()는") {
+            val exams =
+                listOf(createExam())
+                    .also {
+                        every { examQueryUseCase.getExamsByUserId(ID) } returns it
+                    }
+
+            it("상태 코드 200과 ExamListResponse를 반환한다.") {
+                webClient.get()
+                    .uri("/api/v1/users/me/exam/solved")
+                    .exchange()
+                    .expectStatus()
+                    .isOk
+                    .expectBody<ApiResponse<ExamListResponse>>()
+                    .document("내가 푼 테스트 조회 성공(200)") {
+                        responseBody(examListResponseFields)
+                    }
+            }
+        }
+
         describe("getExamById()는") {
             context("조회하려는 테스트가 존재하는 경우") {
                 val result = createGetExamResult()

domain/src/main/kotlin/com/gotchai/domain/exam/adapter/in/ExamQueryService.kt

@@ -4,12 +4,14 @@ import com.gotchai.domain.exam.dto.result.GetExamResult
 import com.gotchai.domain.exam.entity.Exam
 import com.gotchai.domain.exam.port.`in`.ExamQueryUseCase
 import com.gotchai.domain.exam.port.out.ExamQueryPort
+import com.gotchai.domain.exam.port.out.ExamResultQueryPort
 import com.gotchai.domain.quiz.port.out.QuizQueryPort
 import org.springframework.stereotype.Service
 
 @Service
 class ExamQueryService(
     private val examQueryPort: ExamQueryPort,
+    private val examResultQueryPort: ExamResultQueryPort,
     private val quizQueryPort: QuizQueryPort
 ) : ExamQueryUseCase {
     override fun getExamById(examId: Long): GetExamResult {
@@ -19,5 +21,12 @@ class ExamQueryService(
         return GetExamResult.of(exam, quizzes.map { it.id })
     }
 
+    override fun getExamsByUserId(userId: Long): List<Exam> {
+        val examResults = examResultQueryPort.getExamResultsByUserId(userId)
+        val exams = examQueryPort.getExamsByInIn(examResults.map { it.id })
+
+        return exams
+    }
+
     override fun getExams(): List<Exam> = examQueryPort.getExams()
 }

domain/src/main/kotlin/com/gotchai/domain/exam/entity/ExamResult.kt

@@ -0,0 +1,17 @@
+package com.gotchai.domain.exam.entity
+
+import java.time.LocalDateTime
+
+data class ExamResult(
+    val id: Long,
+    val examId: Long,
+    val userId: Long,
+    val answerCount: Int,
+    val createdAt: LocalDateTime
+) {
+    data class Creation(
+        val examId: Long,
+        val userId: Long,
+        val answerCount: Int
+    )
+}

domain/src/main/kotlin/com/gotchai/domain/exam/port/in/ExamQueryUseCase.kt

@@ -6,5 +6,7 @@ import com.gotchai.domain.exam.entity.Exam
 interface ExamQueryUseCase {
     fun getExamById(examId: Long): GetExamResult
 
+    fun getExamsByUserId(userId: Long): List<Exam>
+
     fun getExams(): List<Exam>
 }

domain/src/main/kotlin/com/gotchai/domain/exam/port/out/ExamQueryPort.kt

@@ -6,4 +6,6 @@ interface ExamQueryPort {
     fun getExamById(examId: Long): Exam
 
     fun getExams(): List<Exam>
+
+    fun getExamsByInIn(ids: Collection<Long>): List<Exam>
 }

domain/src/main/kotlin/com/gotchai/domain/exam/port/out/ExamResultQueryPort.kt

@@ -0,0 +1,7 @@
+package com.gotchai.domain.exam.port.out
+
+import com.gotchai.domain.exam.entity.ExamResult
+
+interface ExamResultQueryPort {
+    fun getExamResultsByUserId(userId: Long): List<ExamResult>
+}

domain/src/testFixtures/kotlin/com/gotchai/domain/fixture/ExamFixture.kt

@@ -2,15 +2,23 @@ package com.gotchai.domain.fixture
 
 import com.gotchai.domain.exam.dto.result.GetExamResult
 import com.gotchai.domain.exam.entity.Exam
+import com.gotchai.domain.exam.entity.ExamResult
 import java.time.LocalDateTime
 
+const val TITLE = "AI와 크리스마스 파티"
+const val SUB_TITLE = "산타는 누구야?"
+const val DESCRIPTION_IMAGE = "https://gotchai-dev.s3.ap-northeast-2.amazonaws.com/exam/icon/image"
+const val ICON_IMAGE = "https://gotchai-dev.s3.ap-northeast-2.amazonaws.com/exam/description/image"
+const val THEME = "blue"
+const val ANSWER_COUNT = 1
+
 fun createExam(
     id: Long = ID,
-    title: String = "테스트 시험",
-    subTitle: String = "테스트 부제목",
-    descriptionImage: String = "https://example.com/description.jpg",
-    iconImage: String = "https://example.com/icon.jpg",
-    theme: String = "blue",
+    title: String = TITLE,
+    subTitle: String = SUB_TITLE,
+    descriptionImage: String = DESCRIPTION_IMAGE,
+    iconImage: String = ICON_IMAGE,
+    theme: String = THEME,
     createdAt: LocalDateTime = CREATED_AT
 ): Exam =
     Exam(
@@ -23,7 +31,38 @@ fun createExam(
         createdAt = createdAt
     )
 
+fun createExamResult(
+    id: Long = ID,
+    examId: Long = ID,
+    userId: Long = ID,
+    answerCount: Int = ANSWER_COUNT,
+    createdAt: LocalDateTime = CREATED_AT
+): ExamResult =
+    ExamResult(
+        id = id,
+        examId = examId,
+        userId = userId,
+        answerCount = answerCount,
+        createdAt = createdAt
+    )
+
 fun createGetExamResult(
-    exam: Exam = createExam(),
-    quizIds: List<Long> = listOf(1L, 2L, 3L, 4L, 5L, 6L, 7L)
-): GetExamResult = GetExamResult.of(exam, quizIds)
+    id: Long = ID,
+    title: String = TITLE,
+    subTitle: String = SUB_TITLE,
+    descriptionImage: String = DESCRIPTION_IMAGE,
+    iconImage: String = ICON_IMAGE,
+    theme: String = THEME,
+    quizIds: List<Long> = listOf(ID),
+    createdAt: LocalDateTime = CREATED_AT,
+): GetExamResult =
+    GetExamResult(
+        id = id,
+        title = title,
+        subTitle = subTitle,
+        descriptionImage = descriptionImage,
+        iconImage = iconImage,
+        theme = theme,
+        quizIds = quizIds,
+        createdAt = createdAt
+    )

storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/exam/adapter/out/ExamQueryAdapter.kt

@@ -3,11 +3,11 @@ package com.gotchai.storage.rdb.exam.adapter.out
 import com.gotchai.domain.exam.entity.Exam
 import com.gotchai.domain.exam.port.out.ExamQueryPort
 import com.gotchai.storage.rdb.exam.repository.ExamJpaRepository
+import com.gotchai.storage.rdb.global.annotation.Adapter
 import com.gotchai.storage.rdb.global.annotation.ReadOnlyTransactional
 import com.gotchai.storage.rdb.global.util.findByIdOrElseThrow
-import org.springframework.stereotype.Repository
 
-@Repository
+@Adapter
 class ExamQueryAdapter(
     private val examJpaRepository: ExamJpaRepository
 ) : ExamQueryPort {
@@ -16,4 +16,9 @@ class ExamQueryAdapter(
 
     @ReadOnlyTransactional
     override fun getExams(): List<Exam> = examJpaRepository.findAll().map { it.toExam() }
+
+    @ReadOnlyTransactional
+    override fun getExamsByInIn(ids: Collection<Long>): List<Exam> =
+        examJpaRepository.findByIdIn(ids)
+            .map { it.toExam() }
 }

storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/exam/adapter/out/ExamResultQueryAdapter.kt

@@ -0,0 +1,15 @@
+package com.gotchai.storage.rdb.exam.adapter.out
+
+import com.gotchai.domain.exam.entity.ExamResult
+import com.gotchai.domain.exam.port.out.ExamResultQueryPort
+import com.gotchai.storage.rdb.exam.repository.ExamResultJpaRepository
+import com.gotchai.storage.rdb.global.annotation.Adapter
+
+@Adapter
+class ExamResultQueryAdapter(
+    private val examResultJpaRepository: ExamResultJpaRepository
+) : ExamResultQueryPort {
+    override fun getExamResultsByUserId(userId: Long): List<ExamResult> =
+        examResultJpaRepository.findExamResultsByUserId(userId)
+            .map { it.toExamResult() }
+}