feat: 독서기록 API 기능 구현

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/DeleteTokenRequest.kt

@@ -8,7 +8,7 @@ import org.yapp.apis.auth.dto.response.RefreshTokenResponse
     name = "DeleteTokenRequest",
     description = "Request DTO for deleting a refresh token"
 )
-data class DeleteTokenRequest(
+data class DeleteTokenRequest private constructor(
     @field:NotBlank(message = "Refresh token must not be blank.")
     @Schema(description = "Refresh token to be deleted", example = "eyJhbGciOiJIUz...")
     val refreshToken: String? = null

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/FindUserIdentityRequest.kt

@@ -9,7 +9,7 @@ import java.util.*
     name = "FindUserIdentityRequest",
     description = "Request DTO to retrieve user identity information using userId"
 )
-data class FindUserIdentityRequest(
+data class FindUserIdentityRequest private constructor(
     @Schema(
         description = "User ID (UUID format)",
         example = "a1b2c3d4-e5f6-7890-1234-56789abcdef0"

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/TokenGenerateRequest.kt

@@ -9,7 +9,7 @@ import java.util.*
     name = "TokenGenerateRequest",
     description = "DTO containing information required to save the generated refresh token"
 )
-data class TokenGenerateRequest(
+data class TokenGenerateRequest private constructor(
     @field:NotNull(message = "userId must not be null")
     @Schema(description = "User ID", example = "f6b7d490-1b1a-4b9f-8e8e-27f8e3a5dafa")
     val userId: UUID? = null,

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/UserBooksByIsbnsRequest.kt

@@ -9,7 +9,7 @@ import java.util.UUID
     name = "UserBooksByIsbnsRequest",
     description = "Request DTO for finding user books by user ID and a list of ISBNs"
 )
-data class UserBooksByIsbnsRequest(
+data class UserBooksByIsbnsRequest private constructor(
     @Schema(
         description = "사용자 ID",
         example = "1"

apis/src/main/kotlin/org/yapp/apis/book/controller/BookController.kt

@@ -1,7 +1,6 @@
 package org.yapp.apis.book.controller
 
 import jakarta.validation.Valid
-import org.springframework.data.domain.Page
 import org.springframework.data.domain.Pageable
 import org.springframework.data.domain.Sort
 import org.springframework.data.web.PageableDefault
@@ -23,6 +22,7 @@ import org.yapp.apis.book.dto.response.UserBookPageResponse
 import org.yapp.apis.book.dto.response.UserBookResponse
 import org.yapp.apis.book.usecase.BookUseCase
 import org.yapp.domain.userbook.BookStatus
+import org.yapp.domain.userbook.UserBookSortType
 import java.util.UUID
 
 @RestController
@@ -62,7 +62,7 @@ class BookController(
     override fun getUserLibraryBooks(
         @AuthenticationPrincipal userId: UUID,
         @RequestParam(required = false) status: BookStatus?,
-        @RequestParam(required = false) sort: String?,
+        @RequestParam(required = false) sort: UserBookSortType?,
         @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
         pageable: Pageable
     ): ResponseEntity<UserBookPageResponse> {

apis/src/main/kotlin/org/yapp/apis/book/controller/BookControllerApi.kt

@@ -27,6 +27,7 @@ import org.yapp.apis.book.dto.response.BookSearchResponse
 import org.yapp.apis.book.dto.response.UserBookPageResponse
 import org.yapp.apis.book.dto.response.UserBookResponse
 import org.yapp.domain.userbook.BookStatus
+import org.yapp.domain.userbook.UserBookSortType
 import org.yapp.globalutils.exception.ErrorResponse
 import java.util.UUID
 
@@ -140,7 +141,7 @@ interface BookControllerApi {
     fun getUserLibraryBooks(
         @AuthenticationPrincipal userId: UUID,
         @RequestParam(required = false) status: BookStatus?,
-        @RequestParam(required = false) sort: String?,
+        @RequestParam(required = false) sort: UserBookSortType?,
         @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
         pageable: Pageable
     ): ResponseEntity<UserBookPageResponse>

apis/src/main/kotlin/org/yapp/apis/book/dto/request/BookCreateRequest.kt

@@ -22,7 +22,7 @@ data class BookCreateRequest private constructor(
     @field:Size(max = 2048, message = "표지 URL은 2048자 이내여야 합니다.")
     val coverImageUrl: String,
 
-    val description: String? = null,
+    val description: String? = null
 ) {
     fun validIsbn(): String = isbn!!
     fun validTitle(): String = title!!
@@ -42,7 +42,7 @@ data class BookCreateRequest private constructor(
                 publisher = bookDetail.publisher,
                 publicationYear = parsePublicationYear(bookDetail.pubDate),
                 coverImageUrl = bookDetail.cover,
-                description = bookDetail.description
+                description = bookDetail.description,
             )
         }
 

apis/src/main/kotlin/org/yapp/apis/book/dto/request/UpsertUserBookRequest.kt

@@ -1,13 +1,13 @@
 package org.yapp.apis.book.dto.request
 
 import org.yapp.apis.book.dto.response.BookCreateResponse
-import org.yapp.apis.book.dto.response.UserBookResponse
 import org.yapp.domain.userbook.BookStatus
 import java.util.UUID
 
 
 data class UpsertUserBookRequest private constructor(
     val userId: UUID? = null,
+    val bookId: UUID? = null,
     val bookIsbn: String? = null,
     val bookTitle: String? = null,
     val bookAuthor: String? = null,
@@ -16,6 +16,7 @@ data class UpsertUserBookRequest private constructor(
     val status: BookStatus? = null
 ) {
     fun validUserId(): UUID = userId!!
+    fun validBookId(): UUID = bookId!!
     fun validBookIsbn(): String = bookIsbn!!
     fun validBookTitle(): String = bookTitle!!
     fun validBookAuthor(): String = bookAuthor!!
@@ -27,10 +28,11 @@ data class UpsertUserBookRequest private constructor(
         fun of(
             userId: UUID,
             bookCreateResponse: BookCreateResponse,
-            status: BookStatus
+            status: BookStatus,
         ): UpsertUserBookRequest {
             return UpsertUserBookRequest(
                 userId = userId,
+                bookId = bookCreateResponse.bookId,
                 bookIsbn = bookCreateResponse.isbn,
                 bookTitle = bookCreateResponse.title,
                 bookAuthor = bookCreateResponse.author,

apis/src/main/kotlin/org/yapp/apis/book/dto/response/BookCreateResponse.kt

@@ -2,21 +2,25 @@ package org.yapp.apis.book.dto.response
 
 import org.yapp.domain.book.vo.BookInfoVO
 
+import java.util.UUID
+
 data class BookCreateResponse private constructor(
+    val bookId: UUID,
     val isbn: String,
     val title: String,
     val author: String,
     val publisher: String,
-    val coverImageUrl: String
+    val coverImageUrl: String,
 ) {
     companion object {
         fun from(bookVO: BookInfoVO): BookCreateResponse {
             return BookCreateResponse(
+                bookId = bookVO.id.value,
                 isbn = bookVO.isbn.value,
                 title = bookVO.title,
                 author = bookVO.author,
                 publisher = bookVO.publisher,
-                coverImageUrl = bookVO.coverImageUrl
+                coverImageUrl = bookVO.coverImageUrl,
             )
         }
     }

apis/src/main/kotlin/org/yapp/apis/book/dto/response/BookDetailResponse.kt

@@ -25,7 +25,7 @@ data class BookDetailResponse private constructor(
     val cover: String,
     val categoryId: Int?,
     val categoryName: String?,
-    val publisher: String
+    val publisher: String,
 ) {
     companion object {
 

apis/src/main/kotlin/org/yapp/apis/book/dto/response/UserBookPageResponse.kt

@@ -16,7 +16,10 @@ data class UserBookPageResponse private constructor(
     val readingCount: Long,
 
     @Schema(description = "완독한 책 개수")
-    val completedCount: Long
+    val completedCount: Long,
+
+    @Schema(description = "총 책 개수")
+    val totalCount: Long
 ) {
     companion object {
         fun of(
@@ -25,11 +28,13 @@ data class UserBookPageResponse private constructor(
             readingCount: Long,
             completedCount: Long
         ): UserBookPageResponse {
+            val totalCount = beforeReadingCount + readingCount + completedCount
             return UserBookPageResponse(
                 books = books,
                 beforeReadingCount = beforeReadingCount,
                 readingCount = readingCount,
-                completedCount = completedCount
+                completedCount = completedCount,
+                totalCount = totalCount
             )
         }
     }

apis/src/main/kotlin/org/yapp/apis/book/exception/UserBookErrorCode.kt

@@ -0,0 +1,16 @@
+package org.yapp.apis.book.exception
+
+import org.springframework.http.HttpStatus
+import org.yapp.globalutils.exception.BaseErrorCode
+
+enum class UserBookErrorCode(
+    private val status: HttpStatus,
+    private val code: String,
+    private val message: String
+) : BaseErrorCode {
+    USER_BOOK_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_BOOK_001", "사용자의 책을 찾을 수 없습니다.");
+
+    override fun getHttpStatus(): HttpStatus = status
+    override fun getCode(): String = code
+    override fun getMessage(): String = message
+}

apis/src/main/kotlin/org/yapp/apis/book/exception/UserBookNotFoundException.kt

@@ -0,0 +1,8 @@
+package org.yapp.apis.book.exception
+
+import org.yapp.globalutils.exception.CommonException
+
+class UserBookNotFoundException(
+    errorCode: UserBookErrorCode,
+    message: String? = null
+) : CommonException(errorCode, message)

apis/src/main/kotlin/org/yapp/apis/book/service/UserBookService.kt

@@ -7,10 +7,12 @@ import org.yapp.apis.auth.dto.request.UserBooksByIsbnsRequest
 import org.yapp.apis.book.dto.response.UserBookPageResponse
 import org.yapp.apis.book.dto.response.UserBookResponse
 import org.yapp.apis.book.dto.request.UpsertUserBookRequest
+import org.yapp.apis.book.exception.UserBookErrorCode
+import org.yapp.apis.book.exception.UserBookNotFoundException
 import org.yapp.domain.userbook.BookStatus
+import org.yapp.domain.userbook.UserBook
 import org.yapp.domain.userbook.UserBookDomainService
-import org.yapp.domain.userbook.vo.UserBookInfoVO
-import org.yapp.domain.userbook.vo.UserBookStatusCountsVO
+import org.yapp.domain.userbook.UserBookSortType
 import java.util.UUID
 
 
@@ -21,6 +23,7 @@ class UserBookService(
     fun upsertUserBook(upsertUserBookRequest: UpsertUserBookRequest): UserBookResponse {
         val userBookInfoVO = userBookDomainService.upsertUserBook(
             upsertUserBookRequest.validUserId(),
+            upsertUserBookRequest.validBookId(),
             upsertUserBookRequest.validBookIsbn(),
             upsertUserBookRequest.validBookTitle(),
             upsertUserBookRequest.validBookAuthor(),
@@ -31,13 +34,15 @@ class UserBookService(
         return UserBookResponse.from(userBookInfoVO)
     }
 
-    fun findAllUserBooks(userId: UUID): List<UserBookResponse> {
-        val userBooks: List<UserBookInfoVO> = userBookDomainService.findAllUserBooks(userId)
-        return userBooks.map { userBook: UserBookInfoVO ->
-            UserBookResponse.from(userBook)
-        }
+    fun validateUserBookExists(userId: UUID, userBookId: UUID): UserBook {
+        return userBookDomainService.findByIdAndUserId(userBookId, userId)
+            ?: throw UserBookNotFoundException(
+                UserBookErrorCode.USER_BOOK_NOT_FOUND,
+                "User book not found with id: $userBookId and userId: $userId"
+            )
     }
 
+
     fun findAllByUserIdAndBookIsbnIn(userBooksByIsbnsRequest: UserBooksByIsbnsRequest): List<UserBookResponse> {
         val userBooks = userBookDomainService.findAllByUserIdAndBookIsbnIn(
             userBooksByIsbnsRequest.validUserId(),
@@ -49,7 +54,7 @@ class UserBookService(
     private fun findUserBooksByDynamicCondition(
         userId: UUID,
         status: BookStatus?,
-        sort: String?,
+        sort: UserBookSortType?,
         pageable: Pageable
     ): Page<UserBookResponse> {
         val page = userBookDomainService.findUserBooksByDynamicCondition(userId, status, sort, pageable)
@@ -59,7 +64,7 @@ class UserBookService(
     fun findUserBooksByDynamicConditionWithStatusCounts(
         userId: UUID,
         status: BookStatus?,
-        sort: String?,
+        sort: UserBookSortType?,
         pageable: Pageable
     ): UserBookPageResponse {
         val userBookResponsePage = findUserBooksByDynamicCondition(userId, status, sort, pageable)

apis/src/main/kotlin/org/yapp/apis/book/usecase/BookUseCase.kt

@@ -20,6 +20,7 @@ import org.yapp.apis.book.service.BookManagementService
 import org.yapp.apis.book.service.BookQueryService
 import org.yapp.apis.book.service.UserBookService
 import org.yapp.domain.userbook.BookStatus
+import org.yapp.domain.userbook.UserBookSortType
 import org.yapp.globalutils.annotation.UseCase
 import java.util.UUID
 
@@ -63,7 +64,7 @@ class BookUseCase(
         val upsertUserBookRequest = UpsertUserBookRequest.of(
             userId = userId,
             bookCreateResponse,
-            status = request.bookStatus
+            status = request.bookStatus,
         )
         val userBookResponse = userBookService.upsertUserBook(upsertUserBookRequest)
 
@@ -73,7 +74,7 @@ class BookUseCase(
     fun getUserLibraryBooks(
         userId: UUID,
         status: BookStatus?,
-        sort: String?,
+        sort: UserBookSortType?,
         pageable: Pageable
     ): UserBookPageResponse {
         userAuthService.validateUserExists(userId)

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

@@ -0,0 +1,60 @@
+package org.yapp.apis.readingrecord.controller
+
+import org.springframework.data.domain.Page
+import org.springframework.data.domain.Pageable
+import org.springframework.data.domain.Sort
+import org.springframework.data.web.PageableDefault
+import org.springframework.http.HttpStatus
+import org.springframework.http.ResponseEntity
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.springframework.web.bind.annotation.RestController
+import org.yapp.apis.readingrecord.dto.request.CreateReadingRecordRequest
+import org.yapp.apis.readingrecord.dto.response.ReadingRecordResponse
+import org.yapp.apis.readingrecord.usecase.ReadingRecordUseCase
+import org.yapp.domain.readingrecord.ReadingRecordSortType
+import java.util.UUID
+import jakarta.validation.Valid
+
+@RestController
+@RequestMapping("/api/v1/reading-records")
+class ReadingRecordController(
+    private val readingRecordUseCase: ReadingRecordUseCase
+) : ReadingRecordControllerApi {
+
+    @PostMapping("/{userBookId}")
+    override fun createReadingRecord(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable userBookId: UUID,
+        @Valid @RequestBody request: CreateReadingRecordRequest
+    ): ResponseEntity<ReadingRecordResponse> {
+        val response = readingRecordUseCase.createReadingRecord(
+            userId = userId,
+            userBookId = userBookId,
+            request = request
+        )
+        return ResponseEntity.status(HttpStatus.CREATED).body(response)
+    }
+
+    @GetMapping("/{userBookId}")
+    override fun getReadingRecords(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable userBookId: UUID,
+        @RequestParam(required = false) sort: ReadingRecordSortType?,
+        @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
+        pageable: Pageable
+    ): ResponseEntity<Page<ReadingRecordResponse>> {
+        val response = readingRecordUseCase.getReadingRecordsByUserBookId(
+            userId = userId,
+            userBookId = userBookId,
+            sort = sort,
+            pageable = pageable
+        )
+        return ResponseEntity.ok(response)
+    }
+}