feat: 홈 화면 도서 선별 로직 구현

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

@@ -8,17 +8,12 @@ import io.swagger.v3.oas.annotations.responses.ApiResponse
 import io.swagger.v3.oas.annotations.responses.ApiResponses
 import io.swagger.v3.oas.annotations.tags.Tag
 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
 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.PutMapping
-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.*
 import org.yapp.apis.book.dto.request.BookDetailRequest
 import org.yapp.apis.book.dto.request.BookSearchRequest
 import org.yapp.apis.book.dto.request.UserBookRegisterRequest
@@ -29,7 +24,7 @@ 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
+import java.util.*
 
 
 @Tag(name = "Books", description = "도서 정보를 조회하는 API")
@@ -146,5 +141,4 @@ interface BookControllerApi {
         @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
         pageable: Pageable
     ): ResponseEntity<UserBookPageResponse>
-
 }

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

@@ -4,17 +4,16 @@ import org.springframework.data.domain.Page
 import org.springframework.data.domain.Pageable
 import org.springframework.stereotype.Service
 import org.yapp.apis.auth.dto.request.UserBooksByIsbnsRequest
+import org.yapp.apis.book.dto.request.UpsertUserBookRequest
 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.UserBookSortType
-import java.util.UUID
-
+import java.util.*
 
 @Service
 class UserBookService(
@@ -42,7 +41,6 @@ class UserBookService(
             )
     }
 
