Feat: 감정 구슬 API 연동 및 추천 루틴 결과 화면 재사용 (#T3-127)

* Style: 클라에서 저장하고 있는 감정 구슬 값 삭제 (이미지 Asset, EmotionType 등)

* Feat: Emotion 조회 및 등록 API 연동 (#T3-127)

- EmotionEndpoint 정의
- EmotionRepositoryProtocol, EmotionRepository 정의 및 구현 (+ EmotionResponseDTO)
- EmotionUseCaseProtocol, EmotionUseCase 정의 및 구현 (+ EmotionEntity)

* Chore: Kingfisher 외부 라이브러리 의존성 추가

* Refatcor: 감정구슬 Cell, 감정구슬 등록 화면 수정 (#T3-127)

- 서버 통신으로 받은 값들을 보여주도록 수정
- 감정 구슬 이미지 Kingfisher로 출력

* Docs: 그래픽 이미지 Asset 추가 및 BitnagilGraphic 케이스 추가

* Refactor: 기존 OnboardingUseCase 삭제 및 추천 루틴 받아오는 로직 이동 (#T3-127)

- OnboardingUseCaseProtocol, OnboardingUseCase 삭제
- OnboardingRecommendedRoutineView 삭제
- 기존 온보딩 선택지 · 감정 값을 등록하고 추천 루틴을 받아오는 로직 이동

* Chore: Common View 폴더 생성 및 재사용 View 이동 (SplashView, TabBarView)

* Feat: ResultRecommendedRoutineView · ResultRecommendedRoutineViewModel 구현 (#T3-127)

- 추천 루틴 결과 값을 보여주는 화면(ResultRecommendedRoutineView) 구현
- 온보딩 선택지 or 감정 구슬 선택지에 따른 추천 루틴 받아오는 로직
- 선택한 추천 루틴 등록 로직

* Refactor: ResultRecommendedRoutineView 재사용을 위한 분기처리 (#T3-127)

- MypageView, OnboardingResultView, EmotionRegisterView에서 재사용할 수 있도록 분기 처리
- OnboardingResultView에 그래픽 추가

* Feat: 의존성 조립 (Domain, DataSource, Presentation)

* Refactor: 오타 수정

* Refactor: UIScreen.main 기준으로 height 계산하는 코드 수정

Author: choijungp

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/OnboardingUseCaseProtocol.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
+}