[Feat-T3-121] 추천 루틴 API 연동

Projects/DataSource/Sources/Common/DataSourceDependencyAssembler.swift

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

Projects/DataSource/Sources/DTO/RecommendedRoutineDTO.swift

@@ -2,42 +2,56 @@
 //  RecommendedRoutineDTO.swift
 //  DataSource
 //
-//  Created by 최정인 on 7/15/25.
+//  Created by 최정인 on 7/27/25.
 //
 
 import Domain
 
-struct RecommendedRoutineListResponseDTO: Decodable {
-    let recommendedRoutines: [RecommendedRoutineDTO]
-}
-
 struct RecommendedRoutineDTO: Decodable {
     let id: Int
     let routineName: String
     let routineDescription: String
-    let subRoutines: [SubRoutine]
+    let routineLevel: String?
+    let subRoutines: [SubRoutineDTO]
 
     enum CodingKeys: String, CodingKey {
         case id = "recommendedRoutineId"
         case routineName = "recommendedRoutineName"
-        case routineDescription
-        case subRoutines = "recommendedSubRoutines"
+        case routineDescription = "recommendedRoutineDescription"
+        case routineLevel = "recommendedRoutineLevel"
+        case subRoutines = "recommendedSubRoutineSearchResult"
     }
 
-    func toRecommendedRoutineEntity() -> RecommendedRoutineEntity {
+    func toRecommendedRoutineEntity(category: String? = nil) -> RecommendedRoutineEntity {
+        var routineCategory: RoutineCategoryType?
+        if let category {
+            routineCategory = RoutineCategoryType(rawValue: category)
+        }
+
+        var level: RoutineLevelType?
+        if let routineLevel {
+            level = RoutineLevelType(rawValue: routineLevel)
+        }
         return RecommendedRoutineEntity(
             id: id,
             title: routineName,
-            description: routineDescription)
+            description: routineDescription,
+            category: routineCategory,
+            level: level,
+            subRoutines: subRoutines.compactMap({ $0.toSubRoutineEntity() }))
     }
 }
 
-struct SubRoutine: Decodable {
+struct SubRoutineDTO: Decodable {
     let id: Int
     let routineName: String
 
     enum CodingKeys: String, CodingKey {
         case id = "recommendedSubRoutineId"
         case routineName = "recommendedSubRoutineName"
     }
+
+    func toSubRoutineEntity() -> SubRoutineEntity {
+        return SubRoutineEntity(id: id, title: routineName)
+    }
 }

Projects/DataSource/Sources/DTO/RecommendedRoutineDictionaryResponseDTO.swift

@@ -0,0 +1,10 @@
+//
+//  RecommendedRoutineDictionaryResponseDTO.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+struct RecommendedRoutineDictionaryResponseDTO: Decodable {
+    let recommendedRoutines: [String: [RecommendedRoutineDTO]]
+}

Projects/DataSource/Sources/DTO/RecommendedRoutineListResponseDTO.swift

@@ -0,0 +1,10 @@
+//
+//  RecommendedRoutineListResponseDTO.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/15/25.
+//
+
+struct RecommendedRoutineListResponseDTO: Decodable {
+    let recommendedRoutines: [RecommendedRoutineDTO]
+}

Projects/DataSource/Sources/Endpoint/AuthEndpoint.swift

@@ -5,7 +5,6 @@
 //  Created by 최정인 on 6/30/25.
 //
 
