[Feat] 퀴즈 화면 및 기능 구현

Wable-iOS/App/AppDelegate+InjectDependency.swift

@@ -101,12 +101,21 @@ extension AppDelegate {
         }
 
         // MARK: - Community
-        
+
         diContainer.register(for: CommunityRepository.self) { env in
             switch env {
             case .mock: MockCommunityRepository()
             case .production: CommunityRepositoryImpl()
             }
         }
+
+        // MARK: - Quiz
+
+        diContainer.register(for: QuizRepository.self) { env in
+            switch env {
+            case .mock: MockQuizRepository()
+            case .production: QuizRepositoryImpl()
+            }
+        }
     }
 }

Wable-iOS/Core/Literals/String/StringLiterals+Quiz.swift

@@ -0,0 +1,26 @@
+//
+//  StringLiterals+Quiz.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/26/25.
+//
+
+import Foundation
+
+extension StringLiterals {
+
+    // MARK: - Quiz
+
+    enum Quiz {
+        static let correctTitle = "걸어다니는 LCK 백과사전"
+        static let correctDescription = "정답을 맞추셨어요. 대단해요!"
+        static let incorrectTitle = "LCK의 평범한 시청자!"
+        static let incorrectDescription = "정답은 틀렸지만, 좋은 시도였어요!\n다음 기회를 노려봐요"
+        static let nextQuizTitle = "다음 퀴즈 참여까지\n남은 시간"
+        static let feedbackTitle = "와블에 대한 새로운 의견이 있다면? →"
+        static let loadingErrorTitle = "퀴즈 로딩 중 오류가 발생했어요"
+        static let rewardErrorTitle = "리워드 처리 중 오류가 발생했어요"
+        static let loadingErrorMessage = "다시 시도해주세요."
+
+    }
+}

Wable-iOS/Data/Mapper/QuizMapper.swift

@@ -0,0 +1,29 @@
+//
+//  QuizMapper.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/25/25.
+//
+
+import Foundation
+
+enum QuizMapper { }
+
+extension QuizMapper {
+    static func toDomain(_ response: DTO.Response.FetchQuiz) -> Quiz {
+        return Quiz(
+            id: response.id,
+            imageURL: response.imageURL,
+            text: response.text,
+            answer: response.answer
+        )
+    }
+
+    static func toDomain(_ response: DTO.Response.UpdateQuizGradeResponse) -> QuizResult {
+        return QuizResult(
+            isCorrect: response.answer,
+            topPercent: response.topPercent,
+            continueDay: response.continueDay
+        )
+    }
+}

Wable-iOS/Data/RepositoryImpl/QuizRepositoryImpl.swift

@@ -0,0 +1,67 @@
+//
+//  QuizRepositoryImpl.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/25/25.
+//
+
+import Combine
+import Foundation
+
+import CombineMoya
+import Moya
+
+final class QuizRepositoryImpl {
+    private let provider: APIProvider<QuizTargetType>
+
+    init(provider: APIProvider<QuizTargetType> = .init()) {
+        self.provider = provider
+    }
+}
+
+extension QuizRepositoryImpl: QuizRepository {
+    func updateQuizAnswer(id: Int, answer: Bool, totalTime: Int) -> AnyPublisher<QuizResult, WableError> {
+        let request = DTO.Request.UpdateQuizGradeRequest(
+            id: id,
+            answer: answer,
+            totalTime: totalTime
+        )
+
+        return provider.request(.updateQuizGrade(request: request), for: DTO.Response.UpdateQuizGradeResponse.self)
+            .map(QuizMapper.toDomain)
+            .mapWableError()
+    }
+
+    func fetchQuiz() -> AnyPublisher<Quiz, WableError> {
+        return provider.request(.fetchQuiz, for: DTO.Response.FetchQuiz.self)
+            .map(QuizMapper.toDomain)
+            .mapWableError()
+    }
+}
+
+struct MockQuizRepository: QuizRepository {
+    private var randomDelay: TimeInterval { Double.random(in: 0.7...1.3) }
+
+    func updateQuizAnswer(id: Int, answer: Bool, totalTime: Int) -> AnyPublisher<QuizResult, WableError> {
+        return .just(QuizResult(
+            isCorrect: false,
+            topPercent: Int.random(in: 1...99),
+            continueDay: Int.random(in: 1...99)
+        ))
+        .delay(for: .seconds(randomDelay), scheduler: DispatchQueue.main)
+        .eraseToAnyPublisher()
+    }
+
+    func fetchQuiz() -> AnyPublisher<Quiz, WableError> {
+        return .just(
+            Quiz(
+                id: Int.random(in: 1...9999),
+                imageURL: "https://i.ytimg.com/vi/yebNIHKAC4A/hqdefault.jpg",
+                text: "이 룬은 칼날비라는 룬으로 적에게 기본 공격을 3번 가하면 일정 시간 동안 공격 속도가 크게 증가하는 룬이다.",
+                answer: true
+            )
+        )
+        .delay(for: .seconds(randomDelay), scheduler: DispatchQueue.main)
+        .eraseToAnyPublisher()
+    }
+}

