추천 기능 구현 및 모듈 이전으로 인한 수정을 진행합니다.

MLS/MLS.xcodeproj/project.pbxproj

@@ -9,6 +9,7 @@
 /* Begin PBXBuildFile section */
 		085A7F752DAF99570046663F /* .swiftlint.yml in Resources */ = {isa = PBXBuildFile; fileRef = 085A7F742DAF99570046663F /* .swiftlint.yml */; };
 		088636972FB4664E00006D4A /* MLSRecommendationFeatureTesting in Frameworks */ = {isa = PBXBuildFile; productRef = 088636962FB4664E00006D4A /* MLSRecommendationFeatureTesting */; };
+		0898D45E2FD913470031ED17 /* MLSBookmarkFeatureTesting in Frameworks */ = {isa = PBXBuildFile; productRef = 0898D45D2FD913470031ED17 /* MLSBookmarkFeatureTesting */; };
 		08DA51B42E1B9827009097A6 /* FirebaseFirestore in Frameworks */ = {isa = PBXBuildFile; productRef = 08DA51B32E1B9827009097A6 /* FirebaseFirestore */; };
 		08DA51B62E1B9827009097A6 /* FirebaseMessaging in Frameworks */ = {isa = PBXBuildFile; productRef = 08DA51B52E1B9827009097A6 /* FirebaseMessaging */; };
 		08ED49282DCFDED4002C21A2 /* RxCocoa in Frameworks */ = {isa = PBXBuildFile; productRef = 08ED49272DCFDED4002C21A2 /* RxCocoa */; };
@@ -289,6 +290,7 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				0898D45E2FD913470031ED17 /* MLSBookmarkFeatureTesting in Frameworks */,
 				08F7DC802F9DEA8100EF5C06 /* MLSRecommendationFeature in Frameworks */,
 				08F7DC822F9DEA8100EF5C06 /* MLSRecommendationFeatureInterface in Frameworks */,
 				088636972FB4664E00006D4A /* MLSRecommendationFeatureTesting in Frameworks */,
@@ -561,6 +563,7 @@
 				08F7DC832F9DEA8100EF5C06 /* MLSRecommendationFeatureInterface */,
 				08F7DC852F9DEA8100EF5C06 /* MLSCore */,
 				088636962FB4664E00006D4A /* MLSRecommendationFeatureTesting */,
+				0898D45D2FD913470031ED17 /* MLSBookmarkFeatureTesting */,
 			);
 			productName = MLSRecommendationFeatureExample;
 			productReference = 08F7DC612F9DEA8000EF5C06 /* MLSRecommendationFeatureExample.app */;
@@ -1785,6 +1788,10 @@
 			isa = XCSwiftPackageProductDependency;
 			productName = MLSRecommendationFeatureTesting;
 		};
