[FEAT] 로그인 및 회원가입 플로우 구현

AGENTS.md

@@ -70,6 +70,14 @@ Projects/
 - CPU 작업은 Effect 내에서 처리
 - 테스트: TestStore 패턴 사용
 
+#### TCA Dependency Client
+- TCA Client(`@DependencyClient` + `DependencyKey` + `DependencyValues`)는 `CoreDependencies` 한 파일에 둔다
+- `liveValue` / `testValue`는 빈 `Self()`, `static func live(useCase:)` 팩토리는 Domain UseCase protocol만 받는다
+- 실제 live 조립은 `App/Sources/Factory/*Factory.makeClient()`에서, 주입은 `BangawoApp.init()`의 `prepareDependencies`에서 한 번만
+- Feature는 `@Dependency`만 사용, `Data` 계열(Repository/DataUseCase/Model/API/Service) import 금지
+- 네이밍: Entity는 도메인명 그대로(`AuthToken`), DTO는 `*RequestDTO`/`*ResponseDTO`, Repository는 `*RepositoryProtocol`/`*RepositoryImpl`, UseCase는 `*UseCase`/`*UseCaseImpl`, TCA Client는 `*Client`, Composition Root 헬퍼는 `*Factory`
+- 상세 예시·의존성 표·금지 사항은 [`docs/conventions/tca-dependency-convention.md`](docs/conventions/tca-dependency-convention.md) 참고
+
 ## Git Rules
 
 ### Branch

Plugins/DependencyPlugin/ProjectDescriptionHelpers/TargetDependency+Module/Modules.swift

@@ -14,12 +14,16 @@ public enum ModulePath {
   case Domain(Domains)
   case Data(Datas)
   case Shared(Shareds)
+  case Core(Cores)
 }
 
 // MARK: FeatureModule
 public extension ModulePath {
   enum Presentations: String, CaseIterable {
     case Presentation
+    case AuthFlowFeature
+    case HomeFeature
+    case RootFeature
 
 
     public static let name: String = "Presentation"
@@ -46,6 +50,7 @@ public extension ModulePath {
     case Repository
     case API
     case Service
+    case DataUseCase
 
     public static let name: String = "Data"
   }
@@ -72,9 +77,19 @@ public extension ModulePath {
     case Shared
     case DesignSystem
     case Utill
-    
+
     public static let name: String = "Shared"
   }
 }
 
 
+//MARK: -  CoreModule
+public extension ModulePath {
+  enum Cores: String, CaseIterable {
+    case CoreDependencies
+
+    public static let name: String = "Core"
+  }
+}
+
+

Plugins/DependencyPlugin/ProjectDescriptionHelpers/TargetDependency+Module/Path+Modules.swift

@@ -64,3 +64,14 @@ public extension ProjectDescription.Path {
     return .relativeToRoot("Projects/\(ModulePath.Datas.name)/\(module.rawValue)")
   }
 }
+
+// MARK: - Core
+public extension ProjectDescription.Path {
+  static var Core: Self {
+    return .relativeToRoot("Projects/\(ModulePath.Cores.name)")
+  }
+
+  static func Core(implementation module: ModulePath.Cores) -> Self {
+    return .relativeToRoot("Projects/\(ModulePath.Cores.name)/\(module.rawValue)")
+  }
+}

Plugins/DependencyPlugin/ProjectDescriptionHelpers/TargetDependency+Module/TargetDependency+Modules.swift

@@ -52,3 +52,10 @@ public extension TargetDependency {
   }
 }
 
+// Core
+public extension TargetDependency {
+  static func Core(implements module: ModulePath.Cores) -> Self {
+    projectTarget(module.rawValue, path: .Core(implementation: module))
+  }
+}
+

Plugins/ProjectTemplatePlugin/ProjectDescriptionHelpers/infoPlist/InfoPlistDictionary.swift

