[Feat] 청년 공고 목록/찜 화면 구현 및 서버 연동

Projects/DataSource/Sources/Common/DataSourceDependencyAssembler.swift

@@ -56,5 +56,9 @@ public struct DataSourceDependencyAssembler: DependencyAssemblerProtocol {
         DIContainer.shared.register(type: ActivityHistoryRepositoryProtocol.self) { _ in
             return ActivityHistoryRepository()
         }
+
+        DIContainer.shared.register(type: YouthPolicyRepositoryProtocol.self) { _ in
+            return YouthPolicyRepository()
+        }
     }
 }

Projects/DataSource/Sources/DTO/YouthPolicyDTO.swift

@@ -0,0 +1,61 @@
+//
+//  YouthPolicyDTO.swift
+//  DataSource
+//
+
+import Domain
+import Foundation
+
+struct YouthPolicyDTO: Decodable {
+    let plcyNo: String
+    let title: String
+    let category: String?
+    let thumbnailUrl: String?
+    let status: String
+    let startDate: String?
+    let endDate: String?
+    let dday: Int?
+    let applyUrl: String?
+    let bookmarked: Bool
+}
+
+extension YouthPolicyDTO {
+    private static let dateFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.dateFormat = "yyyy-MM-dd"
+        formatter.locale = Locale(identifier: "en_US_POSIX")
+        formatter.timeZone = TimeZone(identifier: "Asia/Seoul")
+        return formatter
+    }()
+
+    func toYouthPolicyEntity() -> YouthPolicyEntity? {
+        guard let status = YouthPolicyStatus(rawValue: status) else { return nil }
+
+        return YouthPolicyEntity(
+            policyNumber: plcyNo,
+            title: title,
+            category: category,
+            thumbnailURL: thumbnailUrl,
+            status: status,
+            startDate: startDate.flatMap { Self.dateFormatter.date(from: $0) },
+            endDate: endDate.flatMap { Self.dateFormatter.date(from: $0) },
+            dday: dday,
+            applyURL: applyUrl,
+            isBookmarked: bookmarked)
+    }
+}
+
+struct YouthPolicyPageDTO: Decodable {
+    let totalCount: Int
+    let hasNext: Bool
+    let nextCursor: String?
+    let items: [YouthPolicyDTO]
+
+    func toYouthPolicyPageEntity() -> YouthPolicyPageEntity {
+        return YouthPolicyPageEntity(
+            policies: items.compactMap { $0.toYouthPolicyEntity() },
+            totalCount: totalCount,
+            hasNext: hasNext,
+            nextCursor: nextCursor)
+    }
+}

Projects/DataSource/Sources/Endpoint/YouthPolicyEndpoint.swift

@@ -0,0 +1,75 @@
+//
+//  YouthPolicyEndpoint.swift
+//  DataSource
+//
+
+enum YouthPolicyEndpoint {
+    case fetchPolicies(latitude: Double, longitude: Double, cursor: String?, size: Int?)
+    case fetchBookmarkedPolicies(cursor: String?, size: Int?)
+    case addBookmark(policyNumber: String)
+    case removeBookmark(policyNumber: String)
+}
+
+extension YouthPolicyEndpoint: Endpoint {
+    var baseURL: String {
+        return AppProperties.baseURL + "/api/v1/youth-policies"
+    }
+
+    var path: String {
+        switch self {
+        case .fetchPolicies:
+            return baseURL
+        case .fetchBookmarkedPolicies:
+            return "\(baseURL)/bookmarks"
+        case .addBookmark(let policyNumber), .removeBookmark(let policyNumber):
+            return "\(baseURL)/\(policyNumber)/bookmark"
+        }
+    }
+
+    var method: HTTPMethod {
+        switch self {
+        case .fetchPolicies, .fetchBookmarkedPolicies:
+            return .get
+        case .addBookmark:
+            return .post
+        case .removeBookmark:
+            return .delete
+        }
+    }
+
+    var headers: [String: String] {
+        let headers: [String: String] = [
+            "Content-Type": "application/json",
+            "accept": "*/*"
+        ]
+        return headers
+    }
+
+    var queryParameters: [String: String] {
+        switch self {
+        case .fetchPolicies(let latitude, let longitude, let cursor, let size):
+            var parameters = [
+                "latitude": "\(latitude)",
+                "longitude": "\(longitude)"
+            ]
+            if let cursor { parameters["cursor"] = cursor }
+            if let size { parameters["size"] = "\(size)" }
+            return parameters
+        case .fetchBookmarkedPolicies(let cursor, let size):
+            var parameters: [String: String] = [:]
+            if let cursor { parameters["cursor"] = cursor }
+            if let size { parameters["size"] = "\(size)" }
+            return parameters
+        case .addBookmark, .removeBookmark:
+            return [:]
+        }
+    }
+
+    var bodyParameters: [String: Any] {
+        return [:]
+    }
+
+    var isAuthorized: Bool {
+        return true
+    }
+}