-import Foundation
 import Domain
 
 enum AuthEndpoint {

Projects/DataSource/Sources/Endpoint/OnboardingEndpoint.swift

@@ -5,8 +5,6 @@
 //  Created by 최정인 on 7/15/25.
 //
 
-import Foundation
-
 enum OnboardingEndpoint {
     case registerOnboarding(choices: [String: String])
     case registerRecommendedRoutine(selectedRoutines: [Int])

Projects/DataSource/Sources/Endpoint/RecommendedRoutineEndpoint.swift

@@ -0,0 +1,46 @@
+//
+//  RecommendedRoutineEndpoint.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+enum RecommendedRoutineEndpoint {
+    case fetchRecommendedRoutines
+}
+
+extension RecommendedRoutineEndpoint: Endpoint {
+    var baseURL: String {
+        return AppProperties.baseURL + "/api/v1/recommend-routines"
+    }
+
+    var path: String {
+        switch self {
+        case .fetchRecommendedRoutines: baseURL
+        }
+    }
+
+    var method: HTTPMethod {
+        return .get
+    }
+
+    var headers: [String : String] {
+        let headers: [String: String] = [
+            "Content-Type": "application/json",
+            "accept": "*/*"
+        ]
+        return headers
+    }
+
+    var queryParameters: [String : String] {
+        return [:]
+    }
+
+    var bodyParameters: [String : Any] {
+        return [:]
+    }
+
+    var isAuthorized: Bool {
+        return true
+    }
+}

Projects/DataSource/Sources/Persistence/KeychainStorage.swift

@@ -61,7 +61,7 @@ final class KeychainStorage {
     }
 
     private func baseQuery(for key: String) -> [String: Any] {
-        var query: [String: Any] = [
+        let query: [String: Any] = [
             kSecClass as String: kSecClassGenericPassword,
             kSecAttrService as String: service,
             kSecAttrAccount as String: key

Projects/DataSource/Sources/Repository/AuthRepository.swift

@@ -5,11 +5,11 @@
 //  Created by 최정인 on 6/30/25.
 //
 
-import Foundation
 import Domain
-import Shared
-import KakaoSDKUser
+import Foundation
 import KakaoSDKAuth
+import KakaoSDKUser
+import Shared
 
 final class AuthRepository: AuthRepositoryProtocol {
     private let networkService = NetworkService.shared

Projects/DataSource/Sources/Repository/RecommendedRoutineRepository.swift

@@ -0,0 +1,26 @@
+//
+//  RecommendedRoutineRepository.swift
+//  DataSource
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+import Domain
+
+final class RecommendedRoutineRepository: RecommendedRoutineRepositoryProtocol {
+    private let networkService = NetworkService.shared
+
+    func fetchRecommendedRoutines() async throws -> [RecommendedRoutineEntity] {
+        let endpoint = RecommendedRoutineEndpoint.fetchRecommendedRoutines
+        guard let response = try await networkService.request(endpoint: endpoint, type: RecommendedRoutineDictionaryResponseDTO.self)
+        else { return [] }
+
+        var entities: [RecommendedRoutineEntity] = []
+        for (category, recommendedRoutines) in response.recommendedRoutines {
+            let recommendedRoutineEntity = recommendedRoutines.compactMap({ $0.toRecommendedRoutineEntity(category: category) })
+            entities.append(contentsOf: recommendedRoutineEntity)
+        }
+
+        return entities
+    }
+}

Projects/Domain/Sources/DomainDependencyAssembler.swift

@@ -38,5 +38,12 @@ public struct DomainDependencyAssembler: DependencyAssemblerProtocol {
 
             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)
+        }
     }
 }

Projects/Domain/Sources/Entity/Enum/RoutineCategoryType.swift

@@ -0,0 +1,16 @@
+//
+//  RoutineCategoryType.swift
+//  Domain
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+public enum RoutineCategoryType: String, CaseIterable {
+    case recommendation = "PERSONALIZED"
+    case outdoor = "OUTING"
+    case outdoorReport = "OUTING_REPORT"
+    case wakeup = "WAKE_UP"
+    case connection = "CONNECT"
+    case rest = "REST"
+    case growth = "GROW"
+}

Projects/Domain/Sources/Entity/Enum/RoutineLevelType.swift

@@ -0,0 +1,12 @@
+//
+//  RoutineLevelType.swift
+//  Domain
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+public enum RoutineLevelType: String, CaseIterable {
+    case easy = "LEVEL1"
+    case normal = "LEVEL2"
+    case hard = "LEVEL3"
+}

Projects/Domain/Sources/Entity/RecommendedRoutineEntity.swift

@@ -9,14 +9,33 @@ public struct RecommendedRoutineEntity {
     public let id: Int
     public let title: String
     public let description: String
+    public let category: RoutineCategoryType?
+    public let level: RoutineLevelType?
+    public let subRoutines: [SubRoutineEntity]
 
     public init(
         id: Int,
         title: String,
-        description: String
+        description: String,
+        category: RoutineCategoryType?,
+        level: RoutineLevelType?,
+        subRoutines: [SubRoutineEntity]
     ) {
         self.id = id
         self.title = title
         self.description = description
+        self.category = category
+        self.level = level
+        self.subRoutines = subRoutines
+    }
+}
+
+public struct SubRoutineEntity {
+    public let id: Int
+    public let title: String
+
+    public init(id: Int, title: String) {
+        self.id = id
+        self.title = title
     }
 }

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

@@ -0,0 +1,13 @@
+//
+//  RecommendedRoutineRepositoryProtocol.swift
+//  Domain
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+// 추천 루틴에 관련된 데이터를 가져오는 Repository
+public protocol RecommendedRoutineRepositoryProtocol {
+    /// 추천 루틴 데이터를 가져옵니다.
+    /// - Returns: 추천 루틴 목록
+    func fetchRecommendedRoutines() async throws -> [RecommendedRoutineEntity]
+}

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

@@ -0,0 +1,12 @@
+//
+//  RecommendedRoutineUseCaseProtocol.swift
+//  Domain
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+public protocol RecommendedRoutineUseCaseProtocol {
+    /// 추천 루틴 데이터를 가져옵니다.
+    /// - Returns: 추천 루틴 목록
+    func fetchRecommendedRoutines() async throws -> [RecommendedRoutineEntity]
+}

Projects/Domain/Sources/UseCase/RecommendedRoutine/RecommendedRoutineUseCase.swift

@@ -0,0 +1,19 @@
+//
+//  RecommendedRoutineUseCase.swift
+//  Domain
+//
+//  Created by 최정인 on 7/27/25.
+//
+
+public final class RecommendedRoutineUseCase: RecommendedRoutineUseCaseProtocol {
+    private let recommendedRoutineRepository: RecommendedRoutineRepositoryProtocol
+
+    public init(recommendedRoutineRepository: RecommendedRoutineRepositoryProtocol) {
+        self.recommendedRoutineRepository = recommendedRoutineRepository
+    }
+
+    public func fetchRecommendedRoutines() async throws -> [RecommendedRoutineEntity] {
+        let recommendedRoutines = try await recommendedRoutineRepository.fetchRecommendedRoutines()
+        return recommendedRoutines
+    }
+}

Projects/Presentation/Resources/Images.xcassets/add_routine_icon.imageset/Contents.json

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "add_routine_icon.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "add_routine_icon@2x.png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "add_routine_icon@3x.png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}