[Feat-T3-127] 감정 구슬 API 연동 및 추천 루틴 결과 화면 재사용

Projects/DataSource/Sources/Common/DataSourceDependencyAssembler.swift

@@ -28,5 +28,9 @@ public struct DataSourceDependencyAssembler: DependencyAssemblerProtocol {
         DIContainer.shared.register(type: RecommendedRoutineRepositoryProtocol.self) { _ in
             return RecommendedRoutineRepository()
         }
+
+        DIContainer.shared.register(type: EmotionRepositoryProtocol.self) { _ in
+            return EmotionRepository()
+        }
     }
 }

Projects/DataSource/Sources/DTO/EmotionResponseDTO.swift

@@ -0,0 +1,30 @@
+//
+//  EmotionResponseDTO.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/29/25.
+//
+
+import Domain
+import Foundation
+
+struct EmotionResponseDTO: Decodable {
+    let type: String
+    let name: String
+    let imageUrl: String
+
+    enum CodingKeys: String, CodingKey {
+        case type = "emotionMarbleType"
+        case name = "emotionMarbleName"
+        case imageUrl
+    }
+}
+
+extension EmotionResponseDTO {
+    func toEmotionEntity() -> EmotionEntity {
+        return EmotionEntity(
+            emotionType: type,
+            emotionName: name,
+            emotionImageUrl: URL(string: imageUrl))
+    }
+}

Projects/DataSource/Sources/Endpoint/EmotionEndpoint.swift

@@ -0,0 +1,53 @@
+//
+//  EmotionEndpoint.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/28/25.
+//
+
+enum EmotionEndpoint {
+    case fetchEmotions
+    case registerEmotion(emotion: String)
+}
+
+extension EmotionEndpoint: Endpoint {
+    var baseURL: String {
+        return AppProperties.baseURL + "/api/v1/emotion-marbles"
+    }
+
+    var path: String {
+        return baseURL
+    }
+
+    var method: HTTPMethod {
+        switch self {
+        case .fetchEmotions: .get
+        case .registerEmotion: .post
+        }
+    }
+
+    var headers: [String : String] {
+        let headers: [String: String] = [
+            "Content-Type": "application/json",
+            "accept": "*/*"
+        ]
+        return headers
+    }
+
+    var queryParameters: [String : String] {
+        return [:]
+    }
+
+    var bodyParameters: [String : Any] {
+        switch self {
+        case .fetchEmotions:
+            return [:]
+        case .registerEmotion(let emotion):
+            return ["emotionMarbleType": emotion]
+        }
+    }
+
+    var isAuthorized: Bool {
+        return true
+    }
+}

Projects/DataSource/Sources/Repository/EmotionRepository.swift

@@ -0,0 +1,30 @@
+//
+//  EmotionRepository.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/28/25.
+//
+
+import Domain
+
+final class EmotionRepository: EmotionRepositoryProtocol {
+    private let networkService = NetworkService.shared
+
+    func fetchEmotions() async throws -> [EmotionEntity] {
+        let endpoint = EmotionEndpoint.fetchEmotions
+        guard let response = try await networkService.request(endpoint: endpoint, type: [EmotionResponseDTO].self)
+        else { return [] }
+
+        let emotionEntities = response.compactMap({ $0.toEmotionEntity() })
+        return emotionEntities
+    }
+
+    func registerEmotion(emotion: String) async throws -> [RecommendedRoutineEntity] {
+        let endpoint = EmotionEndpoint.registerEmotion(emotion: emotion)
+        guard let response = try await networkService.request(endpoint: endpoint, type: RecommendedRoutineListResponseDTO.self)
+        else { return [] }
+
+        let recommendedRoutineEntity = response.recommendedRoutines.compactMap({ $0.toRecommendedRoutineEntity() })
+        return recommendedRoutineEntity
+    }
+}

Projects/Domain/Sources/DomainDependencyAssembler.swift

@@ -32,18 +32,25 @@ public struct DomainDependencyAssembler: DependencyAssemblerProtocol {
             return WithdrawUseCase(authRepository: authRepository)
         }
 
