iOS Quiz Challenge - João Marcus

[kiyo92]

Summary

Implemented the iOS Quiz Challenge app with a SwiftUI-based quiz flow, API integration, local persistence, ranking, result screen, timer-based scoring, unit tests, snapshot tests, and project documentation.

What Was Implemented

• Nickname entry flow before starting the quiz.
• 10-question quiz flow.
• Question loading via GET /question.
• Answer validation via POST /answer?questionId=$id.
• Visual feedback for correct/incorrect answers before moving to the next question.
• 120-second quiz timer.
• Automatic quiz finish when the timer reaches zero.
• Final score calculation using correctAnswers * remainingSeconds.
• Result screen with saved score feedback and restart option.
• Ranking screen with locally persisted best score per nickname.
• Local persistence using UserDefaults.
• Dependency injection for app services.
• Feature-based architecture with Configurator, Interactor, Presenter, Router, View/ViewState, Domain, and Service layers.
• Unit tests for main business logic.
• Unit-style snapshot tests for key views/components.
• README with setup, test, architecture, and product decision notes.

Product Decisions

• The ranking stores the best score per nickname instead of every quiz attempt, providing a clearer leaderboard experience.
• The main UI is implemented with SwiftUI.
• Snapshot tests instantiate views/components directly with mocks/spies instead of running end-to-end UI navigation.

Testing

• Added/updated tests for quiz flow, timer finish, scoring, persistence, result, ranking, and entry use cases.
• Added snapshot coverage for entry, quiz options, result, and ranking views.

Notes

• The quiz API host is https://quiz-api-bwi5hjqyaq-uc.a.run.app.
• To simulate the error state, temporarily change the question endpoint path from question to an invalid path in QuizService.swift.

Visual Reference

Screenshots