feat: 초대 링크(Universal Link) 기반 소속 가입 플로우

.gitignore

@@ -79,3 +79,5 @@ fastlane/report.xml
 fastlane/README.md
 Projects/App/Resources/APIKey.xcconfig
 graph.png
+CLAUDE.md
+.claude

Projects/App/Project.swift

@@ -8,7 +8,7 @@ let project = Project(
   ),
   settings: .settings(
     base: .init()
-      .marketingVersion("2.2.0")
+      .marketingVersion("2.2.1")
       .swiftVersion("5.7")
       .currentProjectVersion("1")
       .appleGenericVersioningSystem()
@@ -118,11 +118,11 @@ let project = Project(
         configurations: [
           .debug(name: "Debug", settings: [
             "CODE_SIGN_IDENTITY": "Apple Development: Nayeon Gu (3CMPGMMD7L)",
-            "PROVISIONING_PROFILE_SPECIFIER": "match Development com.yapp.moneymong 1769511003"
+            "PROVISIONING_PROFILE_SPECIFIER": "match Development com.yapp.moneymong"
           ]),
           .release(name: "Release", settings: [
             "CODE_SIGN_IDENTITY": "Apple Distribution: Nayeon Gu (H5G7RFWFSQ)",
-            "PROVISIONING_PROFILE_SPECIFIER": "match AppStore com.yapp.moneymong 1769511386"
+            "PROVISIONING_PROFILE_SPECIFIER": "match AppStore com.yapp.moneymong"
           ])
         ]
       ),

Projects/App/Resources/App.entitlements

@@ -2,6 +2,11 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>applinks:dev.moneymong.site</string>
+		<string>applinks:prod.moneymong.site</string>
+	</array>
 	<key>com.apple.developer.applesignin</key>
 	<array>
 		<string>Default</string>

Projects/App/Sources/SceneDelegate.swift

@@ -21,6 +21,7 @@ import Repository
 import SignFeature
 import User
 import UserInterface
+import Utility
 
 class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   let localStorage = LocalStorage()
@@ -44,17 +45,32 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate {
     appCoordinator?.start(animated: false)
 
     self.scene(scene, openURLContexts: connectionOptions.urlContexts)
+
+    if let userActivity = connectionOptions.userActivities.first(
+      where: { $0.activityType == NSUserActivityTypeBrowsingWeb }
+    ) {
+      handleUniversalLink(from: userActivity)
+    }
   }
 
   func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
     guard let url = URLContexts.first?.url else { return }
 
     if url.absoluteString.contains("widget://") {
-      DeepLinkManager.setDestination(url.absoluteString, agencyID: localStorage.selectedAgency)
+      let destination = url.absoluteString.replacingOccurrences(of: "widget://", with: "")
+      guard let agencyID = localStorage.selectedAgency else { return }
+      DeepLinkManager.setQuery([
+        "destination": destination,
+        "agencyID": agencyID
+      ], notiName: .widgetLink)
     } else {
       KakaoAuthManager.shared.openURL(url)
     }
   }
+
+  func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+    handleUniversalLink(from: userActivity)
+  }
 
   func sceneDidDisconnect(_ scene: UIScene) {}
 
@@ -65,6 +81,23 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func sceneWillEnterForeground(_ scene: UIScene) {}
 
   func sceneDidEnterBackground(_ scene: UIScene) {}
