feat: 도서 상세 화면 개편

src/Projects/BKCore/Sources/Extension/Optional.swift

@@ -0,0 +1,10 @@
+// Copyright © 2026 Booket. All rights reserved
+
+import UIKit
+
+public extension Optional where Wrapped == Int {
+    /// Int? 값을 "123p" 또는 값이 없을 경우 "-p" 문자열로 반환합니다.
+    var toPageString: String {
+        return self.map { "\($0)p" } ?? "-p"
+    }
+}

src/Projects/BKData/Sources/API/RecordAPI.swift

@@ -14,7 +14,12 @@ enum RecordAPI {
 
 extension RecordAPI: RequestTarget {
     var baseURL: String {
-        return "\(APIConfig.baseURL)/reading-records"
+        switch self {
+        case .fetch, .seed:
+            return "\(APIConfig.baseV2URL)/reading-records"
+        default:
+            return "\(APIConfig.baseURL)/reading-records"
+        }
     }
 
     var path: String {

src/Projects/BKData/Sources/Constant/APIConfig.swift

@@ -13,4 +13,11 @@ enum APIConfig {
         }
         return value
     }()
+
+    static let baseV2URL: String = {
+        guard let value = bundle.object(forInfoDictionaryKey: "BASE_API_V2_URL") as? String else {
+            fatalError("Can't load environment: BKData.BASE_API_V2_URL")
+        }
+        return value
+    }()
 }

src/Projects/BKData/Sources/DTO/Response/DetailRecordResponseDTO.swift

@@ -36,3 +36,39 @@ extension DetailRecordResponseDTO {
         )
     }
 }
+
+// api-v2
+public struct DetailRecordV2ResponseDTO: Decodable {
+    public let id: String
+    public let userBookId: String
+    public let pageNumber: Int
+    public let quote: String
+    public let review: String?
+    public let primaryEmotion: PrimaryEmotionResponseDTO
+    public let detailEmotions: [DetailEmotionResponseDTO?]
+    public let createdAt: String
+    public let updatedAt: String
+    public let bookTitle: String
+    public let bookPublisher: String
+    public let bookCoverImageUrl: URL
+    public let author: String
+}
+
+extension DetailRecordV2ResponseDTO {
+    func toRecordInfo() -> RecordInfo {
+        return RecordInfo(
+            recordId: id,
+            bookId: userBookId,
+            pageNumber: pageNumber,
+            quote: quote,
+            review: review,
+            emotionTags: [primaryEmotion.displayName],
+            createdAt: DateParser.parseISO8601(createdAt) ?? .distantPast,
+            updatedAt: DateParser.parseISO8601(updatedAt),
+            bookTitle: bookTitle,
+            bookPublisher: bookPublisher,
+            bookCoverImageUrl: bookCoverImageUrl,
+            author: author
+        )
+    }
+}

src/Projects/BKData/Sources/DTO/Response/FetchRecordResponseDTO.swift

@@ -3,7 +3,8 @@
 import BKDomain
 
 struct FetchRecordResponseDTO: Decodable {
-    let readingRecords: [DetailRecordResponseDTO]
+    let readingRecords: [DetailRecordV2ResponseDTO]
     let lastPage: Bool
     let totalResults: Int
+    let representativeEmotion: PrimaryEmotionResponseDTO?
 }

src/Projects/BKData/Sources/DTO/Response/PrimaryEmotionResponseDTO.swift

@@ -0,0 +1,13 @@
+// Copyright © 2026 Booket. All rights reserved
+
+import BKDomain
+
+public struct PrimaryEmotionResponseDTO: Decodable {
+    let code: String
+    let displayName: Emotion
+}
+
+public struct DetailEmotionResponseDTO: Decodable {
+    let id: String
+    let name: String
+}

src/Projects/BKData/Sources/Repository/DefaultRecordRepository.swift

