[BOOK-201] feat: apis - 독서기록상세조회 API개발 (#67)

Author: minwoo1999

apis/src/main/kotlin/org/yapp/apis/readingrecord/controller/ReadingRecordController.kt

@@ -41,6 +41,18 @@ class ReadingRecordController(
         return ResponseEntity.status(HttpStatus.CREATED).body(response)
     }
 
+    @GetMapping("/detail/{readingRecordId}")
+    override fun getReadingRecordDetail(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable readingRecordId: UUID
+    ): ResponseEntity<ReadingRecordResponse> {
+        val response = readingRecordUseCase.getReadingRecordDetail(
+            userId = userId,
+            readingRecordId = readingRecordId
+        )
+        return ResponseEntity.ok(response)
+    }
+
     @GetMapping("/{userBookId}")
     override fun getReadingRecords(
         @AuthenticationPrincipal userId: UUID,

apis/src/main/kotlin/org/yapp/apis/readingrecord/controller/ReadingRecordControllerApi.kt

@@ -60,6 +60,30 @@ interface ReadingRecordControllerApi {
         @Valid @RequestBody @Parameter(description = "독서 기록 생성 요청 객체") request: CreateReadingRecordRequest
     ): ResponseEntity<ReadingRecordResponse>
 
+    @Operation(
+        summary = "독서 기록 상세 조회",
+        description = "독서 기록 ID로 독서 기록 상세 정보를 조회합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "독서 기록 상세 조회 성공",
+                content = [Content(schema = Schema(implementation = ReadingRecordResponse::class))]
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "사용자 또는 독서 기록을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @GetMapping("/detail/{readingRecordId}")
+    fun getReadingRecordDetail(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "조회할 독서 기록 ID") readingRecordId: UUID
+    ): ResponseEntity<ReadingRecordResponse>
+
     @Operation(
         summary = "독서 기록 목록 조회",
         description = "사용자의 책에 대한 독서 기록을 페이징하여 조회합니다. 정렬은 페이지 번호 또는 최신 등록순으로 가능합니다."

apis/src/main/kotlin/org/yapp/apis/readingrecord/service/ReadingRecordService.kt

@@ -6,6 +6,8 @@ import org.springframework.stereotype.Service
 import org.yapp.apis.book.service.UserBookService
 import org.yapp.apis.readingrecord.dto.request.CreateReadingRecordRequest
 import org.yapp.apis.readingrecord.dto.response.ReadingRecordResponse
+import org.yapp.apis.readingrecord.exception.ReadingRecordErrorCode
+import org.yapp.apis.readingrecord.exception.ReadingRecordNotFoundException
 import org.yapp.domain.book.BookDomainService
 import org.yapp.domain.readingrecord.ReadingRecordDomainService
 import org.yapp.domain.readingrecord.ReadingRecordSortType
@@ -38,6 +40,20 @@ class ReadingRecordService(
         return ReadingRecordResponse.from(readingRecordInfoVO)
     }
 
+    fun getReadingRecordDetail(
+        userId: UUID,
+        readingRecordId: UUID
+    ): ReadingRecordResponse {
+        val readingRecordInfoVO = readingRecordDomainService.findReadingRecordById(readingRecordId)
+            ?: throw ReadingRecordNotFoundException(
+                ReadingRecordErrorCode.READING_RECORD_NOT_FOUND,
+                "Reading record not found with id: $readingRecordId"
+            )
+
+        userBookService.validateUserBookExists(userId, readingRecordInfoVO.userBookId.value)
+
+        return ReadingRecordResponse.from(readingRecordInfoVO)
+    }
 
     fun getReadingRecordsByDynamicCondition(
         userBookId: UUID,

apis/src/main/kotlin/org/yapp/apis/readingrecord/usecase/ReadingRecordUseCase.kt

@@ -42,6 +42,18 @@ class ReadingRecordUseCase(
         )
     }
 
+    fun getReadingRecordDetail(
+        userId: UUID,
+        readingRecordId: UUID
+    ): ReadingRecordResponse {
+        userAuthService.validateUserExists(userId)
+
+        return readingRecordService.getReadingRecordDetail(
+            userId = userId,
+            readingRecordId = readingRecordId
+        )
+    }
+
     fun getReadingRecordsByUserBookId(
         userId: UUID,
         userBookId: UUID,