feat: 기록 상세 화면 감정 표시 개편

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

@@ -16,7 +16,7 @@ public enum AuthAPI {
 
 extension AuthAPI: RequestTarget {
     public var baseURL: String {
-        return "\(APIConfig.baseURL)/auth"
+        return "\(APIConfig.baseURLv1)/auth"
     }
 
     public var path: String {

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

@@ -14,7 +14,7 @@ enum BookAPI {
 
 extension BookAPI: RequestTarget {
     var baseURL: String {
-        return "\(APIConfig.baseURL)/books"
+        return "\(APIConfig.baseURLv1)/books"
     }
 
     var path: String {

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

@@ -0,0 +1,41 @@
+// Copyright © 2025 Booket. All rights reserved
+
+import Foundation
+
+enum EmotionAPI {
+    case fetchEmotions
+}
+
+extension EmotionAPI: RequestTarget {
+    var baseURL: String {
+        return "\(APIConfig.baseURLv2)/emotions"
+    }
+
+    var path: String {
+        switch self {
+        case .fetchEmotions:
+            return ""
+        }
+    }
+
+    var method: HTTPMethod {
+        switch self {
+        case .fetchEmotions:
+            return .get
+        }
+    }
+
+    var headers: [String: String] {
+        return [
+            "Content-Type": "application/json"
+        ]
+    }
+
+    var body: Encodable? {
+        return nil
+    }
+
+    var query: [String: Any] {
+        return [:]
+    }
+}

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

@@ -8,7 +8,7 @@ enum HomeAPI {
 
 extension HomeAPI: RequestTarget {
     var baseURL: String {
-        return "\(APIConfig.baseURL)/home"
+        return "\(APIConfig.baseURLv1)/home"
     }
 
     var path: String {

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

@@ -14,12 +14,7 @@ enum RecordAPI {
 
 extension RecordAPI: RequestTarget {
     var baseURL: String {
-        switch self {
-        case .fetch, .seed:
-            return "\(APIConfig.baseV2URL)/reading-records"
-        default:
-            return "\(APIConfig.baseURL)/reading-records"
-        }
+        return "\(APIConfig.baseURLv2)/reading-records"
     }
 
     var path: String {
@@ -46,7 +41,7 @@ extension RecordAPI: RequestTarget {
         case .fetch, .detail, .seed:
             return .get
         case .patch:
-            return .patch
+            return .put  // V2 API uses PUT instead of PATCH
         case .delete:
             return .delete
         }

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

@@ -11,7 +11,7 @@ enum UserAPI {
 
 extension UserAPI: RequestTarget {
     var baseURL: String {
-        return "\(APIConfig.baseURL)/users/me"
+        return "\(APIConfig.baseURLv1)/users/me"
     }
 
     var path: String {

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

@@ -6,18 +6,22 @@ private final class BKDataBundleToken {}
 
 enum APIConfig {
     private static let bundle = Bundle(for: BKDataBundleToken.self)
-
-    static let baseURL: String = {
+
+    /// API Base URL (xcconfig에서 /api까지만 포함)
+    private static let baseURL: String = {
         guard let value = bundle.object(forInfoDictionaryKey: "BASE_API_URL") as? String else {
             fatalError("Can't load environment: BKData.BASE_API_URL")
         }
         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
+
+    /// V1 API Base URL (auth, books, users, home)
+    static let baseURLv1: String = {
+        return baseURL + "/v1"
+    }()
+
+    /// V2 API Base URL (emotions, reading-records)
+    static let baseURLv2: String = {
+        return baseURL + "/v2"
     }()
 }

src/Projects/BKData/Sources/DTO/Request/InsertRecordRequestDTO.swift

@@ -4,29 +4,33 @@ import BKDomain
 import Foundation
 
 struct InsertRecordRequestDTO: Encodable {
-    let pageNumber: Int
+    let pageNumber: Int?
     let quote: String
     let review: String?
-    let emotionTags: [String]
-
+    let primaryEmotion: String
+    let detailEmotionTagIds: [String]
+
     init(
-        pageNumber: Int,
+        pageNumber: Int?,
         quote: String,
         review: String?,
-        emotionTags: [String]
+        primaryEmotion: String,
+        detailEmotionTagIds: [String]
     ) {
         self.pageNumber = pageNumber
         self.quote = quote
         self.review = review
-        self.emotionTags = emotionTags
+        self.primaryEmotion = primaryEmotion
+        self.detailEmotionTagIds = detailEmotionTagIds
     }
-    
+
     init(data: RecordVO) {
         self.init(
             pageNumber: data.pageNumber,
             quote: data.quote,
-            review: data.review,
-            emotionTags: data.emotionTags
+            review: data.memo,
+            primaryEmotion: data.primaryEmotion.rawValue,
+            detailEmotionTagIds: data.detailEmotionIds
         )
     }
 }

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

@@ -3,19 +3,20 @@
 import BKDomain
 import Foundation
 
-public struct DetailRecordResponseDTO: Decodable {
-    public let id: String
-    public let userBookId: String
-    public let pageNumber: Int
-    public let quote: String
-    public let review: String?
-    public let emotionTags: [Emotion]
-    public let createdAt: String
-    public let updatedAt: String
-    public let bookTitle: String
-    public let bookPublisher: String
-    public let bookCoverImageUrl: URL
-    public let author: String
+struct DetailRecordResponseDTO: Decodable {
+    let id: String
+    let userBookId: String
+    let pageNumber: Int?
+    let quote: String
+    let review: String?
+    let primaryEmotion: PrimaryEmotionDTO
+    let detailEmotions: [DetailEmotionDTO]
+    let createdAt: String
+    let updatedAt: String
+    let bookTitle: String
+    let bookPublisher: String
+    let bookCoverImageUrl: URL
+    let author: String
 }
 
 extension DetailRecordResponseDTO {
@@ -26,7 +27,8 @@ extension DetailRecordResponseDTO {
             pageNumber: pageNumber,
             quote: quote,
             review: review,
-            emotionTags: emotionTags,
+            primaryEmotion: primaryEmotion.toDomain() ?? .other,
+            detailEmotions: detailEmotions.map { $0.toDomain() },
             createdAt: DateParser.parseISO8601(createdAt) ?? .distantPast,
             updatedAt: DateParser.parseISO8601(updatedAt),
             bookTitle: bookTitle,
@@ -41,11 +43,11 @@ extension DetailRecordResponseDTO {
 public struct DetailRecordV2ResponseDTO: Decodable {
     public let id: String
     public let userBookId: String
-    public let pageNumber: Int
+    public let pageNumber: Int?
     public let quote: String
     public let review: String?
     public let primaryEmotion: PrimaryEmotionResponseDTO
-    public let detailEmotions: [DetailEmotionResponseDTO?]
+    public let detailEmotions: [DetailEmotionResponseDTO]
     public let createdAt: String
     public let updatedAt: String
     public let bookTitle: String
@@ -62,7 +64,8 @@ extension DetailRecordV2ResponseDTO {
             pageNumber: pageNumber,
             quote: quote,
             review: review,
-            emotionTags: [primaryEmotion.displayName],
+            primaryEmotion: primaryEmotion.toDomain(),
+            detailEmotions: detailEmotions.map { $0.toDomain() },
             createdAt: DateParser.parseISO8601(createdAt) ?? .distantPast,
             updatedAt: DateParser.parseISO8601(updatedAt),
             bookTitle: bookTitle,

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

@@ -0,0 +1,53 @@
+// Copyright © 2025 Booket. All rights reserved
+
+import BKDomain
+import Foundation
+
+// MARK: - API Response DTO
+
+struct EmotionListResponseDTO: Decodable {
+    let emotions: [EmotionGroupDTO]
+}
+
+struct EmotionGroupDTO: Decodable {
+    let code: String
+    let displayName: String
+    let detailEmotions: [DetailEmotionDTO]
+}
+
+struct DetailEmotionDTO: Decodable {
+    let id: String
+    let name: String
+}
+
+// MARK: - Mapping to Domain
+
+extension EmotionGroupDTO {
+    func toDomain() -> EmotionGroup? {
+        guard let primaryEmotion = PrimaryEmotion(rawValue: code) else {
+            return nil
+        }
+        return EmotionGroup(
+            primaryEmotion: primaryEmotion,
+            displayName: displayName,
+            detailEmotions: detailEmotions.map { $0.toDomain() }
+        )
+    }
+}
+
+extension DetailEmotionDTO {
+    func toDomain() -> DetailEmotion {
+        return DetailEmotion(id: id, name: name)
+    }
+}
+
+// MARK: - Response에서 사용하는 DTO (기록 조회 시)
+
+struct PrimaryEmotionDTO: Decodable {
+    let code: String
+    let displayName: String
+
+    func toDomain() -> PrimaryEmotion? {
+        return PrimaryEmotion(rawValue: code)
+    }
+}

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

@@ -3,45 +3,32 @@
 import BKDomain
 import Foundation
 
-public struct InsertRecordResponseDTO: Decodable {
+struct InsertRecordResponseDTO: Decodable {
     let id: String
     let userBookId: String
-    let pageNumber: Int
+    let pageNumber: Int?
     let quote: String
     let review: String?
-    let emotionTags: [Emotion]
+    let primaryEmotion: PrimaryEmotionDTO
+    let detailEmotions: [DetailEmotionDTO]
     let createdAt: String
     let updatedAt: String
     let bookTitle: String
     let bookPublisher: String
     let bookCoverImageUrl: URL
     let author: String
-
-    enum CodingKeys: String, CodingKey {
-        case id
-        case userBookId
-        case pageNumber
-        case quote
-        case review
-        case emotionTags
-        case createdAt
-        case updatedAt
-        case bookTitle
-        case bookPublisher
-        case bookCoverImageUrl
-        case author
-    }
 }
 
-public extension InsertRecordResponseDTO {
+extension InsertRecordResponseDTO {
     func toRecordInfo() -> RecordInfo {
         return RecordInfo(
             recordId: id,
             bookId: userBookId,
             pageNumber: pageNumber,
             quote: quote,
             review: review,
-            emotionTags: emotionTags,
+            primaryEmotion: primaryEmotion.toDomain() ?? .other,
+            detailEmotions: detailEmotions.map { $0.toDomain() },
             createdAt: DateParser.parseISO8601(createdAt) ?? .distantPast,
             updatedAt: DateParser.parseISO8601(updatedAt),
             bookTitle: bookTitle,

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

@@ -4,10 +4,18 @@ import BKDomain
 
 public struct PrimaryEmotionResponseDTO: Decodable {
     let code: String
-    let displayName: Emotion
+    let displayName: String
+
+    func toDomain() -> PrimaryEmotion {
+        return PrimaryEmotion(rawValue: code) ?? .other
+    }
 }
 
 public struct DetailEmotionResponseDTO: Decodable {
     let id: String
     let name: String
+
+    func toDomain() -> DetailEmotion {
+        return DetailEmotion(id: id, name: name)
+    }
 }

src/Projects/BKData/Sources/DataAssembly.swift

@@ -165,9 +165,17 @@ public struct DataAssembly: Assembly {
                 pushTokenStore: pushTokenStore
             )
         }
-        
+
         container.register(type: ExternalLinkRepository.self) { _ in
             return DefaultExternalLinkRepository()
         }
+
+        container.register(
+            type: EmotionRepository.self,
+            scope: .singleton
+        ) { _ in
+            @Autowired(name: "OAuth") var networkProvider: NetworkProvider
+            return DefaultEmotionRepository(networkProvider: networkProvider)
+        }
     }
 }