Projects/DataSource/Sources/Repository/YouthPolicyRepository.swift

@@ -0,0 +1,81 @@
+//
+//  YouthPolicyRepository.swift
+//  DataSource
+//
+
+import Domain
+import Foundation
+
+final class YouthPolicyRepository: YouthPolicyRepositoryProtocol {
+    private let networkService = NetworkService.shared
+
+    func fetchPolicies(
+        latitude: Double,
+        longitude: Double,
+        cursor: String?,
+        size: Int?
+    ) async throws -> YouthPolicyPageEntity {
+        let endpoint = YouthPolicyEndpoint.fetchPolicies(
+            latitude: latitude,
+            longitude: longitude,
+            cursor: cursor,
+            size: size)
+
+        return try await fetchPage(endpoint: endpoint)
+    }
+
+    func fetchBookmarkedPolicies(
+        cursor: String?,
+        size: Int?
+    ) async throws -> YouthPolicyPageEntity {
+        let endpoint = YouthPolicyEndpoint.fetchBookmarkedPolicies(cursor: cursor, size: size)
+
+        return try await fetchPage(endpoint: endpoint)
+    }
+
+    func addBookmark(policyNumber: String) async throws {
+        let endpoint = YouthPolicyEndpoint.addBookmark(policyNumber: policyNumber)
+
+        try await updateBookmark(endpoint: endpoint)
+    }
+
+    func removeBookmark(policyNumber: String) async throws {
+        let endpoint = YouthPolicyEndpoint.removeBookmark(policyNumber: policyNumber)
+
+        try await updateBookmark(endpoint: endpoint)
+    }
+
+    private func fetchPage(endpoint: YouthPolicyEndpoint) async throws -> YouthPolicyPageEntity {
+        do {
+            guard let response = try await networkService.request(endpoint: endpoint, type: YouthPolicyPageDTO.self)
+            else { return YouthPolicyPageEntity(policies: [], totalCount: 0, hasNext: false, nextCursor: nil) }
+
+            return response.toYouthPolicyPageEntity()
+        } catch let error as NetworkError {
+            throw error.toDomainError()
+        } catch {
+            throw DomainError.unknown
+        }
+    }
+
+    private func updateBookmark(endpoint: YouthPolicyEndpoint) async throws {
+        do {
+            _ = try await networkService.request(endpoint: endpoint, type: EmptyResponseDTO.self)
+        } catch let error as NetworkError {
+            throw error.toDomainError()
+        } catch {
+            throw DomainError.unknown
+        }
+    }
+}
+
+private extension NetworkError {
+    func toDomainError() -> DomainError {
+        switch self {
+        case .needRetry, .invalidURL, .emptyData:
+            return DomainError.requireRetry
+        default:
+            return DomainError.business(description)
+        }
+    }
+}

Projects/Domain/Sources/DomainDependencyAssembler.swift

@@ -75,5 +75,16 @@ public struct DomainDependencyAssembler: DependencyAssemblerProtocol {
                 reportRepository: reportRepository,
                 fileRepository: fileRepository)
         }
+
+        DIContainer.shared.register(type: YouthPolicyUseCaseProtocol.self) { container in
+            guard
+                let youthPolicyRepository = container.resolve(type: YouthPolicyRepositoryProtocol.self),
+                let locationRepository = container.resolve(type: LocationRepositoryProtocol.self)
+            else { fatalError("youthPolicyUseCase에 필요한 의존성이 등록되지 않았습니다.") }
+
+            return YouthPolicyUseCase(
+                youthPolicyRepository: youthPolicyRepository,
+                locationRepository: locationRepository)
+        }
     }
 }

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

@@ -0,0 +1,13 @@
+//
+//  YouthPolicyStatus.swift
+//  Domain
+//
+
+public enum YouthPolicyStatus: String {
+    /// 신청 기간 내 (마감 전)
+    case open = "OPEN"
+    /// 상시 모집
+    case always = "ALWAYS"
+    /// 마감됨. 찜 목록에서만 내려옵니다.
+    case closed = "CLOSED"
+}

Projects/Domain/Sources/Entity/YouthPolicyEntity.swift