-        DIContainer.shared.register(type: OnboardingUseCaseProtocol.self) { container in
-            guard let onboardingRepository = container.resolve(type: OnboardingRepositoryProtocol.self)
-            else { fatalError("onboardingRepository 의존성이 등록되지 않았습니다.") }
-
-            return OnboardingUseCase(onboardingRepository: onboardingRepository)
-        }
-
         DIContainer.shared.register(type: RecommendedRoutineUseCaseProtocol.self) { container in
             guard let recommendedRoutineRepository = container.resolve(type: RecommendedRoutineRepositoryProtocol.self)
             else { fatalError("recommendedRoutineRepository 의존성이 등록되지 않았습니다.") }
 
             return RecommendedRoutineUseCase(recommendedRoutineRepository: recommendedRoutineRepository)
         }
+
+        guard let emotionRepository = DIContainer.shared.resolve(type: EmotionRepositoryProtocol.self)
+        else { fatalError("emotionRepository 의존성이 등록되지 않았습니다.") }
+
+        DIContainer.shared.register(type: EmotionUseCaseProtocol.self) { _ in
+            return EmotionUseCase(emotionRepository: emotionRepository)
+        }
+
+        DIContainer.shared.register(type: ResultRecommendedRoutineUseCaseProtocol.self) { container in
+            guard let onboardingRepository = container.resolve(type: OnboardingRepositoryProtocol.self)
+            else { fatalError("onboardingRepository 의존성이 등록되지 않았습니다.") }
+
+            return ResultRecommendedRoutineUseCase(onboardingRepository: onboardingRepository, emotionRepository: emotionRepository)
+        }
     }
 }

Projects/Domain/Sources/Entity/EmotionEntity.swift

@@ -0,0 +1,24 @@
+//
+//  EmotionEntity.swift
+//  Domain
+//
+//  Created by 최정인 on 7/29/25.
+//
+
+import Foundation
+
+public struct EmotionEntity {
+    public let emotionType: String
+    public let emotionName: String
+    public let emotionImageUrl: URL?
+
+    public init(
+        emotionType: String,
+        emotionName: String,
+        emotionImageUrl: URL?
+    ) {
+        self.emotionType = emotionType
+        self.emotionName = emotionName
+        self.emotionImageUrl = emotionImageUrl
+    }
+}

Projects/Domain/Sources/Protocol/Repository/EmotionRepositoryProtocol.swift

@@ -0,0 +1,18 @@
+//
+//  EmotionRepositoryProtocol.swift
+//  Domain
+//
+//  Created by 최정인 on 7/28/25.
+//
+
+/// 감정 구슬에 대한 로직을 처리하는 Repository
+public protocol EmotionRepositoryProtocol {
+    /// 감정 구슬 목록을 불러옵니다.
+    /// - Returns: 조회된 감정 구슬 목록
+    func fetchEmotions() async throws -> [EmotionEntity]
+
+    /// 감정 구슬을 등록합니다.
+    /// - Parameter emotion: 감정 구슬 String 값
+    /// - Returns: 등록한 감정 구슬에 따른 추천 루틴 리스트
+    func registerEmotion(emotion: String) async throws -> [RecommendedRoutineEntity]
+}

Projects/Domain/Sources/Protocol/UseCase/EmotionUseCaseProtocol.swift

@@ -0,0 +1,12 @@
+//
+//  EmotionUseCaseProtocol.swift
+//  Domain
+//
+//  Created by 최정인 on 7/28/25.
+//
+
+public protocol EmotionUseCaseProtocol {
+    /// 감정 구슬 목록을 불러옵니다.
+    /// - Returns: 조회된 감정 구슬 목록
+    func fetchEmotions() async throws -> [EmotionEntity]
+}

Projects/Domain/Sources/Protocol/UseCase/ResultRecommendedRoutineUseCaseProtocol.swift