+		0898D45D2FD913470031ED17 /* MLSBookmarkFeatureTesting */ = {
+			isa = XCSwiftPackageProductDependency;
+			productName = MLSBookmarkFeatureTesting;
+		};
 		08DA51B32E1B9827009097A6 /* FirebaseFirestore */ = {
 			isa = XCSwiftPackageProductDependency;
 			package = 08DA51B22E1B9827009097A6 /* XCRemoteSwiftPackageReference "firebase-ios-sdk" */;

MLS/MLSAppFeature/Package.swift

@@ -37,7 +37,9 @@ let package = Package(
         // Interface 모듈 (도메인 모델 및 프로토콜)
         .target(
             name: "MLSAppFeatureInterface",
-            dependencies: []
+            dependencies: [
+                .product(name: "MLSCore", package: "MLSCore")
+            ]
         ),
         // Feature 모듈 (실제 구현)
         .target(

MLS/MLSAppFeature/Sources/MLSAppFeature/AppInfo.swift

@@ -0,0 +1,5 @@
+enum AppInfo {
+    // TODO: 앱스토어 출시 후 실제 앱 ID로 교체
+    static let appStoreID = "6477212894"
+    static let appStoreURL = "itms-apps://itunes.apple.com/app/id\(appStoreID)"
+}

MLS/MLSAppFeature/Sources/MLSAppFeature/Coordinator/AppCoordinator.swift

@@ -42,7 +42,7 @@ public final class AppCoordinator: AppCoordinatorProtocol {
     }
 
     // MARK: - Public Methods
-    public func showMainTab() {
+    public func showMainTab(selectedIndex: Int = 0) {
         let tabItems: [TabItem] = [
             TabItem(title: "추천", icon: UIImage(systemName: "star.fill") ?? UIImage()),
             TabItem(title: "도감", icon: DesignSystemAsset.image(named: "dictionary")),
@@ -56,7 +56,8 @@ public final class AppCoordinator: AppCoordinatorProtocol {
                 bookmarkMainFactory.make(bottomInset: 64),
                 myPageMainFactory.make()
             ],
-            tabItems: tabItems
+            tabItems: tabItems,
+            initialIndex: selectedIndex
         )
 
         let navigationController = UINavigationController(rootViewController: tabBar)

MLS/MLSAppFeature/Sources/MLSAppFeature/Dependency/FactoryAssembly.swift

@@ -73,7 +73,7 @@ public enum FactoryAssembly {
                     type: DetailOnBoardingFactory.self
                 ),
                 appCoordinator: {
-                    DIContainer.resolve(type: AppCoordinator.self)
+                    DIContainer.resolve(type: AppCoordinatorProtocol.self)
                 },
                 dictionaryDetailAPIRepository: DIContainer.resolve(
                     type: DictionaryDetailAPIRepository.self
@@ -415,15 +415,14 @@ public enum FactoryAssembly {
                     DIContainer
                     .resolve(type: CheckValidLevelUseCase.self),
                 authRepository: DIContainer
-                    .resolve(type: AuthAPIRepository.self)
-            )
-        }
-        DIContainer.register(type: SelectImageFactory.self) {
-            SelectImageFactoryImpl(
+                    .resolve(type: AuthAPIRepository.self),
                 myPageRepository: DIContainer
                     .resolve(type: MyPageRepository.self)
             )
         }
+        DIContainer.register(type: SelectImageFactory.self) {
+            SelectImageFactoryImpl()
+        }
         DIContainer.register(type: DetailOnBoardingFactory.self) {
             DetailOnBoardingFactoryImpl()
         }
@@ -432,9 +431,30 @@ public enum FactoryAssembly {
         }
         DIContainer.register(type: RecommendationMainFactory.self) {
             RecommendationMainFactoryImpl(
-                repository: DIContainer.resolve(
-                    type: RecommendationRepository.self
-                )
+                repository: DIContainer.resolve(type: RecommendationRepository.self),
+                bookmarkRepository: DIContainer.resolve(type: BookmarkRepository.self),
+                makeLoginVC: {
+                    DIContainer.resolve(type: LoginFactory.self).make(exitRoute: .pop)
+                },
+                makeCharacterSettingVC: {
+                    DIContainer.resolve(type: SetCharacterFactory.self).make()
+                },
+                makeSearchVC: {
+                    DIContainer.resolve(type: DictionarySearchFactory.self).make()
+                },
+                makeNotificationVC: {
+                    DIContainer.resolve(type: DictionaryNotificationFactory.self).make()
+                },
+                makeDetailVC: { mapId in
+                    DIContainer.resolve(type: DictionaryDetailFactory.self).make(
+                        type: .map, id: mapId, bookmarkRelay: nil, loginRelay: nil
+                    )
+                },
+                makeBookmarkModalVC: { bookmarkIds, onComplete in
+                    DIContainer.resolve(type: BookmarkModalFactory.self).make(
+                        bookmarkIds: bookmarkIds, onComplete: onComplete
+                    )
+                }
             )
         }
     }

MLS/MLSAppFeature/Sources/MLSAppFeature/Dependency/RepositoryAssembly.swift

@@ -1,3 +1,4 @@
+import MLSAppFeatureInterface
 import MLSAuthFeature
 import MLSAuthFeatureInterface
 import MLSBookmarkFeature
@@ -80,5 +81,11 @@ public enum RepositoryAssembly {
         DIContainer.register(type: BookmarkUserDefaultsRepository.self) {
             BookmarkUserDefaultsRepositoryImpl()
         }
+        DIContainer.register(type: AppStoreRepositoryProtocol.self) {
+            AppStoreRepository()
+        }
+        DIContainer.register(type: UpdateSkipRepositoryProtocol.self) {
+            UpdateSkipRepository()
+        }
      }
 }

MLS/MLSAppFeature/Sources/MLSAppFeature/Dependency/UseCaseAssembly.swift

@@ -1,3 +1,4 @@
+import MLSAppFeatureInterface
 import MLSAuthFeature
 import MLSAuthFeatureInterface
 import MLSCore
@@ -82,5 +83,12 @@ public enum UseCaseAssembly {
                     .resolve(type: UserDefaultsRepository.self, name: "authUserDefaultsRepository")
             )
         }
+        DIContainer.register(type: UpdateCheckerUseCaseProtocol.self) {
+            UpdateCheckerUseCase(
+                appID: AppInfo.appStoreID,
+                appStoreRepository: DIContainer.resolve(type: AppStoreRepositoryProtocol.self),
+                skipRepository: DIContainer.resolve(type: UpdateSkipRepositoryProtocol.self)
+            )
+        }
     }
 }