Wable-iOS/Data/RepositoryImpl/UserSessionRepositoryImpl.swift

@@ -54,7 +54,8 @@ extension UserSessionRepositoryImpl: UserSessionRepository {
         isPushAlarmAllowed: Bool? = nil,
         isAdmin: Bool? = nil,
         isAutoLoginEnabled: Bool? = nil,
-        notificationBadgeCount: Int? = nil
+        notificationBadgeCount: Int? = nil,
+        quizCompletedAt: Date? = nil
     ) {
         var sessions = fetchAllUserSessions()
         let existingSession = sessions[userID]
@@ -66,7 +67,8 @@ extension UserSessionRepositoryImpl: UserSessionRepository {
             isPushAlarmAllowed: isPushAlarmAllowed ?? existingSession?.isPushAlarmAllowed ?? false,
             isAdmin: isAdmin ?? existingSession?.isAdmin ?? false,
             isAutoLoginEnabled: isAutoLoginEnabled ?? existingSession?.isAutoLoginEnabled ?? true,
-            notificationBadgeCount: notificationBadgeCount ?? existingSession?.notificationBadgeCount ?? 0
+            notificationBadgeCount: notificationBadgeCount ?? existingSession?.notificationBadgeCount ?? 0,
+            quizCompletedAt: quizCompletedAt ?? existingSession?.quizCompletedAt
         )
 
         sessions[userID] = updatedSession

Wable-iOS/Domain/Entity/Quiz.swift

@@ -0,0 +1,15 @@
+//
+//  Quiz.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/25/25.
+//
+
+import Foundation
+
+struct Quiz: Hashable {
+    let id: Int
+    let imageURL: String
+    let text: String
+    let answer: Bool
+}

Wable-iOS/Domain/Entity/QuizResult.swift

@@ -0,0 +1,14 @@
+//
+//  QuizResult.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/26/25.
+//
+
+import Foundation
+
+public struct QuizResult {
+    let isCorrect: Bool
+    let topPercent: Int
+    let continueDay: Int
+}

Wable-iOS/Domain/Entity/UserSession.swift

@@ -16,4 +16,5 @@ struct UserSession: Codable, Identifiable {
     let isAdmin: Bool
     let isAutoLoginEnabled: Bool?
     let notificationBadgeCount: Int?
+    var quizCompletedAt: Date?
 }

Wable-iOS/Domain/RepositoryInterface/QuizRepository.swift

@@ -0,0 +1,14 @@
+//
+//  QuizRepository.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/25/25.
+//
+
+import Combine
+import Foundation
+
+protocol QuizRepository {
+    func updateQuizAnswer(id: Int, answer: Bool, totalTime: Int) -> AnyPublisher<QuizResult, WableError>
+    func fetchQuiz() -> AnyPublisher<Quiz, WableError>
+}

Wable-iOS/Domain/RepositoryInterface/UserSessionRepository.swift

@@ -22,7 +22,8 @@ protocol UserSessionRepository {
                            isPushAlarmAllowed: Bool?,
                            isAdmin: Bool?,
                            isAutoLoginEnabled: Bool?,
-                           notificationBadgeCount: Int?)
+                           notificationBadgeCount: Int?,
+                           quizCompletedAt: Date?)
     func updateActiveUserID(_ userID: Int?)
     func removeUserSession(forUserID userID: Int)
 }

