Feat: 온보딩 여부 저장 및 분기 처리

* Feat: 온보딩 여부 저장 및 불러오기, 삭제 로직 구현

- 온보딩 여부 저장, 불러오기, 삭제 로직 구현
- 필요없는 profileImageUrl 저장, 불러오기, 삭제 로직 제거

* Feat: 온보딩 여부에 따른 진입 뷰 분기 처리

- 온보딩 여부에 따른 진입 뷰 분기 처리
- 그에 따른 ViewController, ViewModel 접근제어자 변경 (internal -> public)

* Feat: 온보딩 네비게이션 Background 색상 변경

* Refactor: 코드 리뷰 반영

- 중복된 네비게이션 바 Appearance 설정 제거
- OnboardingView viewDidLoad 제거

* Refactor: 온보딩 첫 화면에서 백버튼 제거

Author: choijungp

Projects/App/Sources/SceneDelegate.swift

@@ -54,10 +54,22 @@ extension SceneDelegate: SplashViewDelegate {
         guard let userDataRepository = DIContainer.shared.resolve(type: UserDataRepositoryProtocol.self)
         else { fatalError("userDataRepository 의존성이 등록되지 않았습니다.") }
 
+        guard let onboardingRepository = DIContainer.shared.resolve(type: OnboardingRepositoryProtocol.self)
+        else { fatalError("onboardingRepository 의존성이 등록되지 않았습니다.") }
+
         Task { @MainActor in
             let isLogined = await userDataRepository.reissueToken()
             if isLogined {
-                window?.rootViewController = TabBarView()
+                if onboardingRepository.isOnboardingDone() {
+                    window?.rootViewController = TabBarView()
+                } else {
+                    guard let onboardingViewModel = DIContainer.shared.resolve(type: OnboardingViewModel.self) else {
+                        fatalError("onboardingViewModel 의존성이 등록되지 않았습니다.")
+                    }
+                    let onboardingView = OnboardingView(viewModel: onboardingViewModel, onboarding: .time)
+                    let navigationController = UINavigationController(rootViewController: onboardingView)
+                    window?.rootViewController = navigationController
+                }
             } else {
                 let introView = IntroView()
                 let navigationController = UINavigationController(rootViewController: introView)

Projects/DataSource/Sources/Common/Enum/UserDefaultsKey.swift

@@ -8,5 +8,5 @@
 enum UserDefaultsKey: String {
     case nickname
     case socialLoginType
-    case profileImageUrl
+    case onboarding
 }

Projects/DataSource/Sources/Common/Error/UserError.swift

@@ -12,9 +12,9 @@ enum UserError: Error, CustomStringConvertible {
     case socialLoginTypeSaveFailed
     case socialLoginTypeLoadFailed
     case socialLoginTypeRemoveFailed
-    case profileImageUrlSaveFailed
-    case profileImageUrlLoadFailed
-    case profileImageUrlRemoveFailed
+    case onboardingSaveFailed
+    case onboardingLoadFailed
+    case onboardingRemoveFailed
     case unknown(error: Error)
 
     var description: String {
@@ -31,12 +31,12 @@ enum UserError: Error, CustomStringConvertible {
             return "소셜 로그인 타입 불러오기에 실패했습니다."
         case .socialLoginTypeRemoveFailed:
             return "소셜 로그인 타입 삭제 실패했습니다."
-        case .profileImageUrlSaveFailed:
-            return "유저 프로필 저장 실패했습니다."
-        case .profileImageUrlLoadFailed:
-            return "유저 프로필 불러오기에 실패했습니다."
-        case .profileImageUrlRemoveFailed:
-            return "유저 프로필 삭제 실패했습니다."
+        case .onboardingSaveFailed:
+            return "온보딩 여부 저장 실패했습니다."
+        case .onboardingLoadFailed:
+            return "온보딩 여부 불러오기에 실패했습니다."
+        case .onboardingRemoveFailed:
+            return "온보딩 여부를 삭제하는데 실패했습니다."
         case .unknown(let error):
             return "알 수 없는 에러가 발생했습니다. \(error.localizedDescription)"
         }

Projects/DataSource/Sources/Repository/AuthRepository.swift

@@ -138,13 +138,6 @@ final class AuthRepository: AuthRepositoryProtocol {
         }
     }
 
-    // UserDefaults에 프로필 이미지를 저장합니다.
-    private func saveUserProfileImageUrl(profileImageUrl: URL) throws {
-        guard userDefaultsStorage.save(profileImageUrl.absoluteString, forKey: UserDefaultsKey.profileImageUrl.rawValue) else {
-            throw UserError.profileImageUrlSaveFailed
-        }
-    }
-
     // UserDefaults에 저장된 유저 정보(닉네임, 소셜 로그인 타입, 프로필 이미지)를 삭제합니다.
     private func removeUserInfo() throws {
         guard userDefaultsStorage.remove(forKey: UserDefaultsKey.nickname.rawValue) else {
@@ -155,8 +148,9 @@ final class AuthRepository: AuthRepositoryProtocol {
             throw UserError.socialLoginTypeRemoveFailed
         }
 
-        guard userDefaultsStorage.remove(forKey: UserDefaultsKey.profileImageUrl.rawValue) else {
-            throw UserError.profileImageUrlRemoveFailed
+        guard userDefaultsStorage.remove(forKey: UserDefaultsKey.onboarding.rawValue) else {
+            throw UserError.onboardingRemoveFailed
         }
+
     }
 }

Projects/DataSource/Sources/Repository/OnboardingRepository.swift

@@ -9,16 +9,27 @@ import Domain
 
 final class OnboardingRepository: OnboardingRepositoryProtocol {
     private let networkService = NetworkService.shared
+    private let userDefaultsStorage = UserDefaultsStorage.shared
 
     func registerOnboarding(onboardingChoices: [String : String]) async throws -> [RecommendedRoutineEntity] {
         let endpoint = OnboardingEndpoint.registerOnboarding(choices: onboardingChoices)
         guard let response = try await networkService.request(endpoint: endpoint, type: RecommendedRoutineListResponseDTO.self)
         else { return [] }
 
+        guard userDefaultsStorage.save(true, forKey: UserDefaultsKey.onboarding.rawValue)
+        else { throw UserError.onboardingSaveFailed }
+
         let recommendedRoutineEntity = response.recommendedRoutines.compactMap({ $0.toRecommendedRoutineEntity() })
         return recommendedRoutineEntity
     }
 
+    func isOnboardingDone() -> Bool {
+        guard let isOnboardingDone: Bool = userDefaultsStorage.load(forKey: UserDefaultsKey.onboarding.rawValue)
+        else { return false }
+
+        return isOnboardingDone
+    }
+
     func registerRecommendedRoutines(selectedRoutines: [Int]) async throws {
         let endpoint = OnboardingEndpoint.registerRecommendedRoutine(selectedRoutines: selectedRoutines)
         _ = try await networkService.request(endpoint: endpoint, type: EmptyResponseDTO.self)

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

@@ -14,4 +14,8 @@ public protocol OnboardingRepositoryProtocol {
     /// 선택한 추천 루틴을 등록합니다.
     /// - Parameter selectedRoutines: 선택한 추천 루틴 ID 목록
     func registerRecommendedRoutines(selectedRoutines: [Int]) async throws
+
+    /// 온보딩 여부를 반환합니다.
+    /// - Returns: 온보딩 여부
+    func isOnboardingDone() -> Bool
 }

Projects/Presentation/Sources/Common/Extension/UIViewController+.swift

@@ -10,13 +10,6 @@ import UIKit
 extension UIViewController {
     // MARK: - NavigationBar
     func configureNavigationBar(navigationStyle: NavigationBarStyle) {
-        let appearance = UINavigationBarAppearance()
-        appearance.backgroundEffect = .none
-        appearance.configureWithOpaqueBackground()
-        appearance.shadowColor = .clear
-        navigationController?.navigationBar.standardAppearance = appearance
-        navigationController?.navigationBar.scrollEdgeAppearance = appearance
-
         switch navigationStyle {
         case .hidden:
             navigationController?.setNavigationBarHidden(true, animated: false)
@@ -35,6 +28,11 @@ extension UIViewController {
             navigationController?.setNavigationBarHidden(false, animated: false)
             configureCustomBackButton()
             configureProgressNavigationBar(step: step, stepCount: stepCount)
+
+        case .withPrograssBarWithoutBackButton(let step, let stepCount):
+            navigationController?.setNavigationBarHidden(false, animated: false)
+            navigationController?.navigationItem.setHidesBackButton(true, animated: false)
+            configureProgressNavigationBar(step: step, stepCount: stepCount)
         }
     }
 
@@ -46,6 +44,7 @@ extension UIViewController {
             action: #selector(popViewController))
         backButton.tintColor = .black
         navigationItem.leftBarButtonItem = backButton
+        changeNavigationBackground(color: .white)
     }
 
     private func configureCustomBackButton() {
@@ -56,12 +55,14 @@ extension UIViewController {
             action: #selector(popTwoViewControllers))
         backButton.tintColor = .black
         navigationItem.leftBarButtonItem = backButton
+        changeNavigationBackground(color: .white)
     }
 
     private func configureProgressNavigationBar(step: Int, stepCount: Int) {
         self.title = ""
         let progressView = ProgressBarView(step: step, stepCount: stepCount)
         navigationItem.titleView = progressView
+        changeNavigationBackground(color: BitnagilColor.gray99)
     }
 
     @objc private func popViewController() {
@@ -82,6 +83,17 @@ extension UIViewController {
         navigationController.popToViewController(targetViewController, animated: true)
     }
 
+    private func changeNavigationBackground(color: UIColor?) {
+        let appearance = UINavigationBarAppearance()
+        appearance.configureWithOpaqueBackground()
+        appearance.backgroundColor = color
+        appearance.shadowColor = .clear
+
+        navigationController?.navigationBar.standardAppearance = appearance
+        navigationController?.navigationBar.scrollEdgeAppearance = appearance
+        navigationController?.navigationBar.compactAppearance = appearance
+    }
+
     // MARK: - BottomSheet
     func presentCustomBottomSheet(contentViewController: UIViewController, maxHeight: CGFloat) {
         let bottomSheet = CustomBottomSheet(contentViewController: contentViewController, maxHeight: maxHeight)
@@ -94,4 +106,5 @@ enum NavigationBarStyle {
     case withBackButton(title: String)
     case withPrograssBar(step: Int, stepCount: Int)
     case withPrograssBarWithCustomBackButton(step: Int, stepCount: Int)
+    case withPrograssBarWithoutBackButton(step: Int, stepCount: Int)
 }

Projects/Presentation/Sources/Common/Protocol/BaseViewController.swift

@@ -7,7 +7,7 @@
 
 import UIKit
 
-class BaseViewController<T: ViewModel>: UIViewController {
+public class BaseViewController<T: ViewModel>: UIViewController {
     let viewModel: T
 
     init(viewModel: T) {
@@ -19,7 +19,7 @@ class BaseViewController<T: ViewModel>: UIViewController {
         fatalError("init(coder:) has not been implemented")
     }
 
-    override func viewDidLoad() {
+    public override func viewDidLoad() {
         super.viewDidLoad()
 
         configureAttribute()

Projects/Presentation/Sources/Common/Protocol/ViewModel.swift

@@ -5,7 +5,7 @@
 //  Created by 최정인 on 6/26/25.
 //
 
-protocol ViewModel {
+public protocol ViewModel {
     associatedtype Input
     associatedtype Output
 

Projects/Presentation/Sources/Home/View/HomeView.swift

@@ -102,6 +102,7 @@ final class HomeView: BaseViewController<HomeViewModel> {
 
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
+        configureNavigationBar(navigationStyle: .hidden)
         viewModel.action(input: .fetchEmotion)
     }