[Feat] 전체보기 화면을 구현하고, 메인화면에서의 화면 전환 로직을 구현합니다.

Popcorn-iOS/Source/Data/DTO/Common/InterestCategoryDTO.swift

@@ -0,0 +1,56 @@
+//
+//  InterestCategoryDTO.swift
+//  Popcorn-iOS
+//
+//  Created by 제민우 on 3/12/25.
+//
+
+struct InterestCategoryDTO: Codable, Hashable {
+    let category: String
+
+    init(from entity: InterestCategory) {
+        switch entity {
+        case .fashion:
+            category = "FASHION"
+        case .beauty:
+            category = "BEAUTY"
+        case .food:
+            category = "FOOD"
+        case .character:
+            category = "CHARACTERS"
+        case .dramaMovie:
+            category = "MOVIES"
+        case .lifeStyle:
+            category = "LIFESTYLE"
+        case .art:
+            category = "ART"
+        case .IT:
+            category = "IT"
+        case .sports:
+            category = "SPORTS"
+        case .celebrity:
+            category = "CELEBRITY"
+        case .pet:
+            category = "PETS"
+        }
+    }
+}
+
+extension InterestCategoryDTO {
+    func toEntity() -> InterestCategory? {
+        return switch category {
+        case "FASHION": InterestCategory.fashion
+        case "BEAUTY": InterestCategory.beauty
+        case "FOOD": InterestCategory.food
+        case "CHARACTERS": InterestCategory.character
+        case "MOVIES": InterestCategory.dramaMovie
+        case "LIFESTYLE": InterestCategory.lifeStyle
+        case "ART": InterestCategory.art
+        case "IT": InterestCategory.IT
+        case "SPORTS": InterestCategory.sports
+        case "CELEBRITY": InterestCategory.celebrity
+        case "PETS": InterestCategory.pet
+        default: nil
+        }
+    }
+}

Popcorn-iOS/Source/Data/DTO/MainScene/MainScene/PopupMainListResponseDTO.swift

