Feat: Home 화면에서 감정 구슬 보여주기 (#T3-130)

Author: choijungp

Projects/DataSource/Sources/DTO/EmotionResponseDTO.swift

@@ -9,9 +9,9 @@ import Domain
 import Foundation
 
 struct EmotionResponseDTO: Decodable {
-    let type: String
-    let name: String
-    let imageUrl: String
+    let type: String?
+    let name: String?
+    let imageUrl: String?
 
     enum CodingKeys: String, CodingKey {
         case type = "emotionMarbleType"
@@ -21,7 +21,13 @@ struct EmotionResponseDTO: Decodable {
 }
 
 extension EmotionResponseDTO {
-    func toEmotionEntity() -> EmotionEntity {
+    func toEmotionEntity() -> EmotionEntity? {
+        guard
+            let type,
+            let name,
+            let imageUrl
+        else { return nil }
+
         return EmotionEntity(
             emotionType: type,
             emotionName: name,

Projects/DataSource/Sources/Endpoint/EmotionEndpoint.swift

@@ -7,6 +7,7 @@
 
 enum EmotionEndpoint {
     case fetchEmotions
+    case fetchEmotion(date: String)
     case registerEmotion(emotion: String)
 }
 
@@ -16,12 +17,20 @@ extension EmotionEndpoint: Endpoint {
     }
 
     var path: String {
-        return baseURL
+        switch self {
+        case .fetchEmotions:
+            return baseURL
+        case .fetchEmotion(let date):
+            return baseURL + "/\(date)"
+        case .registerEmotion(let emotion):
+            return baseURL
+        }
     }
 
     var method: HTTPMethod {
         switch self {
         case .fetchEmotions: .get
+        case .fetchEmotion: .get
         case .registerEmotion: .post
         }
     }
@@ -42,6 +51,8 @@ extension EmotionEndpoint: Endpoint {
         switch self {
         case .fetchEmotions:
             return [:]
+        case .fetchEmotion:
+            return [:]
         case .registerEmotion(let emotion):
             return ["emotionMarbleType": emotion]
         }

Projects/DataSource/Sources/Repository/EmotionRepository.swift

@@ -19,6 +19,15 @@ final class EmotionRepository: EmotionRepositoryProtocol {
         return emotionEntities
     }
 
+    func fetchEmotion(date: String) async throws -> EmotionEntity? {
+        let endpoint = EmotionEndpoint.fetchEmotion(date: date)
+        guard let response = try await networkService.request(endpoint: endpoint, type: EmotionResponseDTO.self)
+        else { throw NetworkError.unknown(description: "Emotion Reponse를 받아오지 못했습니다.") }
+
+        let emotionEntity = response.toEmotionEntity()
+        return emotionEntity
+    }
+
     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)

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

@@ -10,6 +10,11 @@ public protocol EmotionRepositoryProtocol {
     /// 감정 구슬 목록을 불러옵니다.
     /// - Returns: 조회된 감정 구슬 목록
     func fetchEmotions() async throws -> [EmotionEntity]
+    
+    /// 해당하는 날짜에 등록한 감정 구슬을 조회합니다.
+    /// - Parameter date: 조회하고 싶은 날짜 (yyyy-MM-dd)
+    /// - Returns: 등록한 감정 구슬
+    func fetchEmotion(date: String) async throws -> EmotionEntity?
 
     /// 감정 구슬을 등록합니다.
     /// - Parameter emotion: 감정 구슬 String 값

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

@@ -5,8 +5,15 @@
 //  Created by 최정인 on 7/28/25.
 //
 
+import Foundation
+
 public protocol EmotionUseCaseProtocol {
     /// 감정 구슬 목록을 불러옵니다.
     /// - Returns: 조회된 감정 구슬 목록
     func fetchEmotions() async throws -> [EmotionEntity]
+
+    /// 해당하는 날짜에 등록된 감정 구슬을 조회합니다.
+    /// - Parameter date: 조회하고 싶은 날짜
+    /// - Returns: 감정 구슬
+    func fetchEmotion(date: Date) async throws -> EmotionEntity?
 }

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

@@ -5,6 +5,9 @@
 //  Created by 최정인 on 7/28/25.
 //
 
+import Foundation
+import Shared
+
 public final class EmotionUseCase: EmotionUseCaseProtocol {
     private let emotionRepository: EmotionRepositoryProtocol
 
@@ -16,4 +19,11 @@ public final class EmotionUseCase: EmotionUseCaseProtocol {
         let emotions = try await emotionRepository.fetchEmotions()
         return emotions
     }
+
+    public func fetchEmotion(date: Date) async throws -> EmotionEntity? {
+        let dateString = date.convertToString(dateType: .yearMonthDate)
+
+        let emotion = try await emotionRepository.fetchEmotion(date: dateString)
+        return emotion
+    }
 }

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

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