@@ -0,0 +1,50 @@
+//
+//  YouthPolicyEntity.swift
+//  Domain
+//
+
+import Foundation
+
+public struct YouthPolicyEntity {
+    /// 공고 고유 번호. 찜 등록/해제 시 이 값을 사용합니다.
+    public let policyNumber: String
+    public let title: String
+    /// 대분류(일자리·주거·교육 등). 일부 공고에서 nil.
+    public let category: String?
+    /// 원본 API에 이미지가 없어 현재는 항상 nil입니다. 클라이언트 기본 이미지를 사용하세요.
+    public let thumbnailURL: String?
+    public let status: YouthPolicyStatus
+    /// 신청 시작일. 상시/마감 공고에서 nil 가능.
+    public let startDate: Date?
+    /// 신청 마감일. 상시 공고는 nil.
+    public let endDate: Date?
+    /// 마감까지 남은 일수(오늘 = 0). status가 open이 아니면 nil.
+    public let dday: Int?
+    /// 외부 신청 페이지 URL. 없을 수 있습니다.
+    public let applyURL: String?
+    public let isBookmarked: Bool
+
+    public init(
+        policyNumber: String,
+        title: String,
+        category: String?,
+        thumbnailURL: String?,
+        status: YouthPolicyStatus,
+        startDate: Date?,
+        endDate: Date?,
+        dday: Int?,
+        applyURL: String?,
+        isBookmarked: Bool
+    ) {
+        self.policyNumber = policyNumber
+        self.title = title
+        self.category = category
+        self.thumbnailURL = thumbnailURL
+        self.status = status
+        self.startDate = startDate
+        self.endDate = endDate
+        self.dday = dday
+        self.applyURL = applyURL
+        self.isBookmarked = isBookmarked
+    }
+}

Projects/Domain/Sources/Entity/YouthPolicyPageEntity.swift

@@ -0,0 +1,25 @@
+//
+//  YouthPolicyPageEntity.swift
+//  Domain
+//
+
+public struct YouthPolicyPageEntity {
+    public let policies: [YouthPolicyEntity]
+    /// 필터링된 전체 건수. 탭의 "전체 N" 표기용이며 페이지마다 동일하게 내려옵니다.
+    public let totalCount: Int
+    public let hasNext: Bool
+    /// 다음 페이지 요청에 그대로 넘길 불투명 토큰. hasNext가 false면 nil.
+    public let nextCursor: String?
+
+    public init(
+        policies: [YouthPolicyEntity],
+        totalCount: Int,
+        hasNext: Bool,
+        nextCursor: String?
+    ) {
+        self.policies = policies
+        self.totalCount = totalCount
+        self.hasNext = hasNext
+        self.nextCursor = nextCursor
+    }
+}

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

@@ -0,0 +1,39 @@
+//
+//  YouthPolicyRepositoryProtocol.swift
+//  Domain
+//
+
+public protocol YouthPolicyRepositoryProtocol {
+
+    /// 현위치 기준 청년 공고 목록을 조회합니다. 마감된 공고는 제외됩니다.
+    /// - Parameters:
+    ///   - latitude: 현재 위도
+    ///   - longitude: 현재 경도
+    ///   - cursor: 이전 응답의 nextCursor. 첫 페이지는 nil
+    ///   - size: 페이지 크기. nil이면 서버 기본값(10) 사용
+    /// - Returns: 공고 페이지
+    func fetchPolicies(
+        latitude: Double,
+        longitude: Double,
+        cursor: String?,
+        size: Int?
+    ) async throws -> YouthPolicyPageEntity
+
+    /// 찜한 공고 목록을 조회합니다. 지역과 무관하며 마감된 공고도 포함됩니다.
+    /// - Parameters:
+    ///   - cursor: 이전 응답의 nextCursor. 첫 페이지는 nil
+    ///   - size: 페이지 크기. nil이면 서버 기본값(10) 사용
+    /// - Returns: 공고 페이지
+    func fetchBookmarkedPolicies(
+        cursor: String?,
+        size: Int?
+    ) async throws -> YouthPolicyPageEntity
+
+    /// 공고를 찜 목록에 추가합니다. 멱등이므로 이미 찜한 공고를 다시 호출해도 성공합니다.
+    /// - Parameter policyNumber: 공고 번호
+    func addBookmark(policyNumber: String) async throws
+
+    /// 공고를 찜 목록에서 제거합니다. 멱등이므로 찜하지 않은 공고를 해제해도 성공합니다.
+    /// - Parameter policyNumber: 공고 번호
+    func removeBookmark(policyNumber: String) async throws
+}