@@ -33,7 +33,7 @@ public final class DefaultRecordRepository: RecordRepository {
         bookId: String,
         sortType: LibrarySortType,
         page: Int
-    ) -> AnyPublisher<(infos: [RecordInfo], hasMore: Bool, totalCount: Int), DomainError> {
+    ) -> AnyPublisher<RecordFetchResult, DomainError> {
         networkProvider.request(
             target: RecordAPI.fetch(
                 userBookId: bookId,
@@ -46,7 +46,14 @@ public final class DefaultRecordRepository: RecordRepository {
         )
         .mapError { $0.toDomainError() }
         .debugError(logger: AppLogger.network)
-        .map { ($0.readingRecords.map { $0.toRecordInfo() }, !$0.lastPage, $0.totalResults) }
+        .map {
+            RecordFetchResult(
+                infos: $0.readingRecords.map { $0.toRecordInfo() },
+                hasMore: !$0.lastPage,
+                totalCount: $0.totalResults,
+                mainEmotion: $0.representativeEmotion?.displayName
+            )
+        }
         .eraseToAnyPublisher()
     }
 

src/Projects/BKDesign/Sources/Extensions/UIColor+.swift

@@ -127,6 +127,19 @@ public extension UIColor {
         }
     }
 
+    static func bkEmotionGraphTintColor(
+        _ semanticColor: BKSemanticColor.EmotionGraphTint
+    ) -> UIColor {
+        return UIColor { traitCollection in
+            switch traitCollection.userInterfaceStyle {
+            case .dark:
+                return semanticColor.resolve(for: .light)
+            default:
+                return semanticColor.resolve(for: .light)
+            }
+        }
+    }
+
     static func bkShadowColor(
         _ semanticColor: BKSemanticColor.Shadow
     ) -> UIColor {

src/Projects/BKDesign/Sources/Foundation/ColorSystem/BKAtomicColor.swift

@@ -89,16 +89,50 @@ public enum BKAtomicColor {
 
     // Blue Palette
     public enum Blue: String {
-        case b50 = "#e3f4ff"
-        case b100 = "#bbe2ff"
-        case b200 = "#8dd0ff"
-        case b300 = "#56bdff"
-        case b400 = "#1dadff"
-        case b500 = "#009eff"
-        case b600 = "#008fff"
-        case b700 = "#007bff"
-        case b800 = "#1269ec"
-        case b900 = "#1f47cd"
+        case b50 = "#EBF3FF"
+        case b100 = "#C0D8FF"
+        case b200 = "#94BDFF"
+        case b300 = "#68A3FF"
+        case b400 = "#3C88FF"
+        case b500 = "#2A74E9"
+        case b600 = "#195CC7"
+        case b700 = "#0B47A5"
+        case b800 = "#013383"
+        case b900 = "#002661"
+
+        public var color: UIColor {
+            return UIColor(hex: self.rawValue)
+        }
+    }
+
+    public enum Orange: String {
+        case o50 = "#FFF1EB"
+        case o100 = "#FFD2BE"
+        case o200 = "#FFB392"
+        case o300 = "#FF9365"
+        case o400 = "#EF6D35"
+        case o500 = "#CD5622"
+        case o600 = "#AB4114"
+        case o700 = "#892F08"
+        case o800 = "#672001"
+        case o900 = "#451500"
+
+        public var color: UIColor {
+            return UIColor(hex: self.rawValue)
+        }
+    }
+
+    public enum Violet: String {
+        case v50 = "#F7F0FF"
+        case v100 = "#E6CEFF"
+        case v200 = "#D4ADFF"
+        case v300 = "#C38CFF"
+        case v400 = "#B26AFF"
+        case v500 = "#9A55E4"
+        case v600 = "#7F40C2"
+        case v700 = "#652EA0"
+        case v800 = "#4C1E7E"
+        case v900 = "#36125C"
 
         public var color: UIColor {
             return UIColor(hex: self.rawValue)

src/Projects/BKDesign/Sources/Foundation/ColorSystem/BKSemanticColor.swift

@@ -129,22 +129,24 @@ public enum BKSemanticColor {
         case joy
         case insight
         case sadness
+        case etc
 
         public func resolve(for mode: BKColorMode) -> UIColor {
             switch mode {
             case .light:
                 switch self {
-                case .warmth: return UIColor(hex: "#E3931B")
-                case .joy: return UIColor(hex: "#EE6B33")
-                case .insight: return UIColor(hex: "#9A55E4")
-                case .sadness: return UIColor(hex: "#2872E9")
+                case .warmth: return BKAtomicColor.Yellow.y700.color
+                case .joy: return BKAtomicColor.Orange.o400.color
+                case .insight: return BKAtomicColor.Violet.v500.color
+                case .sadness: return BKAtomicColor.Blue.b500.color
+                case .etc: return .bkContentColor(.secondary)
                 }
             // case .dark:
                 // switch self { /* dark mode colors */ }
             }
         }
     }
-
+    
     public enum EmotionBase {
         case warmth
         case joy
@@ -166,6 +168,29 @@ public enum BKSemanticColor {
         }
     }
 
+    public enum EmotionGraphTint {
+        case warmth
+        case joy
+        case insight
+        case sadness
+        case etc
+
+        public func resolve(for mode: BKColorMode) -> UIColor {
+            switch mode {
+            case .light:
+                switch self {
+                case .warmth: return BKAtomicColor.Yellow.y300.color
+                case .joy: return BKAtomicColor.Orange.o300.color
+                case .insight: return BKAtomicColor.Violet.v300.color
+                case .sadness: return BKAtomicColor.Blue.b300.color
+                case .etc: return BKAtomicColor.Neutral.n300.color
+                }
+            // case .dark:
+                // switch self { /* dark mode colors */ }
+            }
+        }
+    }
+
     public enum Shadow {
         case primary
 

src/Projects/BKDomain/Sources/Entity/Emotion.swift

@@ -5,4 +5,5 @@ public enum Emotion: String, CaseIterable, Decodable {
     case joy = "즐거움"
     case sad = "슬픔"
     case insight = "깨달음"
+    case etc = "기타"
 }

src/Projects/BKDomain/Sources/Entity/RecordFetchResult.swift

@@ -0,0 +1,22 @@
+// Copyright © 2026 Booket. All rights reserved
+
+import Foundation
+
+public struct RecordFetchResult {
+    public let infos: [RecordInfo]
+    public let hasMore: Bool
+    public let totalCount: Int
+    public let mainEmotion: Emotion?
+
+    public init(
+        infos: [RecordInfo],
+        hasMore: Bool,
+        totalCount: Int,
+        mainEmotion: Emotion?
+    ) {
+        self.infos = infos
+        self.hasMore = hasMore
+        self.totalCount = totalCount
+        self.mainEmotion = mainEmotion
+    }
+}

src/Projects/BKDomain/Sources/Interface/Repository/RecordRepository.swift

@@ -13,7 +13,7 @@ public protocol RecordRepository {
         bookId: String,
         sortType: LibrarySortType,
         page: Int
-    ) -> AnyPublisher<(infos: [RecordInfo], hasMore: Bool, totalCount: Int), DomainError>
+    ) -> AnyPublisher<RecordFetchResult, DomainError>
 
     func findBy(
         id recordId: String

src/Projects/BKDomain/Sources/Interface/Usecase/FetchRecordsUseCase.swift

@@ -6,5 +6,5 @@ public protocol FetchRecordsUseCase {
     func execute(
         id: String,
         page: Int
-    ) -> AnyPublisher<(infos: [RecordInfo], hasMore: Bool, totalCount: Int), DomainError>
+    ) -> AnyPublisher<RecordFetchResult, DomainError>
 }

src/Projects/BKDomain/Sources/UseCase/DefaultFetchRecordsUseCase.swift

@@ -12,7 +12,7 @@ public struct DefaultFetchRecordsUseCase: FetchRecordsUseCase {
     public func execute(
         id: String,
         page: Int
-    ) -> AnyPublisher<(infos: [RecordInfo], hasMore: Bool, totalCount: Int), DomainError> {
+    ) -> AnyPublisher<RecordFetchResult, DomainError> {
         repository.fetch(
             bookId: id,
             sortType: .pageNumberDesc,

src/Projects/BKPresentation/Sources/MainFlow/BookDetail/Models/BookDetailItem.swift

@@ -14,7 +14,7 @@ struct BookDetailItem: Hashable {
     /// 감정
     let emotion: EmotionSeed?
     let createdAt: Date
-    let page: Int
+    let page: Int?
     let bookTitle: String
 
     static func from(recordInfo: RecordInfo) -> Self {