@@ -0,0 +1,24 @@
+//
+//  ResultRecommendedRoutineUseCaseProtocol.swift
+//  Domain
+//
+//  Created by 최정인 on 7/29/25.
+//
+
+import Foundation
+
+public protocol ResultRecommendedRoutineUseCaseProtocol {
+    /// 선택한 온보딩 결과를 저장하고, 추천 루틴을 받습니다.
+    /// - Parameter onboardingChoices: 선택한 온보딩 항목 list
+    /// - Returns: 온보딩 결과를 바탕으로 받은 추천루틴 목록
+    func fetchResultRecommendedRoutines(onboardingChoices: [OnboardingChoiceType]) async throws -> [RecommendedRoutineEntity]
+
+    /// 감정 구슬을 등록하고 그에 따른 추천 루틴 리스트를 받습니다.
+    /// - Parameter emotion: 감정 구슬 타입 String
+    /// - Returns: 등록한 감정 구슬에 따른 추천 루틴 리스트
+    func fetchResultRecommendedRoutines(emotion: String) async throws -> [RecommendedRoutineEntity]
+
+    /// 선택한 추천 루틴을 등록합니다.
+    /// - Parameter selectedRoutines: 선택한 추천 루틴 ID 목록
+    func registerRecommendedRoutines(selectedRoutines: [Int]) async throws
+}

Projects/Domain/Sources/UseCase/Emotion/EmotionUseCase.swift

@@ -0,0 +1,19 @@
+//
+//  EmotionUseCase.swift
+//  Domain
+//
+//  Created by 최정인 on 7/28/25.
+//
+
+public final class EmotionUseCase: EmotionUseCaseProtocol {
+    private let emotionRepository: EmotionRepositoryProtocol
+
+    public init(emotionRepository: EmotionRepositoryProtocol) {
+        self.emotionRepository = emotionRepository
+    }
+
+    public func fetchEmotions() async throws -> [EmotionEntity] {
+        let emotions = try await emotionRepository.fetchEmotions()
+        return emotions
+    }
+}

Projects/Domain/Sources/UseCase/Onboarding/OnboardingUseCase.swift → Projects/Domain/Sources/UseCase/ResultRecommendedRoutine/ResultRecommendedRoutineUseCase.swift

@@ -1,23 +1,31 @@
 //
-//  OnboardingUseCase.swift
+//  ResultRecommendedRoutineUseCase.swift
 //  Domain
 //
-//  Created by 최정인 on 7/15/25.
+//  Created by 최정인 on 7/29/25.
 //
 
-public final class OnboardingUseCase: OnboardingUseCaseProtocol {
+
+public final class ResultRecommendedRoutineUseCase: ResultRecommendedRoutineUseCaseProtocol {
     private let onboardingRepository: OnboardingRepositoryProtocol
+    private let emotionRepository: EmotionRepositoryProtocol
 
-    public init(onboardingRepository: OnboardingRepositoryProtocol) {
+    public init(onboardingRepository: OnboardingRepositoryProtocol, emotionRepository: EmotionRepositoryProtocol) {
         self.onboardingRepository = onboardingRepository
+        self.emotionRepository = emotionRepository
     }
 
-    public func registerOnboarding(onboardingChoices: [OnboardingChoiceType]) async throws -> [RecommendedRoutineEntity] {
+    public func fetchResultRecommendedRoutines(onboardingChoices: [OnboardingChoiceType]) async throws -> [RecommendedRoutineEntity] {
         let choices = convertToDictionary(onboardingChoices: onboardingChoices)
         let recommendedRoutines = try await onboardingRepository.registerOnboarding(onboardingChoices: choices)
         return recommendedRoutines
     }
 
+    public func fetchResultRecommendedRoutines(emotion: String) async throws -> [RecommendedRoutineEntity] {
+        let recommendedRoutines = try await emotionRepository.registerEmotion(emotion: emotion)
+        return recommendedRoutines
+    }
+
     public func registerRecommendedRoutines(selectedRoutines: [Int]) async throws {
         try await onboardingRepository.registerRecommendedRoutines(selectedRoutines: selectedRoutines)
     }

Projects/Presentation/Project.swift

@@ -13,6 +13,7 @@ let project = Project(
             resources: ["Resources/**"],
             dependencies: [
                 .external(name: "SnapKit"),
+                .external(name: "Kingfisher"),
                 .project(target: "Domain", path: "../Domain"),
                 .project(target: "Shared", path: "../Shared")
             ]