Feature/#45 - 온보딩/잠금 네비게이션 라우팅 및 OnboardingStatusClient 구현

Projects/DVData/Sources/RepositoryImpl/Settings/SettingsRepositoryImpl.swift

@@ -0,0 +1,22 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+import DVDomain
+
+// UserDefaults는 thread-safe하므로 @unchecked Sendable 허용
+public struct SettingsRepositoryImpl: SettingsRepository, @unchecked Sendable {
+
+  private let defaults: UserDefaults
+
+  public init(defaults: UserDefaults = .standard) {
+    self.defaults = defaults
+  }
+
+  public func hasCompletedOnboarding() -> Bool {
+    defaults.bool(forKey: .hasCompletedOnboarding)
+  }
+
+  public func setOnboardingCompleted() {
+    defaults.set(true, forKey: .hasCompletedOnboarding)
+  }
+}

Projects/DVData/Sources/RepositoryImpl/Settings/UserDefaultsKey.swift

@@ -0,0 +1,17 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+enum UserDefaultsKey: String {
+  case hasCompletedOnboarding
+}
+
+extension UserDefaults {
+  func bool(forKey key: UserDefaultsKey) -> Bool {
+    bool(forKey: key.rawValue)
+  }
+
+  func set(_ value: Bool, forKey key: UserDefaultsKey) {
+    set(value, forKey: key.rawValue)
+  }
+}

Projects/DVDesign/Sources/Foundations/Color/View+DVColor.swift

@@ -2,16 +2,16 @@
 
 import SwiftUI
 
