[NL-73]: 홈 화면 API 연동 및 로또 추천 로딩 화면 구현 (#43)

* [NL-73]: 로또 번호 추천 확인 API 연동

* [NL-73]: develop 빌드 에러 해결

* [NL-73]: Kingfisher 의존성 추가

* [NL-73]: 홈 API 연동

* [NL-73]: 폴더링

* [NL-73]: 로또 번호 추천 로딩 화면 구현

* [NL-73]: hidesBottomBarWhenPushed 옵션 구현

Author: TTOzzi

App/Sources/AppDelegate+Assembly.swift

@@ -13,6 +13,7 @@ import Lib
 import NetworkCore
 import Onboarding
 import Setting
+import Home
 
 extension AppDelegate {
   func setupDependencyInjector() {
@@ -23,6 +24,7 @@ extension AppDelegate {
       LibAssembly(),
       FortuneAssembly(),
       OnboardingAssembly(),
+      HomeAssembly()
     ])
   }
 }

App/Sources/AppDependencyHandler.swift

@@ -27,10 +27,10 @@ struct AppDependencyHandler: DependencyRegistrable {
     // TODO: 이미 TabBarController 가 있는 경우에 대한 예외 처리
     let tabBarController = BaseTabBarController()
     tabBarController.viewControllers = [
-      HomeViewController(viewModel: HomeViewModel()),
-      FortuneViewController(viewModel: FortuneViewModel()),
-      HistoryWebViewController(viewModel: HistoryWebViewModel()),
-      MyPageViewController(viewModel: MyPageViewModel()),
+      BaseNavigationController(rootViewController: HomeViewController(viewModel: HomeViewModel())),
+      BaseNavigationController(rootViewController: FortuneViewController(viewModel: FortuneViewModel())),
+      BaseNavigationController(rootViewController: HistoryWebViewController(viewModel: HistoryWebViewModel())),
+      BaseNavigationController(rootViewController: MyPageViewController(viewModel: MyPageViewModel())),
     ]
     UIApplication.shared.activeWindow?.rootViewController = tabBarController
   }

Common/Auth/Sources/UserDataManager.swift