-
     fun findAllByUserIdAndBookIsbnIn(userBooksByIsbnsRequest: UserBooksByIsbnsRequest): List<UserBookResponse> {
         val userBooks = userBookDomainService.findAllByUserIdAndBookIsbnIn(
             userBooksByIsbnsRequest.validUserId(),
@@ -51,6 +49,8 @@ class UserBookService(
         return userBooks.map { UserBookResponse.from(it) }
     }
 
+
+
     private fun findUserBooksByDynamicCondition(
         userId: UUID,
         status: BookStatus?,

apis/src/main/kotlin/org/yapp/apis/home/controller/HomeController.kt

@@ -0,0 +1,31 @@
+package org.yapp.apis.home.controller
+
+import jakarta.validation.constraints.Max
+import jakarta.validation.constraints.Min
+import org.springframework.http.ResponseEntity
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.GetMapping
+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.home.dto.response.UserHomeResponse
+import org.yapp.apis.home.usecase.HomeUseCase
+import java.util.*
+
+@Validated
+@RestController
+@RequestMapping("/api/home")
+class HomeController(
+    private val homeUseCase: HomeUseCase
+) : HomeControllerApi {
+
+    @GetMapping
+    override fun getUserHomeData(
+        @AuthenticationPrincipal userId: UUID,
+        @RequestParam(defaultValue = "3") @Min(1) @Max(10) limit: Int
+    ): ResponseEntity<UserHomeResponse> {
+        val homeData = homeUseCase.getUserHomeData(userId, limit)
+        return ResponseEntity.ok(homeData)
+    }
+}

apis/src/main/kotlin/org/yapp/apis/home/controller/HomeControllerApi.kt

@@ -0,0 +1,57 @@
+package org.yapp.apis.home.controller
+
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.Parameter
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.responses.ApiResponses
+import io.swagger.v3.oas.annotations.tags.Tag
+import jakarta.validation.constraints.Max
+import jakarta.validation.constraints.Min
+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.RequestMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.yapp.apis.home.dto.response.UserHomeResponse
+import org.yapp.globalutils.exception.ErrorResponse
+import java.util.*
+
+@Tag(name = "Home", description = "홈 화면 관련 API")
+@RequestMapping("/api/home")
+interface HomeControllerApi {
+
+    @Operation(
+        summary = "홈 화면 데이터 조회",
+        description = "사용자의 홈 화면에 필요한 데이터를 조회합니다. 요즘 읽는 책 목록을 우선순위에 따라 최대 limit개까지 반환합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "홈 화면 데이터 조회 성공",
+                content = [Content(schema = Schema(implementation = UserHomeResponse::class))]
+            ),
+            ApiResponse(
+                responseCode = "400",
+                description = "잘못된 요청",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "사용자를 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @GetMapping
+    fun getUserHomeData(
+        @AuthenticationPrincipal userId: UUID,
+        @Parameter(
+            description = "조회할 최대 도서 수 (기본값: 3, 최대: 10)",
+            example = "3"
+        )
+        @RequestParam(defaultValue = "3") @Min(1) @Max(10) limit: Int
+    ): ResponseEntity<UserHomeResponse>
+} 

apis/src/main/kotlin/org/yapp/apis/home/dto/response/UserHomeResponse.kt

@@ -0,0 +1,41 @@
+package org.yapp.apis.home.dto.response
+
+import org.yapp.domain.userbook.vo.HomeBookVO
+import java.time.LocalDateTime
+import java.util.*
+
+data class UserHomeResponse private constructor(
+    val recentBooks: List<RecentBookResponse>
+) {
+    data class RecentBookResponse(
+        val userBookId: UUID,
+        val title: String,
+        val author: String,
+        val publisher: String,
+        val coverImageUrl: String,
+        val lastRecordedAt: LocalDateTime,
+        val recordCount: Int
+    ) {
+        companion object {
+            fun from(userBookInfo: HomeBookVO): RecentBookResponse {
+                return RecentBookResponse(
+                    userBookId = userBookInfo.id.value,
+                    title = userBookInfo.title,
+                    author = userBookInfo.author,
+                    publisher = userBookInfo.publisher,
+                    coverImageUrl = userBookInfo.coverImageUrl,
+                    lastRecordedAt = userBookInfo.lastRecordedAt,
+                    recordCount = userBookInfo.recordCount
+                )
+            }
+        }
+    }
+
+    companion object {
+        fun from(recentBooks: List<HomeBookVO>): UserHomeResponse {
+            return UserHomeResponse(
+                recentBooks = recentBooks.map { RecentBookResponse.from(it) }
+            )
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/home/service/HomeService.kt

@@ -0,0 +1,36 @@
+package org.yapp.apis.home.service
+
+import org.springframework.stereotype.Service
+import org.yapp.apis.home.dto.response.UserHomeResponse
+import org.yapp.domain.userbook.UserBookDomainService
+import org.yapp.domain.userbook.vo.HomeBookVO
+import java.util.*
+
+@Service
+class HomeService(
+    private val userBookDomainService: UserBookDomainService
+) {
+    fun getUserHomeData(userId: UUID, limit: Int): UserHomeResponse {
+        val selectedBooks = selectBooksForHome(userId, limit)
+        return UserHomeResponse.from(selectedBooks)
+    }
+
+    private fun selectBooksForHome(userId: UUID, limit: Int): List<HomeBookVO> {
+        val booksWithRecords = userBookDomainService.findBooksWithRecordsOrderByLatest(userId)
+
+        if (booksWithRecords.size >= limit) {
+            return booksWithRecords.take(limit)
+        }
+
+        val neededCount = limit - booksWithRecords.size
+        val excludedBookIds = booksWithRecords.map { it.id.value }.toSet()
+
+        val booksWithoutRecords = userBookDomainService.findBooksWithoutRecordsByStatusPriority(
+            userId,
+            neededCount,
+            excludedBookIds
+        )
+
+        return booksWithRecords + booksWithoutRecords
+    }
+} 

apis/src/main/kotlin/org/yapp/apis/home/usecase/HomeUseCase.kt

@@ -0,0 +1,18 @@
+package org.yapp.apis.home.usecase
+
+import org.springframework.transaction.annotation.Transactional
+import org.yapp.apis.home.service.HomeService
+import org.yapp.apis.home.dto.response.*
+import org.yapp.globalutils.annotation.UseCase
+import java.util.*
+
+@UseCase
+@Transactional(readOnly = true)
+class HomeUseCase(
+    private val homeService: HomeService
+) {
+    fun getUserHomeData(userId: UUID, limit: Int = 3): UserHomeResponse {
+        val validatedLimit = limit.coerceIn(1, 10)
+        return homeService.getUserHomeData(userId, validatedLimit)
+    }
+}

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

@@ -6,17 +6,15 @@ 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.domain.book.BookDomainService
 import org.yapp.domain.readingrecord.ReadingRecordDomainService
 import org.yapp.domain.readingrecord.ReadingRecordSortType
-import java.util.UUID
+import java.util.*
 
 
 @Service
 class ReadingRecordService(
     private val readingRecordDomainService: ReadingRecordDomainService,
     private val userBookService: UserBookService,
-    private val bookDomainService: BookDomainService
 ) {
 
     fun createReadingRecord(
@@ -26,7 +24,6 @@ class ReadingRecordService(
     ): ReadingRecordResponse {
         userBookService.validateUserBookExists(userId, userBookId)
 
-
         val readingRecordInfoVO = readingRecordDomainService.createReadingRecord(
             userBookId = userBookId,
             pageNumber = request.validPageNumber(),

apis/src/main/resources/static/kakao-login.html

@@ -121,7 +121,7 @@ <h1 style="text-align:center">소셜 로그인 테스트</h1>
                 fetch(`${API_SERVER}/api/v1/auth/signin`, {
                     method: 'POST',
                     headers: {'Content-Type': 'application/json'},
-                    body: JSON.stringify({providerType: "KAKAO", accessToken})
+                    body: JSON.stringify({providerType: "KAKAO", oauthToken: accessToken})
                 })
                     .then(res => res.json())
                     .then(data => {

domain/src/main/kotlin/org/yapp/domain/readingrecord/ReadingRecord.kt

@@ -15,8 +15,6 @@ data class ReadingRecord private constructor(
     val updatedAt: LocalDateTime? = null,
     val deletedAt: LocalDateTime? = null,
 ) {
-
-
     companion object {
         fun create(
             userBookId: UUID,

domain/src/main/kotlin/org/yapp/domain/userbook/UserBookDomainService.kt

@@ -2,10 +2,11 @@ package org.yapp.domain.userbook
 
 import org.springframework.data.domain.Page
 import org.springframework.data.domain.Pageable
+import org.yapp.domain.userbook.vo.HomeBookVO
 import org.yapp.domain.userbook.vo.UserBookInfoVO
 import org.yapp.domain.userbook.vo.UserBookStatusCountsVO
 import org.yapp.globalutils.annotation.DomainService
-import java.util.UUID
+import java.util.*
 
 @DomainService
 class UserBookDomainService(
@@ -70,4 +71,36 @@ class UserBookDomainService(
     fun findByIdAndUserId(userBookId: UUID, userId: UUID): UserBook? {
         return userBookRepository.findByIdAndUserId(userBookId, userId)
     }
+
+    fun findBooksWithRecordsOrderByLatest(userId: UUID): List<HomeBookVO> {
+        val resultTriples = userBookRepository.findRecordedBooksSortedByRecency(userId)
+
+        return resultTriples.map { (userBook, lastRecordedAt, recordCount) ->
+            HomeBookVO.newInstance(
+                userBook = userBook,
+                lastRecordedAt = lastRecordedAt,
+                recordCount = recordCount.toInt()
+            )
+        }
+    }
+
+    fun findBooksWithoutRecordsByStatusPriority(
+        userId: UUID,
+        limit: Int,
+        excludeIds: Set<UUID>
+    ): List<HomeBookVO> {
+        val userBooks = userBookRepository.findUnrecordedBooksSortedByPriority(
+            userId,
+            limit,
+            excludeIds
+        )
+
+        return userBooks.map { userBook ->
+            HomeBookVO.newInstance(
+                userBook = userBook,
+                lastRecordedAt = userBook.updatedAt ?: throw IllegalStateException("UserBook의 updatedAt이 null입니다: ${userBook.id}"),
+                recordCount = 0
+            )
+        }
+    }
 }

domain/src/main/kotlin/org/yapp/domain/userbook/UserBookRepository.kt

@@ -2,7 +2,8 @@ package org.yapp.domain.userbook
 
 import org.springframework.data.domain.Page
 import org.springframework.data.domain.Pageable
-import java.util.UUID
+import java.time.LocalDateTime
+import java.util.*
 
 
 interface UserBookRepository {
@@ -28,4 +29,11 @@ interface UserBookRepository {
 
     fun countUserBooksByStatus(userId: UUID, status: BookStatus): Long
 
+    fun findRecordedBooksSortedByRecency(userId: UUID): List<Triple<UserBook, LocalDateTime, Long>>
+
+    fun findUnrecordedBooksSortedByPriority(
+        userId: UUID,
+        limit: Int,
+        excludeIds: Set<UUID>
+    ): List<UserBook>
 }