+
+  private func handleUniversalLink(from userActivity: NSUserActivity) {
+    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
+          let url = userActivity.webpageURL,
+          let components = URLComponents(url: url, resolvingAgainstBaseURL: true),
+          url.path == Config.invitationPath else { return }
+
+    let queryItems = components.queryItems ?? []
+    guard let code = queryItems.first(where: { $0.name == "code" })?.value,
+          let agencyID = queryItems.first(where: { $0.name == "agencyID" })?.value,
+          !code.isEmpty, !agencyID.isEmpty else { return }
+
+    DeepLinkManager.setQuery(
+      ["code": code, "agencyID": agencyID],
+      notiName: .invitationLink
+    )
+  }
 }
 
 extension SceneDelegate {

Projects/Core/MMNetwork/Sources/NetworkLogger.swift

@@ -4,8 +4,6 @@ import OSLog
 import Alamofire
 
 final class NetworkLogger: EventMonitor {
-  let queue = DispatchQueue(label: "NetworkLogger")
-
   private let logger = Logger(subsystem: Bundle.main.bundleIdentifier ?? "", category: "NetworkLogger")
 
   func request<Value>(_ request: DataRequest, didParseResponse response: DataResponse<Value, AFError>) where Value : Sendable {
@@ -34,9 +32,9 @@ final class NetworkLogger: EventMonitor {
     log.append("\(response.data?.toPrettyPrintedString ?? "None")")
 
     if (200..<300) ~= statusCode {
-      logger.log("\(log)")
+      logger.log("\(log, privacy: .public)")
     } else {
-      logger.error("\(log)")
+      logger.error("\(log, privacy: .public)")
 
     }
   }

Projects/Core/Repository/Sources/APIs/AgencyAPI/Repository/AgencyAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 enum AgencyAPI {
   case create(param: AgencyCreateRequestDTO) // 소속생성

Projects/Core/Repository/Sources/APIs/LedgerAPI/Repository/LedgerAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 import Alamofire
 

Projects/Core/Repository/Sources/APIs/SignAPI/Repository/SignAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 enum SignAPI {
   case sign(SignRequestDTO)

Projects/Core/Repository/Sources/APIs/TokenAPI/Repository/TokenAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 import Alamofire
 

Projects/Core/Repository/Sources/APIs/UserAPI/Repository/UserAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 enum UserAPI {
   case user // 내정보 조회

Projects/Core/Repository/Sources/APIs/VersionAPI/Repository/VersionAPI.swift

@@ -1,6 +1,7 @@
 import Foundation
 
 import MMNetworkInterface
+import Utility
 
 enum VersionAPI {
   case version(VersionRequestDTO) // 버전조회

Projects/Domain/Agency/Interface/ConfirmCertificateCodeUseCaseInterface.swift

@@ -5,4 +5,5 @@ import BaseDomain
 // 소속가입시, 초대코드가 맞는지 확인한다
 public protocol ConfirmCertificateCodeUseCaseInterface {
   func execute(code: [String]) async throws -> Agency?
+  func execute(code: String, agencyID: Int) async throws -> Agency?
 }

Projects/Domain/Agency/Project.swift

@@ -38,7 +38,8 @@ let project = Project(
             sources: ["Tests/**"],
             dependencies: [
                 .target(name: "Agency"),
-                .target(name: "AgencyTesting")
+                .target(name: "AgencyTesting"),
+                .project(target: "BaseDomainTesting", path: .relativeToRoot("Projects/Domain/BaseDomain")),
             ]
         ),
         Target(

Projects/Domain/Agency/Sources/ConfirmCertificateCodeUseCase.swift

@@ -25,4 +25,21 @@ public struct ConfirmCertificateCodeUseCase: ConfirmCertificateCodeUseCaseInterf
     }
     return nil
   }
+
+  public func execute(code: String, agencyID: Int) async throws -> Agency? {
+    let agencies = try await agencyRepo.fetchMyAgency()
+    if let agency = agencies.first(where: { $0.id == agencyID }) {
+      // 이미 소속에 가입되어 있는 경우
+      userRepo.updateSelectedAgency(id: agencyID)
+      return agency
+    }
+
+    // 소속에 가입되어 있지 않은 경우
+    let response = try await agencyRepo.certificateCode(code: code)
+    guard response.certified else { return nil }
+
+    userRepo.updateSelectedAgency(id: response.agencyId)
+    // 방금 가입했으므로 가입 전 조회한 `agencies`(stale)가 아니라 재조회한 목록에서 찾는다.
+    return try await agencyRepo.fetchMyAgency().first { $0.id == response.agencyId }
+  }
 }

Projects/Domain/Agency/Testing/MockConfirmCertificateCodeUseCase.swift

@@ -5,4 +5,7 @@ public struct MockConfirmCertificateCodeUseCase: ConfirmCertificateCodeUseCaseIn
   public init() {}
 
   public func execute(code: [String]) async throws -> Agency? { return nil }
+  public func execute(code: String, agencyID: Int) async throws -> Agency? {
+    return nil
+  }
 }

Projects/Domain/Agency/Tests/ConfirmCertificateCodeUseCaseTests.swift

@@ -0,0 +1,120 @@
+import XCTest
+@testable import Agency
+@testable import BaseDomain
+@testable import BaseDomainTesting
+
+final class ConfirmCertificateCodeUseCaseTests: XCTestCase {
+  var sut: ConfirmCertificateCodeUseCase!
+  var mockAgencyRepo: MockAgencyRepository!
+  var mockUserRepo: MockUserRepository!
+
+  override func setUpWithError() throws {
+    mockAgencyRepo = MockAgencyRepository()
+    mockUserRepo = MockUserRepository()
+    sut = ConfirmCertificateCodeUseCase(agencyRepo: mockAgencyRepo, userRepo: mockUserRepo)
+  }
+
+  override func tearDownWithError() throws {
+    mockAgencyRepo = nil
+    mockUserRepo = nil
+    sut = nil
+  }
+
+  func test_execute_코드배열로_호출_시_인증에_성공하면_소속을_저장하고_해당_Agency를_반환한다() async {
+    // Arrange
+    let agency = Agency(id: 1, name: "몽테스트", count: 1)
+    mockAgencyRepo.returnValue.certificateCode = CertificationResult(certified: true, agencyId: agency.id)
+    mockAgencyRepo.returnValue.fetchMyAgency = [agency]
+
+    do {
+      // Act
+      let output = try await sut.execute(code: ["1", "2", "3", "4"])
+
+      // Assert
+      XCTAssertEqual(output, agency)
+      XCTAssertEqual(mockAgencyRepo.inputValue.certificateCode, "1234")
+      XCTAssertEqual(mockUserRepo.inputValue.updateSelectedAgency, agency.id)
+      XCTAssertEqual(mockUserRepo.callCount.updateSelectedAgency, 1)
+    } catch {
+      // Assert
+      XCTFail()
+    }
+  }
+
+  func test_execute_코드배열로_호출_시_인증에_실패하면_nil을_반환한다() async {
+    // Arrange
+    mockAgencyRepo.returnValue.certificateCode = CertificationResult(certified: false, agencyId: 0)
+
+    do {
+      // Act
+      let output = try await sut.execute(code: ["1", "2", "3", "4"])
+
+      // Assert
+      XCTAssertNil(output)
+      XCTAssertEqual(mockUserRepo.callCount.updateSelectedAgency, 0)
+    } catch {
+      // Assert
+      XCTFail()
+    }
+  }
+
+  func test_execute_코드와_소속ID로_호출_시_이미_가입된_소속이면_인증코드_확인없이_소속을_저장하고_해당_Agency를_반환한다() async {
+    // Arrange
+    let agency = Agency(id: 1, name: "몽테스트", count: 1)
+    mockAgencyRepo.returnValue.fetchMyAgency = [agency]
+
+    do {
+      // Act
+      let output = try await sut.execute(code: "1234", agencyID: agency.id)
+
+      // Assert
+      XCTAssertEqual(output, agency)
+      XCTAssertEqual(mockAgencyRepo.callCount.certificateCode, 0)
+      XCTAssertEqual(mockUserRepo.inputValue.updateSelectedAgency, agency.id)
+    } catch {
+      // Assert
+      XCTFail()
+    }
+  }
+
+  func test_execute_코드와_소속ID로_호출_시_가입되지_않은_소속이고_인증에_성공하면_재조회한_목록의_Agency를_반환한다() async {
+    // Arrange
+    let agency = Agency(id: 2, name: "몽테스트", count: 1)
+    // 가입 전 조회에는 해당 소속이 없고, 인증(가입) 후 재조회에서야 등장한다.
+    mockAgencyRepo.returnValue.fetchMyAgencySequence = [[], [agency]]
+    mockAgencyRepo.returnValue.certificateCode = CertificationResult(certified: true, agencyId: agency.id)
+
+    do {
+      // Act
+      let output = try await sut.execute(code: "1234", agencyID: 999)
+
+      // Assert
+      XCTAssertEqual(output, agency)
+      XCTAssertEqual(mockAgencyRepo.callCount.certificateCode, 1)
+      XCTAssertEqual(mockAgencyRepo.callCount.fetchMyAgency, 2)
+      XCTAssertEqual(mockUserRepo.inputValue.updateSelectedAgency, agency.id)
+    } catch {
+      // Assert
+      XCTFail()
+    }
+  }
+
+  func test_execute_코드와_소속ID로_호출_시_가입되지_않은_소속이고_인증에_실패하면_nil을_반환한다() async {
+    // Arrange
+    mockAgencyRepo.returnValue.fetchMyAgency = []
+    mockAgencyRepo.returnValue.certificateCode = CertificationResult(certified: false, agencyId: 0)
+
+    do {
+      // Act
+      let output = try await sut.execute(code: "1234", agencyID: 999)
+
+      // Assert
+      XCTAssertNil(output)
+      XCTAssertEqual(mockAgencyRepo.callCount.fetchMyAgency, 1)
+      XCTAssertEqual(mockUserRepo.callCount.updateSelectedAgency, 0)
+    } catch {
+      // Assert
+      XCTFail()
+    }
+  }
+}