Wable-iOS/Domain/UseCase/Home/FetchUserInformationUseCase.swift

@@ -45,7 +45,8 @@ extension FetchUserInformationUseCase {
         isPushAlarmAllowed: Bool? = nil,
         isAdmin: Bool? = nil,
         isAutoLoginEnabled: Bool? = nil,
-        notificationBadgeCount: Int? = nil
+        notificationBadgeCount: Int? = nil,
+        quizCompletedAt: Date? = nil
     ) -> AnyPublisher<Void, Never> {
         return Just(
             repository.updateUserSession(
@@ -55,7 +56,8 @@ extension FetchUserInformationUseCase {
                 isPushAlarmAllowed: isPushAlarmAllowed,
                 isAdmin: isAdmin,
                 isAutoLoginEnabled: isAutoLoginEnabled,
-                notificationBadgeCount: notificationBadgeCount
+                notificationBadgeCount: notificationBadgeCount,
+                quizCompletedAt: quizCompletedAt
             )
         )
         .eraseToAnyPublisher()

Wable-iOS/Infra/Network/DTO/Request/Quiz/UpdateQuizGradeRequest.swift

@@ -0,0 +1,22 @@
+//
+//  UpdateQuizGradeRequest.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/24/25.
+//
+
+import Foundation
+
+extension DTO.Request {
+    struct UpdateQuizGradeRequest: Encodable {
+        let id: Int
+        let answer: Bool
+        let totalTime: Int
+
+        enum CodingKeys: String, CodingKey {
+            case id = "quizId"
+            case answer = "userAnswer"
+            case totalTime = "quizTime"
+        }
+    }
+}

Wable-iOS/Infra/Network/DTO/Response/Quiz/FetchQuiz.swift

@@ -0,0 +1,24 @@
+//
+//  FetchQuiz.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/24/25.
+//
+
+import Foundation
+
+extension DTO.Response {
+    struct FetchQuiz: Decodable {
+        let id: Int
+        let imageURL: String
+        let text: String
+        let answer: Bool
+
+        enum CodingKeys: String, CodingKey {
+            case id = "quizId"
+            case imageURL = "quizImage"
+            case text = "quizText"
+            case answer = "quizAnswer"
+        }
+    }
+}

Wable-iOS/Infra/Network/DTO/Response/Quiz/UpdateQuizGradeResponse.swift

@@ -0,0 +1,22 @@
+//
+//  UpdateQuizGradeResponse.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/24/25.
+//
+
+import Foundation
+
+extension DTO.Response {
+    struct UpdateQuizGradeResponse: Decodable {
+        let answer: Bool
+        let topPercent: Int
+        let continueDay: Int
+
+        enum CodingKeys: String, CodingKey {
+            case answer = "quizResult"
+            case topPercent = "userPercent"
+            case continueDay = "continueNumber"
+        }
+    }
+}

Wable-iOS/Infra/Network/TargetType/QuizTargetType.swift

@@ -0,0 +1,54 @@
+//
+//  QuizTargetType.swift
+//  Wable-iOS
+//
+//  Created by Youjin Lee on 10/24/25.
+//
+
+import Combine
+import Foundation
+
+import Moya
+
+enum QuizTargetType {
+    case fetchQuiz
+    case updateQuizGrade(request: DTO.Request.UpdateQuizGradeRequest)
+}
+
+extension QuizTargetType: BaseTargetType {
+    var endPoint: String? {
+        switch self {
+        case .fetchQuiz:
+            "/v1/quiz"
+        case .updateQuizGrade:
+            "/v1/quiz/grade"
+        }
+    }
+
+    var query: [String : Any]? {
+        return .none
+    }
+
+    var requestBody: (any Encodable)? {
+        switch self {
+        case .fetchQuiz:
+            return .none
+        case .updateQuizGrade(request: let request):
+            return request
+        }
+    }
+
+    var multipartFormData: [Moya.MultipartFormData]? {
+        return .none
+    }
+
+    var method: Moya.Method {
+        switch self {
+        case .fetchQuiz:
+            return .get
+        case .updateQuizGrade:
+            return .patch
+        }
+    }
+}
+