-public extension View {
-    func dvForegroundColor(_ token: DVColor) -> some View {
+extension View {
+    public func dvForegroundColor(_ token: DVColor) -> some View {
         self.foregroundStyle(token.color)
     }
 
-    func dvBackgroundColor(_ token: DVColor) -> some View {
+    public func dvBackgroundColor(_ token: DVColor) -> some View {
         self.background(token.color)
     }
 
-    func dvScreenBackground(_ token: DVColor = .gray100) -> some View {
+    public func dvScreenBackground(_ token: DVColor = .gray100) -> some View {
         self.background(token.color.ignoresSafeArea())
     }
 }

Projects/DVDomain/Sources/Repository/Interface/SettingsRepository.swift

@@ -0,0 +1,8 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+public protocol SettingsRepository: Sendable {
+  func hasCompletedOnboarding() -> Bool
+  func setOnboardingCompleted()
+}

Projects/DVDomain/Sources/UseCase/Impl/Settings/OnboardingStatusUseCaseImpl.swift

@@ -0,0 +1,20 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+public struct OnboardingStatusUseCaseImpl: OnboardingStatusUseCase {
+
+  private let repository: any SettingsRepository
+
+  public init(repository: any SettingsRepository) {
+    self.repository = repository
+  }
+
+  public func hasCompleted() -> Bool {
+    repository.hasCompletedOnboarding()
+  }
+
+  public func setCompleted() {
+    repository.setOnboardingCompleted()
+  }
+}

Projects/DVDomain/Sources/UseCase/Interface/Settings/OnboardingStatusUseCase.swift

@@ -0,0 +1,8 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+public protocol OnboardingStatusUseCase: Sendable {
+  func hasCompleted() -> Bool
+  func setCompleted()
+}

Projects/DVPresentation/Project.swift

@@ -17,6 +17,7 @@ let project = Project.project(
 
                 // 3rd-party dependency
                 .tca(),
+                .lottie(),
             ]
         ),
         .tests(

Projects/DVPresentation/Resources/Localizable.xcstrings

@@ -1,39 +1,59 @@
 {
   "sourceLanguage" : "en",
   "strings" : {
+    "Access your secrets on all your\nApple devices, securely encrypted." : {
+
+    },
     "Content" : {
       "comment" : "The title of the main content section in the preview.",
       "isCommentAutoGenerated" : true
+    },
+    "Create Project" : {
+
+    },
+    "De" : {
+
     },
     "Detail" : {
 
     },
-    "Development" : {
+    "If Touch ID is unavailable,\nsystem password will be used" : {
 
     },
-    "Enterprise" : {
+    "LOGO" : {
 
     },
-    "Failed to load projects" : {
+    "No expire" : {
 
     },
-    "Individual" : {
+    "Placeholder row %@" : {
 
     },
-    "Production" : {
+    "Project" : {
 
     },
-    "Staging" : {
+    "Project Name" : {
 
     },
-    "Team" : {
+    "Save" : {
 
     },
-    "Sidebar" : {
-      "comment" : "The text that appears in the sidebar of the main view.",
-      "isCommentAutoGenerated" : true
+    "Select Project" : {
+
+    },
+    "SSL Required" : {
+
+    },
+    "This may take a moment..." : {
+
+    },
+    "Vault" : {
+
+    },
+    "목록을 불러오지 못했어요" : {
+
     },
-    "The project list couldn't be loaded. Please try again later." : {
+    "시크릿이 없어요" : {
 
     }
   },

Projects/DVPresentation/Sources/Dependencies/OnboardingStatusClient.swift

@@ -0,0 +1,33 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+import ComposableArchitecture
+
+// MARK: - OnboardingStatusClient
+
+@DependencyClient
+public struct OnboardingStatusClient {
+  public var hasCompleted: @Sendable () -> Bool = { false }
+  public var setCompleted: @Sendable () -> Void
+}
+
+// MARK: - DependencyKey
+
+extension OnboardingStatusClient: TestDependencyKey {
+  public static let testValue = OnboardingStatusClient()
+
+  public static let previewValue = OnboardingStatusClient(
+    hasCompleted: { false },
+    setCompleted: { }
+  )
+}
+
+// MARK: - DependencyValues
+
+extension DependencyValues {
+  public var onboardingStatus: OnboardingStatusClient {
+    get { self[OnboardingStatusClient.self] }
+    set { self[OnboardingStatusClient.self] = newValue }
+  }
+}

Projects/DVPresentation/Sources/Features/AppFeature.swift

@@ -1,6 +1,6 @@
 // Copyright © 2026 Devault. All rights reserved
 
-import SwiftUI
+import Foundation
 
 import ComposableArchitecture
 
@@ -13,7 +13,10 @@ public struct AppFeature {
 
   @ObservableState
   public struct State: Equatable {
-    var main: MainFeature.State = .init()
+    // 세 프로퍼티 중 항상 하나만 non-nil — reducer 로직으로 불변식 보장
+    var onboarding: OnboardingContainerFeature.State?
+    var locked: LockFeature.State?
+    var main: MainFeature.State?
 
     public init() {}
   }
@@ -28,6 +31,8 @@ public struct AppFeature {
 
     // MARK: - Child
 
+    case onboarding(OnboardingContainerFeature.Action)
+    case locked(LockFeature.Action)
     case main(MainFeature.Action)
 
     // MARK: - Delegate
@@ -37,19 +42,45 @@ public struct AppFeature {
     public enum Delegate: Equatable {}
   }
 
+  // MARK: - Dependencies
+
+  @Dependency(\.onboardingStatus) var onboardingStatus
+
   // MARK: - Init
 
   public init() {}
 
   // MARK: - Body
 
   public var body: some ReducerOf<Self> {
-    Scope(state: \.main, action: \.main) {
-      MainFeature()
-    }
     Reduce { state, action in
       switch action {
       case .task:
+        state.onboarding = nil
+        state.locked = nil
+        state.main = nil
+
+        if onboardingStatus.hasCompleted() {
+          state.locked = .init()
+        } else {
+          state.onboarding = .init()
+        }
+        return .none
+
+      case .onboarding(.delegate(.completed)):
+        state.onboarding = nil
+        state.main = .init()
+        return .run { _ in onboardingStatus.setCompleted() }
+
+      case .onboarding:
+        return .none
+
+      case .locked(.delegate(.unlockCompleted)):
+        state.locked = nil
+        state.main = .init()
+        return .none
+
+      case .locked:
         return .none
 
       case .main:
@@ -59,5 +90,14 @@ public struct AppFeature {
         return .none
       }
     }
+    .ifLet(\.onboarding, action: \.onboarding) {
+      OnboardingContainerFeature()
+    }
+    .ifLet(\.locked, action: \.locked) {
+      LockFeature()
+    }
+    .ifLet(\.main, action: \.main) {
+      MainFeature()
+    }
   }
 }

Projects/DVPresentation/Sources/Features/AppView.swift

@@ -10,7 +10,7 @@ public struct AppView: View {
 
   // MARK: - Properties
 
-  @Bindable public var store: StoreOf<AppFeature>
+  @Bindable var store: StoreOf<AppFeature>
 
   // MARK: - Init
 
@@ -30,8 +30,15 @@ public struct AppView: View {
 
 extension AppView {
 
+  @ViewBuilder
   private var content: some View {
-    MainView(store: store.scope(state: \.main, action: \.main))
+    if let store = store.scope(state: \.onboarding, action: \.onboarding) {
+      OnboardingContainerView(store: store)
+    } else if let store = store.scope(state: \.locked, action: \.locked) {
+      LockView(store: store)
+    } else if let store = store.scope(state: \.main, action: \.main) {
+      MainView(store: store)
+    }
   }
 }
 
@@ -41,6 +48,9 @@ extension AppView {
   AppView(
     store: Store(initialState: AppFeature.State()) {
       AppFeature()
+    } withDependencies: {
+      $0.onboardingStatus.hasCompleted = { false }
+      $0.onboardingStatus.setCompleted = { }
     }
   )
 }

Projects/DVPresentation/Sources/Features/Lock/LockFeature.swift

@@ -13,11 +13,7 @@ public struct LockFeature {
 
   @ObservableState
   public struct State: Equatable {
-    public var isPostOnboarding: Bool
-
-    public init(isPostOnboarding: Bool = false) {
-      self.isPostOnboarding = isPostOnboarding
-    }
+    public init() {}
   }
 
   // MARK: - Action