MLS/MLSAppFeature/Sources/MLSAppFeature/Launcher/AppLauncher.swift

@@ -3,12 +3,14 @@ import UIKit
 import MLSAppFeatureInterface
 import MLSAuthFeatureInterface
 import MLSCore
+import MLSDesignSystem
 
 import RxSwift
 
 @MainActor
 public final class AppLauncher {
     private let disposeBag = DisposeBag()
+    private var forceUpdateObserver: NSObjectProtocol?
 
     public init() {}
 
@@ -26,16 +28,18 @@ public final class AppLauncher {
             authRepository.reissueToken(refreshToken: refreshToken)
             .observe(on: MainScheduler.instance)
             .subscribe(
-                onNext: { _ in
+                onNext: { [weak self] _ in
                     Task { @MainActor in
                         let coordinator = DIContainer.resolve(type: AppCoordinatorProtocol.self)
                         coordinator.showMainTab()
+                        self?.checkUpdateIfNeeded()
                     }
                 },
-                onError: { _ in
+                onError: { [weak self] _ in
                     Task { @MainActor in
                         let coordinator = DIContainer.resolve(type: AppCoordinatorProtocol.self)
                         coordinator.showLogin(exitRoute: .home)
+                        self?.checkUpdateIfNeeded()
                     }
                 }
             )
@@ -44,10 +48,74 @@ public final class AppLauncher {
         case .failure:
             let coordinator = DIContainer.resolve(type: AppCoordinatorProtocol.self)
             coordinator.showLogin(exitRoute: .home)
+            checkUpdateIfNeeded()
         }
     }
 
     public func register() {
         DependencyAssembler.register()
     }
 }
+
+// MARK: - Update Check
+private extension AppLauncher {
+    func checkUpdateIfNeeded() {
+        guard
+            let versionString = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String,
+            let currentVersion = Version(versionString: versionString)
+        else { return }
+
+        Task { @MainActor in
+            let useCase = DIContainer.resolve(type: UpdateCheckerUseCaseProtocol.self)
+            guard let status = try? await useCase.checkUpdate(currentVersion: currentVersion) else { return }
+
+            switch status {
+            case .force:
+                showForceUpdateAlert()
+                if let existingObserver = forceUpdateObserver {
+                    NotificationCenter.default.removeObserver(existingObserver)
+                }
+                forceUpdateObserver = NotificationCenter.default.addObserver(
+                    forName: UIApplication.didBecomeActiveNotification,
+                    object: nil,
+                    queue: .main
+                ) { [weak self] _ in
+                    self?.showForceUpdateAlert()
+                }
+            case .optional(let latestVersion):
+                GuideAlertFactory.show(
+                    mainText: "앱 버전이 달라요.\n보다 좋은 서비스를 위해 업데이트 해주세요.",
+                    ctaText: "업데이트 하기",
+                    cancelText: "나중에",
+                    ctaAction: { [weak self] in self?.openAppStore() },
+                    cancelAction: { useCase.skipUpdate(version: latestVersion) }
+                )
+            case .none:
+                break
+            }
+        }
+    }
+
+    func showForceUpdateAlert() {
+        GuideAlertFactory.show(
+            mainText: "앱 버전이 달라요.\n보다 좋은 서비스를 위해 업데이트 해주세요.",
+            ctaText: "업데이트 하기",
+            cancelText: nil,
+            ctaAction: { [weak self] in self?.openAppStore() }
+        )
+    }
+
+    func openAppStore() {
+        guard let url = URL(string: AppInfo.appStoreURL) else {
+            showForceUpdateAlert()
+            return
+        }
+        UIApplication.shared.open(url, options: [:]) { [weak self] success in
+            if !success {
+                DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
+                    self?.showForceUpdateAlert()
+                }
+            }
+        }
+    }
+}

MLS/MLSAppFeature/Sources/MLSAppFeatureInterface/Domain/Navigation/AppCoordinatorProtocol.swift

@@ -1,8 +1,15 @@
+import MLSCore
 import UIKit
 
 @MainActor
 public protocol AppCoordinatorProtocol: AnyObject {
     var window: UIWindow? { get set }
-    func showMainTab()
+    func showMainTab(selectedIndex: Int)
     func showLogin(exitRoute: LoginExitRoute)
 }
+
+public extension AppCoordinatorProtocol {
+    func showMainTab() {
+        showMainTab(selectedIndex: 0)
+    }
+}

MLS/MLSAuthFeature/Package.swift

@@ -36,7 +36,6 @@ let package = Package(
         .target(
             name: "MLSAuthFeatureInterface",
             dependencies: [
-                .product(name: "MLSAppFeatureInterface", package: "MLSAppFeature"),
                 .product(name: "MLSCore", package: "MLSCore"),
                 .product(name: "MLSDesignSystem", package: "MLSDesignSystem"),
                 .product(name: "RxSwift", package: "RxSwift")

MLS/MLSAuthFeature/Sources/MLSAuthFeatureInterface/Factories/LoginFactory.swift

@@ -1,4 +1,3 @@
-import MLSAppFeatureInterface
 import MLSCore
 
 public protocol LoginFactory {

MLS/MLSAppFeature/Sources/MLSAppFeatureInterface/Domain/Navigation/LoginExitRoute.swift → MLS/MLSCore/Sources/MLSCore/Utils/LoginExitRoute.swift

@@ -1,5 +1,3 @@
-import UIKit
-
 public enum LoginExitRoute {
     case pop
     case home

MLS/MLSDesignSystem/Sources/MLSDesignSystem/Components/DictionaryDetailListView.swift

@@ -76,7 +76,7 @@ private extension DictionaryDetailListView {
 
     func makeButton(label: UILabel) -> UIButton {
         let button = UIButton()
-        let icon = UIImageView(image: UIImage(named: "rightArrow"))
+        let icon = UIImageView(image: DesignSystemAsset.image(named: "rightArrow"))
 
         button.addSubview(label)
         button.addSubview(icon)

MLS/MLSDesignSystem/Sources/MLSDesignSystem/Components/DropDownBox/DropDownBox.swift

@@ -169,6 +169,17 @@ extension DropDownBox: UITableViewDataSource, UITableViewDelegate {
     }
 }
 
+// MARK: - Public Methods
+public extension DropDownBox {
+    func selectItem(id: Int) {
+        guard let index = items.firstIndex(where: { $0.id == id }) else { return }
+        selectedIndex = index
+        inputBox.textField.attributedText = .makeStyledString(
+            font: .b_m_r, text: items[index].name, alignment: .left, lineHeight: 1.0
+        )
+    }
+}
+
 // MARK: Model
 extension DropDownBox {
     public struct Item {

MLS/MLSDesignSystem/Sources/MLSDesignSystem/Components/ErrorMessage.swift

@@ -15,7 +15,7 @@ public final class ErrorMessage: UIView {
     // MARK: - Properties
     private let iconView: UIImageView = {
         let view = UIImageView()
-        view.image = UIImage(named: "error")
+        view.image = DesignSystemAsset.image(named: "error")
         return view
     }()
 

MLS/MLSDesignSystem/Sources/MLSDesignSystem/Components/FloatingActionButton.swift

@@ -22,7 +22,7 @@ public final class FloatingActionButton: UIButton {
 // MARK: - SetUp
 private extension FloatingActionButton {
     func configureUI() {
-        setImage(UIImage(named: "fab"), for: .normal)
+        setImage(DesignSystemAsset.image(named: "fab"), for: .normal)
         layer.cornerRadius = 24
         clipsToBounds = true
         addTarget(self, action: #selector(buttonTapped), for: .touchUpInside)

MLS/MLSDesignSystem/Sources/MLSDesignSystem/Components/GuideAlert.swift

@@ -18,7 +18,7 @@ public class GuideAlert: UIView {
     // MARK: - Components
     private let warningIconView: UIImageView = {
         let view = UIImageView()
-        view.image = UIImage(named: "warning")
+        view.image = DesignSystemAsset.image(named: "warning")
         return view
     }()
 
@@ -34,7 +34,7 @@ public class GuideAlert: UIView {
 
     // MARK: - init
     public init(mainText: String, ctaText: String, cancelText: String?, ctaRatio: Double = 0.7) {
-        mainTextLabel.attributedText = .makeStyledString(font: .sub_l_b, text: mainText)
+        mainTextLabel.attributedText = .makeStyledString(font: .sub_m_sb, text: mainText)
         self.ctaButton = CommonButton(style: .normal, title: ctaText, disabledTitle: nil)
         self.cancelButton = cancelText.map { CommonButton(style: .border, title: $0, disabledTitle: nil) }
         mainTextLabel.numberOfLines = 0