@@ -161,6 +161,10 @@ extension InfoPlistDictionary {
   func setNSCameraUsageDescription(_ value: String) -> InfoPlistDictionary {
     return self.merging(["NSCameraUsageDescription": .string(value)]) { (_, new) in new }
   }
+
+  func setNSPhotoLibraryUsageDescription(_ value: String) -> InfoPlistDictionary {
+    return self.merging(["NSPhotoLibraryUsageDescription": .string(value)]) { (_, new) in new }
+  }
 
   func setUILaunchScreens() -> InfoPlistDictionary {
     let dict: InfoPlistDictionary = [
@@ -199,4 +203,8 @@ extension InfoPlistDictionary {
   func setKakaoAppKey(_ value: String) -> InfoPlistDictionary {
     return self.merging(["KAKAO_APP_KEY": .string(value)]) { (_, new) in new }
   }
+
+  func setKakaoRestAPIKey(_ value: String) -> InfoPlistDictionary {
+    return self.merging(["KAKAO_REST_API_KEY": .string(value)]) { (_, new) in new }
+  }
 }

Plugins/ProjectTemplatePlugin/ProjectDescriptionHelpers/infoPlist/Project+InfoPlist.swift

@@ -40,6 +40,9 @@ public extension InfoPlist {
         ]
       ])
       .setKakaoAppKey("$(KAKAO_APP_KEY)")
+      .setKakaoRestAPIKey("$(KAKAO_REST_API_KEY)")
+      .setNSCameraUsageDescription("프로필 사진 촬영을 위해 카메라 접근이 필요합니다")
+      .setNSPhotoLibraryUsageDescription("프로필 사진 선택을 위해 사진 접근이 필요합니다")
   )
 
   static let moduleInfoPlist: Self = .extendingDefault(

Projects/App/Derived/InfoPlists/Bangawo-Debug-Info.plist

@@ -34,6 +34,8 @@
 	<false/>
 	<key>KAKAO_APP_KEY</key>
 	<string>$(KAKAO_APP_KEY)</string>
+	<key>KAKAO_REST_API_KEY</key>
+	<string>$(KAKAO_REST_API_KEY)</string>
 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>kakaokompassauth</string>
@@ -46,6 +48,10 @@
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>
+	<key>NSCameraUsageDescription</key>
+	<string>프로필 사진 촬영을 위해 카메라 접근이 필요합니다</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>프로필 사진 선택을 위해 사진 접근이 필요합니다</string>
 	<key>UIAppFonts</key>
 	<array>
 		<string>PretendardVariable.ttf</string>

Projects/App/Derived/InfoPlists/Bangawo-Info.plist

@@ -34,6 +34,8 @@
 	<false/>
 	<key>KAKAO_APP_KEY</key>
 	<string>$(KAKAO_APP_KEY)</string>
+	<key>KAKAO_REST_API_KEY</key>
+	<string>$(KAKAO_REST_API_KEY)</string>
 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>kakaokompassauth</string>
@@ -46,6 +48,10 @@
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>
+	<key>NSCameraUsageDescription</key>
+	<string>프로필 사진 촬영을 위해 카메라 접근이 필요합니다</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>프로필 사진 선택을 위해 사진 접근이 필요합니다</string>
 	<key>UIAppFonts</key>
 	<array>
 		<string>PretendardVariable.ttf</string>

Projects/App/Derived/InfoPlists/Bangawo-Prod-Info.plist

@@ -34,6 +34,8 @@
 	<false/>
 	<key>KAKAO_APP_KEY</key>
 	<string>$(KAKAO_APP_KEY)</string>
+	<key>KAKAO_REST_API_KEY</key>
+	<string>$(KAKAO_REST_API_KEY)</string>
 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>kakaokompassauth</string>
@@ -46,6 +48,10 @@
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>
+	<key>NSCameraUsageDescription</key>
+	<string>프로필 사진 촬영을 위해 카메라 접근이 필요합니다</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>프로필 사진 선택을 위해 사진 접근이 필요합니다</string>
 	<key>UIAppFonts</key>
 	<array>
 		<string>PretendardVariable.ttf</string>

Projects/App/Derived/InfoPlists/Bangawo-Stage-Info.plist

@@ -34,6 +34,8 @@
 	<false/>
 	<key>KAKAO_APP_KEY</key>
 	<string>$(KAKAO_APP_KEY)</string>
+	<key>KAKAO_REST_API_KEY</key>
+	<string>$(KAKAO_REST_API_KEY)</string>
 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>kakaokompassauth</string>
@@ -46,6 +48,10 @@
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>
+	<key>NSCameraUsageDescription</key>
+	<string>프로필 사진 촬영을 위해 카메라 접근이 필요합니다</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>프로필 사진 선택을 위해 사진 접근이 필요합니다</string>
 	<key>UIAppFonts</key>
 	<array>
 		<string>PretendardVariable.ttf</string>

Projects/App/Project.swift

@@ -11,14 +11,17 @@ let project = Project.makeAppModule(
   scripts: [],
   dependencies: [
     .Presentation(implements: .Presentation),
-    .project(target: "CoreDependencies", path: .relativeToRoot("Projects/Core/Dependencies")),
-    .project(target: "DataUseCase", path: .relativeToRoot("Projects/Data/UseCase")),
+    .Domain(implements: .UseCase),
     .Data(implements: .Repository),
     .Data(implements: .Service),
+    .Data(implements: .DataUseCase),
+    .Core(implements: .CoreDependencies),
+    .Shared(implements: .Utill),
     .SPM.kakaoMapsSDK,
     .SPM.kakaoSDKCommon,
     .SPM.kakaoSDKAuth,
-    .SPM.kakaoSDKUser
+    .SPM.kakaoSDKUser,
+    .SPM.composableArchitecture
   ],
   sources: ["Sources/**"],
   resources: ["Resources/**"],

Projects/App/Sources/Application/BangawoApp.swift

@@ -2,40 +2,36 @@ import SwiftUI
 import ComposableArchitecture
 import CoreDependencies
 import Presentation
+import Utill
 import KakaoSDKCommon
 import KakaoSDKAuth
-import KakaoSDKUser
-import Utill
-
 @preconcurrency import KakaoMapsSDK
 
-
 @main
 struct BangawoApp: App {
+    private let store = Store(initialState: RootFeature.State()) {
+        RootFeature()
+    }
+
     init() {
-        if let appKey = Bundle.main.infoDictionary?["KAKAO_APP_KEY"] as? String, !appKey.isEmpty {
-            SDKInitializer.InitSDK(appKey: appKey, phase: .real) // 카카오 지도 SDK 초기화
+        let appKey = AppEnvironment.kakaoAppKey
+        SDKInitializer.InitSDK(appKey: appKey, phase: .real)
+        KakaoSDK.initSDK(appKey: appKey)
 
-            KakaoSDK.initSDK(appKey: appKey)// 카카오 로그인/공유 SDK 초기화
-            Log.debug("👤 [Kakao] Login SDK 초기화 완료")
-        } else {
-            Log.debug("⚠️ [Kakao] Error: Info.plist에서 'KAKAO_APP_KEY'를 찾을 수 없거나 비어 있습니다.")
+        prepareDependencies {
+            $0.searchStationsClient = SearchStationsFactory.makeClient()
+            $0.socialAuthClient = AuthFactory.makeSocialAuthClient()
         }
     }
 
     var body: some Scene {
         WindowGroup {
-            LoginView( // 앱 시작점 임의로 로그인 뷰
-                store: Store(initialState: LoginFeature.State()) { // store 주입
-                    LoginFeature()
-                } withDependencies: {
-                    $0.socialAuthClient = AuthFactory.makeSocialAuthClient()
-                }
-            ).onOpenURL(perform: { url in
-                if (AuthApi.isKakaoTalkLoginUrl(url)) { // 카카오 로그인 처리를 정상적으로 완료
-                    AuthController.handleOpenUrl(url: url)
+            RootView(store: store)
+                .onOpenURL { url in
+                    if AuthApi.isKakaoTalkLoginUrl(url) {
+                        AuthController.handleOpenUrl(url: url)
+                    }
                 }
-            })
         }
     }
 }

Projects/App/Sources/Factory/SearchStationsFactory.swift

@@ -0,0 +1,18 @@
+//
+//  SearchStationsFactory.swift
+//  App
+//
+//  Repository → UseCase → TCA Client을 조립하는 Composition Root
+//
+
+import CoreDependencies
+import DataUseCase
+import Repository
+
+enum SearchStationsFactory {
+    static func makeClient() -> SearchStationsClient {
+        let repository = LocationSearchRepositoryImpl()
+        let useCase = SearchStationsUseCaseImpl(repository: repository)
+        return .live(useCase: useCase)
+    }
+}

Projects/Core/Dependencies/Project.swift → Projects/Core/CoreDependencies/Project.swift

@@ -6,14 +6,14 @@ import DependencyPackagePlugin
 
 let project = Project.makeModule(
   name: "CoreDependencies",
-  bundleId: .appBundleID(name: ".Dependencies"),
+  bundleId: .appBundleID(name: ".CoreDependencies"),
   product: .staticFramework,
   settings: .settings(),
   dependencies: [
     .Domain(implements: .Entity),
     .Domain(implements: .DomainInterface),
     .Domain(implements: .UseCase),
-    .SPM.composableArchitecture
+    .SPM.composableArchitecture,
   ],
   sources: ["Sources/**"],
   hasTests: false

Projects/Core/CoreDependencies/Sources/Base.swift

@@ -0,0 +1,6 @@
+//
+//  Base.swift
+//  CoreDependencies
+//
+
+import Foundation

Projects/Core/CoreDependencies/Sources/SearchStationsClient.swift

@@ -0,0 +1,38 @@
+//
+//  SearchStationsClient.swift
+//  CoreDependencies
+//
+//  Kakao Local 키워드 검색을 Feature에 노출하는 TCA struct-based client
+//
+
+import ComposableArchitecture
+import Entity
+import Foundation
+import UseCase
+
+@DependencyClient
+public struct SearchStationsClient: Sendable {
+    public var searchStations: @Sendable (_ keyword: String) async throws -> [Station]
+}
+
+public extension SearchStationsClient {
+    static func live(useCase: SearchStationsUseCase) -> Self {
+        Self(
+            searchStations: { keyword in
+                try await useCase.execute(keyword: keyword)
+            }
+        )
+    }
+}
+
+extension SearchStationsClient: DependencyKey {
+    public static let liveValue: SearchStationsClient = SearchStationsClient()
+    public static let testValue: SearchStationsClient = SearchStationsClient()
+}
+
+public extension DependencyValues {
+    var searchStationsClient: SearchStationsClient {
+        get { self[SearchStationsClient.self] }
+        set { self[SearchStationsClient.self] = newValue }
+    }
+}

Projects/Data/API/Project.swift

@@ -11,6 +11,7 @@ let project = Project.makeModule(
   settings:  .settings(),
   dependencies: [
     .Network(implements: .Foundations),
+    .Shared(implements: .Utill),
     .Data(implements: .Model)
   ],
   sources: ["Sources/**"],