feat: 통계 상세 api 연동 (#207)

* fix: 목표 비어있을 때 toEntity 처리 - #206

* fix: emptyView 깜빡이는 현상 해결 - #206

* fix: 종료된 목표 라이팅 수정 - #206

* feat: fetchStatsDetail(calendar/summary) Domain 구현

* feat: fetchStatsDetail View, Reducer 구현 - #206

* fix: 카드 스와이프 버그 수정 - #206

* feat: 통계 상세 드롭다운 기능 구현 - #206

* feat: subContent navibar 배경색 주입 - #206

* fix: EditGoalList, GoalDetail 처음에 emptyView 안보이도록 개선 - #206

* feat: StatsCardHeader 터치시 Detail 이동 구현 - #206

---------

Co-authored-by: jihun <jihun332@gmai.com>

Author: jihun32

Projects/Domain/Stats/Interface/Sources/DTO/StatsDetailCalendarResponseDTO.swift

@@ -0,0 +1,41 @@
+//
+//  StatsDetailCalendarResponseDTO.swift
+//  DomainStatsInterface
+//
+//  Created by 정지훈 on 2/25/26.
+//
+
+import Foundation
+
+public struct StatsDetailCalendarResponseDTO: Decodable {
+    let goalId: Int64
+    let goalName: String
+    let goalIcon: String
+    let yearMonth: String
+    let isCompleted: Bool
+    let completedDates: [CompletedDate]
+    
+    struct CompletedDate: Decodable {
+        let date: String
+        let myImageUrl: String?
+        let partnerImageUrl: String?
+    }
+}
+
+extension StatsDetailCalendarResponseDTO {
+    public func toEntity() -> StatsDetail {
+        StatsDetail(
+            goalId: goalId,
+            goalName: goalName,
+            isCompleted: isCompleted,
+            yearMonth: yearMonth,
+            completedDate: completedDates.map {
+                StatsDetail.CompletedDate(
+                    date: $0.date,
+                    myImageUrl: $0.myImageUrl,
+                    partnerImageUrl: $0.partnerImageUrl
+                )
+            }
+        )
+    }
+}

Projects/Domain/Stats/Interface/Sources/DTO/StatsDetailSummaryResponseDTO.swift

@@ -0,0 +1,34 @@
+//
+//  StatsDetailSummaryResponseDTO.swift
+//  DomainStatsInterface
+//
+//  Created by 정지훈 on 2/25/26.
+//
+
+import Foundation
+
+public struct StatsDetailSummaryResponseDTO: Decodable {
+    let myNickname: String
+    let partnerNickname: String
+    let totalCount: Int
+    let myCompletedCount: Int
+    let partnerCompletedCount: Int
+    let repeatCycle: String
+    let startDate: String
+    let endDate: String?
+}
+
+extension StatsDetailSummaryResponseDTO {
+    public func toEntity() -> StatsDetail.Summary {
+        return .init(
+            myNickname: myNickname,
+            partnerNickname: partnerNickname,
+            totalCount: totalCount,
+            myCompletedCount: myCompletedCount,
+            partnerCompltedCount: partnerCompletedCount,
+            repeatCycle: .init(rawValue: repeatCycle) ?? .daily,
+            startDate: startDate,
+            endDate: endDate
+        )
+    }
+}

Projects/Domain/Stats/Interface/Sources/DTO/StatsResponseDTO.swift

@@ -5,7 +5,7 @@
 //  Created by 정지훈 on 2/25/26.
 //
 
-import Foundation
+import CoreNetworkInterface
 
 /// 통계 목록 조회 응답을 디코딩하는 DTO입니다.
 public struct StatsResponseDTO: Decodable {
@@ -37,8 +37,15 @@ extension StatsResponseDTO {
     /// let dto: StatsResponseDTO = ...
     /// let stats = dto.toEntity(isInProgress: true)
     /// ```
-    public func toEntity(isInProgress: Bool) -> Stats? {
-        guard let firstStats = statsGoals.first else { return nil }
+    public func toEntity(isInProgress: Bool) -> Stats {
+        guard let firstStats = statsGoals.first
+        else {
+            return .init(
+                myNickname: "",
+                partnerNickname: "",
+                stats: []
+            )
+        }
 
         return Stats(
             myNickname: firstStats.myStats.nickname,

Projects/Domain/Stats/Interface/Sources/Endpoint/StatsEndpoint.swift

@@ -12,19 +12,27 @@ import CoreNetworkInterface
 /// 통계 목록 조회 API 엔드포인트를 정의합니다.
 public enum StatsEndpoint: Endpoint {
     case fetchStats(selectedDate: String, status: String)
+    case fetchStatsDetailCalendar(goalId: Int64, selectedDate: String)
+    case fetchStatsDetailSummary(goalId: Int64)
 }
 
 extension StatsEndpoint {
     public var path: String {
         switch self {
         case .fetchStats:
             return "/api/v1/stats"
+            
+        case let .fetchStatsDetailCalendar(goalId, _):
+            return "/api/v1/stats/\(goalId)/calendar"
+            
+        case let .fetchStatsDetailSummary(goalId):
+            return "/api/v1/stats/\(goalId)/summary"
         }
     }
 
     public var method: HTTPMethod {
         switch self {
-        case .fetchStats:
+        case .fetchStats, .fetchStatsDetailCalendar, .fetchStatsDetailSummary:
             return .get
         }
     }
@@ -40,12 +48,20 @@ extension StatsEndpoint {
                 .init(name: "selectedDate", value: date),
                 .init(name: "status", value: status),
             ]
+            
+        case let .fetchStatsDetailCalendar(_, date):
+            return [
+                .init(name: "selectedDate", value: date),
+            ]
+            
+        case .fetchStatsDetailSummary:
+            return nil
         }
     }
 
     public var body: (any Encodable)? {
         switch self {
-        case .fetchStats:
+        case .fetchStats, .fetchStatsDetailCalendar, .fetchStatsDetailSummary:
             return nil
         }
     }

Projects/Domain/Stats/Interface/Sources/Entity/StatsDetail.swift

@@ -14,10 +14,9 @@ public struct StatsDetail: Equatable {
     public let goalId: Int64
     public let goalName: String
     public var isCompleted: Bool
+    public let yearMonth: String
     public let completedDate: [CompletedDate]
 
-    public let summary: Summary
-    
     /// 날짜별 목표 달성 이미지를 나타내는 모델입니다.
     public struct CompletedDate: Equatable {
         public let date: String

Projects/Domain/Stats/Interface/Sources/StatsClient.swift

@@ -24,7 +24,8 @@ public struct StatsClient {
     /// 목표 통계를 조회합니다.
     public var fetchStats: (String, Bool) async throws -> Stats
     /// 단일 목표의 상세 통계를 조회합니다.
-    public var fetchStatsDetail: (String) async throws -> StatsDetail
+    public var fetchStatsDetailCalendar: (Int64, String) async throws -> StatsDetail
+    public var fetchStatsDetailSummary: (Int64) async throws -> StatsDetail.Summary
 
     /// 통계 조회 동작을 주입해 `StatsClient`를 생성합니다.
     ///
@@ -54,10 +55,12 @@ public struct StatsClient {
     /// ```
     public init(
         fetchStats: @escaping (String, Bool) async throws -> Stats,
-        fetchStatsDetail: @escaping (String) async throws -> StatsDetail,
+        fetchStatsDetailCalendar: @escaping (Int64, String) async throws -> StatsDetail,
+        fetchStatsDetailSummary: @escaping (Int64) async throws -> StatsDetail.Summary
     ) {
         self.fetchStats = fetchStats
-        self.fetchStatsDetail = fetchStatsDetail
+        self.fetchStatsDetailCalendar = fetchStatsDetailCalendar
+        self.fetchStatsDetailSummary = fetchStatsDetailSummary
     }
 }
 
@@ -71,24 +74,13 @@ extension StatsClient: TestDependencyKey {
                 stats: []
             )
         },
-        fetchStatsDetail: { _ in
-            assertionFailure("StatsClient.fetchStatsDetail이 구현되지 않았습니다. withDependencies로 mock을 주입하세요.")
-            return .init(
-                goalId: 1,
-                goalName: "",
-                isCompleted: false,
-                completedDate: [ ],
-                summary: .init(
-                    myNickname: "",
-                    partnerNickname: "",
-                    totalCount: 322,
-                    myCompletedCount: 82,
-                    partnerCompltedCount: 211,
-                    repeatCycle: .daily,
-                    startDate: "2026-01-07",
-                    endDate: "2027-01-07"
-                )
-            )
+        fetchStatsDetailCalendar: { _, _ in
+            assertionFailure("StatsClient.fetchStatsDetailCalendar이 구현되지 않았습니다. withDependencies로 mock을 주입하세요.")
+            throw NetworkError.invalidResponseError
+        },
+        fetchStatsDetailSummary: { _ in
+            assertionFailure("StatsClient.fetchStatsDetailSummary이 구현되지 않았습니다. withDependencies로 mock을 주입하세요.")
+            throw NetworkError.invalidResponseError
         }
     )
     public static var previewValue: StatsClient = Self(
@@ -180,11 +172,12 @@ extension StatsClient: TestDependencyKey {
                 ]
             )
         },
-        fetchStatsDetail: { _ in
+        fetchStatsDetailCalendar: { _, _ in
             return .init(
                 goalId: 1,
                 goalName: "밥 잘 챙겨먹기",
                 isCompleted: false,
+                yearMonth: "2026-02",
                 completedDate: [
                     .init(
                         date: "2026-02-01",
@@ -201,20 +194,22 @@ extension StatsClient: TestDependencyKey {
                         myImageUrl: "",
                         partnerImageUrl: ""
                     )
-                ],
-                summary: .init(
-                    myNickname: "현수",
-                    partnerNickname: "민정",
-                    totalCount: 322,
-                    myCompletedCount: 82,
-                    partnerCompltedCount: 211,
-                    repeatCycle: .daily,
-                    startDate: "2026-01-07",
-                    endDate: "2027-01-07"
-                )
+                ]
+            )
+        },
+        fetchStatsDetailSummary: { _ in
+            return .init(
+                myNickname: "현수",
+                partnerNickname: "민정",
+                totalCount: 322,
+                myCompletedCount: 82,
+                partnerCompltedCount: 211,
+                repeatCycle: .daily,
+                startDate: "2026-01-07",
+                endDate: "2027-01-07"
             )
         }
-    )   
+    )
 }
 
 extension DependencyValues {

Projects/Domain/Stats/Sources/StatsClient+Live.swift

@@ -23,17 +23,32 @@ extension StatsClient: @retroactive DependencyKey {
                         endpoint: StatsEndpoint.fetchStats(selectedDate: date, status: status)
                     )
 
-                    guard let stats = response.toEntity(isInProgress: isInProgress)
-                    else { throw NetworkError.invalidResponseError }
+                    return response.toEntity(isInProgress: isInProgress)
+                } catch {
+                    throw error
+                }
+            },
+            fetchStatsDetailCalendar: { goalId, date in
+                do {
+                    let response: StatsDetailCalendarResponseDTO = try await networkClient.request(
+                        endpoint: StatsEndpoint.fetchStatsDetailCalendar(goalId: goalId, selectedDate: date)
+                    )
 
-                    return stats
+                    return response.toEntity()
                 } catch {
                     throw error
                 }
             },
-            fetchStatsDetail: { _ in
-                // FIXME: - API 연동
-                throw NetworkError.notFoundError
+            fetchStatsDetailSummary: { goalId in
+                do {
+                    let response: StatsDetailSummaryResponseDTO = try await networkClient.request(
+                        endpoint: StatsEndpoint.fetchStatsDetailSummary(goalId: goalId)
+                    )
+                    
+                    return response.toEntity()
+                } catch {
+                    throw error
+                }
             }
         )
     }

Projects/Feature/GoalDetail/Sources/Detail/GoalDetailReducer+Impl.swift

@@ -98,13 +98,13 @@ extension GoalDetailReducer {
                 )
 
             case .cardSwipeLeft:
-                state.currentUser = .mySelf
+                state.currentUser = state.entryPoint == .home ? .mySelf : .you
                 state.commentText = state.comment
                 state.selectedReactionEmoji = state.currentCard?.reaction.flatMap(ReactionEmoji.init(from:))
                 return .send(.setCreatedAt(timeFormatter.displayText(from: state.currentCard?.createdAt)))
 
             case .cardSwipeRight:
-                state.currentUser = .you
+                state.currentUser = state.entryPoint == .home ? .you : .mySelf
                 state.commentText = state.comment
                 state.selectedReactionEmoji = state.currentCard?.reaction.flatMap(ReactionEmoji.init(from:))
                 return .send(.setCreatedAt(timeFormatter.displayText(from: state.currentCard?.createdAt)))

Projects/Feature/GoalDetail/Sources/Detail/GoalDetailView.swift

@@ -61,20 +61,23 @@ public struct GoalDetailView: View {
     public var body: some View {
         VStack(spacing: 0) {
             navigationBar
-            cardView
-                .padding(.horizontal, 27)
-                .padding(.top, isSEDevice ? 47 : 103)
 
-            if store.isCompleted {
-                completedBottomContent
-            } else {
-                bottomButton
-                    .padding(.top, 105)
-                    .frame(maxWidth: .infinity)
-                    .overlay(alignment: .topTrailing) {
-                        pokeImage
-                            .offset(x: -20, y: -20)
-                    }
+            if store.item != nil {
+                cardView
+                    .padding(.horizontal, 27)
+                    .padding(.top, isSEDevice ? 47 : 103)
+                
+                if store.isCompleted {
+                    completedBottomContent
+                } else {
+                    bottomButton
+                        .padding(.top, 105)
+                        .frame(maxWidth: .infinity)
+                        .overlay(alignment: .topTrailing) {
+                            pokeImage
+                                .offset(x: -20, y: -20)
+                        }
+                }
             }
 
             Spacer()

Projects/Feature/Home/Interface/Sources/Goal/EditGoalListReducer.swift

@@ -36,8 +36,8 @@ public struct EditGoalListReducer {
 
         public var calendarDate: TXCalendarDate
         public var calendarWeeks: [[TXCalendarDateItem]]
-        public var cards: [GoalEditCardItem] = []
-        public var hasCards: Bool { !cards.isEmpty }
+        public var cards: [GoalEditCardItem]?
+        public var hasCards: Bool { !(cards?.isEmpty ?? true) }
         public var selectedCardMenu: GoalEditCardItem?
         public var modal: TXModalType?
         public var toast: TXToastType?