@@ -9,7 +9,7 @@ import Foundation
 
 struct PopupMainListResponseDTO: Decodable {
     let userPickPopups: [PopupPreviewResponseDTO]
-    let userInterestPopups: [String: [PopupPreviewResponseDTO]]
+    let userInterestPopups: [InterestCategoryDTO: [PopupPreviewResponseDTO]]
     let closingSoonPopups: [PopupPreviewResponseDTO]
 
     enum CodingKeys: String, CodingKey {
@@ -18,41 +18,3 @@ struct PopupMainListResponseDTO: Decodable {
         case closingSoonPopups = "allPopups"
     }
 }
-
-enum DtoInterestCategory: String {
-    case fashion = "패션"
-    case beauty = "뷰티"
-    case food = "음식"
-    case character = "캐릭터"
-    case dramaMovie = "영화 / 드라마"
-    case lifeStyle = "라이프스타일"
-    case art = "아트"
-    case IT = "IT"
-    case celebrity = "셀럽"
-    case pet = "반려동물"
-
-    var convert: InterestCategory {
-        switch self {
-        case .fashion:
-            return .fashion
-        case .beauty:
-            return .beauty
-        case .food:
-            return .food
-        case .character:
-            return .character
-        case .dramaMovie:
-            return .dramaMovie
-        case .lifeStyle:
-            return .lifeStyle
-        case .art:
-            return .art
-        case .IT:
-            return .IT
-        case .celebrity:
-            return .celebrity
-        case .pet:
-            return .pet
-        }
-    }
-}

Popcorn-iOS/Source/Data/DTO/MainScene/MainScene/PopupOverviewResponseDTO.swift

@@ -0,0 +1,43 @@
+//
+//  PopupOverviewResponseDTO.swift
+//  Popcorn-iOS
+//
+//  Created by 제민우 on 3/12/25.
+//
+
+import Foundation
+
+struct PopupOverviewResponseDTO: Decodable {
+    let popupId: Int
+    let popupImageUrl: String
+    let popupTitle: String
+    let startDate: String
+    let endDate: String
+    let address: String
+
+    enum CodingKeys: String, CodingKey {
+        case popupId
+        case popupImageUrl = "popupImage"
+        case popupTitle = "title"
+        case startDate = "startedAt"
+        case endDate = "endedAt"
+        case address = "location"
+    }
+}
+
+extension PopupOverviewResponseDTO {
+    func toEntity() -> PopupOverview {
+        let errorDate = DateFormatter.apiDateFormatter.date(from: "1900-01-01 00:00:00")!
+        let endDate = DateFormatter.apiDateFormatter.date(from: endDate) ?? errorDate
+        let startDate = DateFormatter.apiDateFormatter.date(from: startDate) ?? errorDate
+
+        return PopupOverview(
+            popupId: popupId,
+            popupImageUrl: popupImageUrl,
+            popupTitle: popupTitle,
+            startDate: startDate,
+            endDate: endDate,
+            address: address
+        )
+    }
+}

Popcorn-iOS/Source/Data/Network/APIConstant.swift

@@ -29,10 +29,8 @@ struct APIConstant {
 
     // MARK: - Main Scene
     static let mainScenePath = "/popups/home"
-    static let moreUserPickPath = "/popups/likes"
-    static let moreInterestPath = "/popups/interest"
-
-    static func moreUserPickPath(category: String) -> String {
+    static let userPickOverviewPath = "/popups/likes"
+    static func interestOverviewPath(category: String) -> String {
         return "/popups/interests/\(category)"
     }
 

Popcorn-iOS/Source/Data/Repositories/MainScene/PopupListRepository.swift

@@ -111,8 +111,60 @@ final class PopupListRepository: PopupListRepositoryProtocol {
         }
     }
 
-    func fetchCategorizedPopupList(completion: @escaping (Result<[PopupPreview], NetworkError>) -> Void) {
-        // TODO: API 나온 후 구현
+    func fetchPopupOverview(
+        category: PopupSectionCategory,
+        page: Int,
+        completion: @escaping (Result<[PopupOverview], Error>) -> Void
+    ) {
+        guard let token = tokenRepository.fetchAccessToken() else {
+            // TODO: TokenRepository에서 access token 만료 시 자동으로 reissue 하는 로직 구현 후 리팩토링
+            completion(.failure(NSError(
+                domain: "PopupListRepository",
+                code: -1,
+                userInfo: [NSLocalizedDescriptionKey: "액세스 토큰 만료"]
+            )))
+            return
+        }
+
+        if case .userPick = category {
+            let userPickOverviewEndpoint = Endpoint<[PopupOverviewResponseDTO]>(
+                httpMethod: .get,
+                path: APIConstant.userPickOverviewPath,
+                queryItems: [URLQueryItem(name: "page", value: String(page))],
+                headers: ["Authorization": "Bearer \(token)"]
+            )
+
+            networkManager.request(endpoint: userPickOverviewEndpoint) { result in
+                switch result {
+                case .success(let endpoint):
+                    completion(.success(endpoint.map { $0.toEntity() }))
+                case .failure(let error):
+                    completion(.failure(error))
+                }
+            }
+        } else if case .userInterest(let interestCategory) = category {
+            guard let interestCategory else {
+                print("관심사 카테고리가 옵셔널 타입입니다.")
+                return
+            }
+
+            let interestCategoryString: String = InterestCategoryDTO(from: interestCategory).category
+            let interestOverviewEndpoint = Endpoint<[PopupOverviewResponseDTO]>(
+                httpMethod: .get,
+                path: APIConstant.interestOverviewPath(category: interestCategoryString),
+                queryItems: [URLQueryItem(name: "page", value: String(page))],
+                headers: ["Authorization": "Bearer \(token)"]
+            )
+
+            networkManager.request(endpoint: interestOverviewEndpoint) { result in
+                switch result {
+                case .success(let endpoint):
+                    completion(.success(endpoint.map { $0.toEntity() }))
+                case .failure(let error):
+                    completion(.failure(error))
+                }
+            }
+        }
     }
 }
 
@@ -125,7 +177,7 @@ extension PopupListRepository {
         let userPickPopups = mainListResponseDTO.userPickPopups.map { $0.toEntity() }
 
         let userInterestPopups: [UserInterestPopup] = mainListResponseDTO.userInterestPopups.compactMap { key, value in
-            guard let interestCategory = InterestCategory(serverValue: key) else { return nil }
+            guard let interestCategory = key.toEntity() else { return nil }
             return UserInterestPopup(
                 interestCategory: interestCategory,
                 popups: value.map { $0.toEntity() }

Popcorn-iOS/Source/Domain/Entities/Category/InterestCategory.swift

@@ -0,0 +1,22 @@
+//
+//  InterestCategory.swift
+//  Popcorn-iOS
+//
+//  Created by 김성훈 on 2/19/25.
+//
+
+import Foundation
+
+enum InterestCategory {
+    case fashion
+    case beauty
+    case food
+    case character
+    case dramaMovie
+    case lifeStyle
+    case art
+    case IT
+    case sports
+    case celebrity
+    case pet
+}

Popcorn-iOS/Source/Domain/Entities/Category/PopupSectionCategory.swift

@@ -0,0 +1,13 @@
+//
+//  PopupSectionCategory.swift
+//  Popcorn-iOS
+//
+//  Created by 제민우 on 3/12/25.
+//
+
+enum PopupSectionCategory {
+    case todayRecommend
+    case userPick
+    case userInterest(InterestCategory?)
+    case closingSoon
+}

Popcorn-iOS/Source/Domain/Entities/MainScene/MainScene/PopupOverviewScene/PopupOverview.swift

@@ -0,0 +1,17 @@
+//
+//  PopupOverview.swift
+//  Popcorn-iOS
+//
+//  Created by 제민우 on 3/12/25.
+//
+
+import Foundation
+
+struct PopupOverview {
+    let popupId: Int
+    let popupImageUrl: String
+    let popupTitle: String
+    let startDate: Date
+    let endDate: Date
+    let address: String
+}

Popcorn-iOS/Source/Domain/Interfaces/Repositories/MainScene/PopupListRepositoryProtocol.swift

@@ -7,5 +7,9 @@
 
 protocol PopupListRepositoryProtocol {
     func fetchPopupMainList(completion: @escaping (Result<PopupMainList, Error>) -> Void)
-    func fetchCategorizedPopupList(completion: @escaping (Result<[PopupPreview], NetworkError>) -> Void)
+    func fetchPopupOverview(
+        category: PopupSectionCategory,
+        page: Int,
+        completion: @escaping (Result<[PopupOverview], Error>) -> Void
+    )
 }

Popcorn-iOS/Source/Domain/UseCases/MainScene/Implementations/PopupFetchListUseCase.swift

@@ -16,7 +16,18 @@ final class PopupFetchListUseCase: PopupFetchListUseCaseProtocol {
         repository.fetchPopupMainList(completion: completion)
     }
 
-    func fetchCategorizedPopupList(completion: @escaping (Result<[PopupPreview], NetworkError>) -> Void) {
-        // TODO: API 나온 후 구현
+    func fetchPopupOverview(
+        category: PopupSectionCategory,
+        page: Int,
+        completion: @escaping (Result<[PopupOverview], any Error>) -> Void
+    ) {
+        repository.fetchPopupOverview(category: category, page: page) { result in
+            switch result {
+            case .success(let endpoint):
+                completion(.success(endpoint))
+            case .failure(let error):
+                completion(.failure(error))
+            }
+        }
     }
 }

Popcorn-iOS/Source/Domain/UseCases/MainScene/Interfaces/PopupFetchListUseCaseProtocol.swift

@@ -7,5 +7,9 @@
 
 protocol PopupFetchListUseCaseProtocol {
     func fetchPopupMainList(completion: @escaping (Result<PopupMainList, Error>) -> Void)
-    func fetchCategorizedPopupList(completion: @escaping (Result<[PopupPreview], NetworkError>) -> Void)
+    func fetchPopupOverview(
+        category: PopupSectionCategory,
+        page: Int,
+        completion: @escaping (Result<[PopupOverview], Error>) -> Void
+    ) 
 }