@@ -16,10 +16,10 @@ public final class UserDataManager {
   @Injected private var deviceUUIDManager: DeviceUUIDManager
   @Injected private var networkProvider: NetworkProvider
   public var user: UserDTO?
+  public var userID: String { user?.id ?? deviceUUIDManager.deviceUUID }
 
   @discardableResult
   public func fetch() async throws -> UserDTO {
-    let userID = user?.id ?? deviceUUIDManager.deviceUUID
     let target = AuthTarget.GetUser(userID: userID)
     do {
       let user = try await networkProvider.request(target: target)
@@ -35,7 +35,6 @@ public final class UserDataManager {
   public func create(name: String, birthDate: String, birthTime: [String]?, gender: GenderDTO)
     async throws -> UserDTO
   {
-    let userID = user?.id ?? deviceUUIDManager.deviceUUID
     let userModel = UserModel(
       id: userID, name: name, birthDate: birthDate, birthTime: birthTime, gender: gender)
     let target = AuthTarget.PostUser(userModel: userModel)
@@ -52,7 +51,6 @@ public final class UserDataManager {
   public func update(name: String, birthDate: String, birthTime: [String]?, gender: GenderDTO)
     async throws -> UserDTO
   {
-    let userID = user?.id ?? deviceUUIDManager.deviceUUID
     let userModel = UserModel(
       id: userID, name: name, birthDate: birthDate, birthTime: birthTime, gender: gender)
     let target = AuthTarget.PutUser(userModel: userModel)

Common/Base/Sources/BaseViewController.swift

@@ -53,7 +53,6 @@ open class BaseViewController: UIViewController {
     navigationController?.setNavigationBarHidden(true, animated: false)
     view.addSubview(navigationBar)
     navigationBar.snp.makeConstraints { make in
-      make.top.equalTo(view.snp.top)
       make.bottom.equalTo(view.safeAreaLayoutGuide.snp.top)
       make.horizontalEdges.equalToSuperview()
     }

Common/Base/Sources/Navigation/BaseNavigationController.swift

@@ -0,0 +1,40 @@
+//
+//  BaseNavigationController.swift
+//  Base
+//
+//  Created by ttozzi on 8/17/25.
+//
+
+import UIKit
+
+public final class BaseNavigationController: UINavigationController {
+
+  public override func pushViewController(_ viewController: UIViewController, animated: Bool) {
+    if viewController.hidesBottomBarWhenPushed {
+      (tabBarController as? BaseTabBarController)?.setTabBarHidden(true, animated: false)
+    }
+    super.pushViewController(viewController, animated: animated)
+  }
+
+  @discardableResult
+  public override func popViewController(animated: Bool) -> UIViewController? {
+    let popped = super.popViewController(animated: animated)
+    let top = topViewController
+    let shouldHideTabBar = top?.hidesBottomBarWhenPushed ?? false
+    (tabBarController as? BaseTabBarController)?.setTabBarHidden(shouldHideTabBar, animated: false)
+    return popped
+  }
+
+  public override func popToViewController(_ viewController: UIViewController, animated: Bool) -> [UIViewController]? {
+    let poppedControllers = super.popToViewController(viewController, animated: animated)
+    (tabBarController as? BaseTabBarController)?.setTabBarHidden(viewController.hidesBottomBarWhenPushed, animated: false)
+    return poppedControllers
+  }
+
+  public override func popToRootViewController(animated: Bool) -> [UIViewController]? {
+    let poppedControllers = super.popToRootViewController(animated: animated)
+    let shouldHideTabBar = viewControllers.first?.hidesBottomBarWhenPushed ?? false
+    (tabBarController as? BaseTabBarController)?.setTabBarHidden(shouldHideTabBar, animated: false)
+    return poppedControllers
+  }
+}

Common/Base/Sources/NavigationBarItem.swift

@@ -25,6 +25,12 @@ public final class NaivgationBarButtonItem: UIButton, NavigationBarItem {
       make.size.equalTo(24)
     }
   }
+  
+  override public func tintColorDidChange() {
+    super.tintColorDidChange()
+    let image = image(for: .normal)?.withRenderingMode(.alwaysTemplate)
+    setImage(image?.withTintColor(tintColor), for: .normal)
+  }
 }
 
 extension NaivgationBarButtonItem {

Common/Base/Sources/TabBar/BaseTabBarController.swift

@@ -33,6 +33,10 @@ public final class BaseTabBarController: UITabBarController {
       }
     }
   }
+  
+  override public func setTabBarHidden(_ hidden: Bool, animated: Bool) {
+    customTabBar.isHidden = hidden
+  }
 
   private func setupTabBar() {
     tabBar.isHidden = true

Common/Lib/Sources/Router/AppRouter.swift

@@ -34,8 +34,9 @@ extension Routable {
 
   public func manageViewController(_ viewController: UIViewController, how: NavigateType) {
     switch how {
-    case .push:
+    case .push(let hidesBottomBarWhenPushed):
       if let navigationController = topViewController()?.navigationController {
+        viewController.hidesBottomBarWhenPushed = hidesBottomBarWhenPushed
         navigationController.pushViewController(viewController, animated: true)
       }
     case .present:

Common/Lib/Sources/Router/Concreate/NavigateType.swift

@@ -6,7 +6,7 @@
 //
 
 public enum NavigateType {
-  case push  // NavigationController.pushViewController
+  case push(hidesBottomBarWhenPushed: Bool = false)  // NavigationController.pushViewController
   case present  // 기본 present (모달)
   case fullscreen  // modalPresentationStyle = .fullScreen
   case currentContext  // modalPresentationStyle = .currentContext

Common/Project.swift

@@ -45,6 +45,7 @@ struct CommonLayer: Layer {
         dependencies: [
           .external(name: "Then"),
           .external(name: "SnapKit"),
+          .external(name: "Kingfisher"),
           .project(target: "CoreLayer", path: "../Core"),
         ]
       ),