feat: Crashlytics 추가 및 에러 추적 환경 개선

Projects/App/Project.swift

@@ -31,7 +31,7 @@ private let commonInfoPlist: [String: Plist.Value] = Project.Environment.InfoPli
     "DEEPLINK_HOST": "$(DEEPLINK_HOST)",
     "API_BASE_URL": "$(API_BASE_URL)",
     "NSCameraUsageDescription": "UseCamera",
-    "CFBundleShortVersionString": "1.1.1"
+    "CFBundleShortVersionString": "1.1.2"
 ], uniquingKeysWith: { current, _ in current })
 
 private let commonDependencies: [TargetDependency] = [
@@ -45,7 +45,8 @@ private let commonDependencies: [TargetDependency] = [
     .external(dependency: .GoogleSignIn),
     .external(dependency: .FirebaseCore),
     .external(dependency: .FirebaseMessaging),
-    .external(dependency: .FirebaseRemoteConfig)
+    .external(dependency: .FirebaseRemoteConfig),
+    .core(implements: .crashlytics)
 ]
 
 private let commonBuildSettings: SettingsDictionary = [
@@ -75,7 +76,7 @@ let project = Project(
             config: .init(
                 infoPlist: .extendingDefault(with: commonInfoPlist),
                 entitlements: .file(path: "Support/Twix.entitlements"),
-                scripts: [.swiftLint],
+                scripts: [.swiftLint, .crashlyticsUploadSymbols],
                 dependencies: commonDependencies + [
                     .core(implements: .analytics)
                 ],

Projects/App/Sources/AppDelegate.swift

@@ -7,6 +7,7 @@
 
 import CoreLogging
 import FirebaseCore
+import FirebaseCrashlytics
 import FirebaseMessaging
 import UIKit
 import UserNotifications
@@ -21,6 +22,12 @@ final class AppDelegate: NSObject, UIApplicationDelegate {
         // Firebase 초기화
         FirebaseApp.configure()
 
+        #if DEBUG
+        Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(false)
+        #else
+        Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)
+        #endif
+
         // 푸시 알림 delegate 설정
         UNUserNotificationCenter.current().delegate = self
         Messaging.messaging().delegate = self

Projects/App/Sources/Crashlytics/AppCrashlyticsEvent.swift

@@ -0,0 +1,33 @@
+//
+//  AppCrashlyticsEvent.swift
+//  Twix
+//
+
+import CoreCrashlyticsInterface
+import Foundation
+
+enum AppCrashlyticsLogEvent: CrashlyticsLogEvent {
+    case sessionExpiredAtOnboardingStatusCheck
+
+    var message: String {
+        switch self {
+        case .sessionExpiredAtOnboardingStatusCheck:
+            "session expired at onboarding status check"
+        }
+    }
+}
+
+enum AppCrashlyticsRecordEvent: CrashlyticsRecordEvent {
+    case appStartupFailed
+    case onboardingStatusCheckFailed
+
+    var customKeys: [String: String] {
+        switch self {
+        case .appStartupFailed:
+            [CrashlyticsKey.screen: "app_startup"]
+
+        case .onboardingStatusCheckFailed:
+            [CrashlyticsKey.screen: "startup_onboarding_check"]
+        }
+    }
+}

Projects/App/Sources/Reducer/AppCoordinator.swift

@@ -8,6 +8,7 @@
 import ComposableArchitecture
 import CoreAnalytics
 import CoreAnalyticsInterface
+import CoreCrashlyticsInterface
 import CoreLogging
 import CoreNetworkInterface
 import CorePushInterface
@@ -35,7 +36,11 @@ struct AppCoordinator {
     @Dependency(\.notificationClient)
     var notificationClient
 
-    @Dependency(\.analyticsClient) var analyticsClient
+    @Dependency(\.analyticsClient)
+    var analyticsClient
+
+    @Dependency(\.crashlyticsClient)
+    var crashlytics
 
     private let authReducer: AuthReducer
     private let onboardingCoordinator: OnboardingCoordinator
@@ -149,9 +154,10 @@ struct AppCoordinator {
                 }
                 return .none
 
-            case .checkAuthResult(.failure):
+            case .checkAuthResult(.failure(let error)):
                 state.isCheckingAuth = false
                 state.route = .auth(AuthReducer.State())
+                crashlytics.record(error, AppCrashlyticsRecordEvent.appStartupFailed)
                 return .none
 
             case let .checkOnboardingStatusResult(.success(status)):
@@ -198,10 +204,11 @@ struct AppCoordinator {
                 state.isCheckingAuth = false
                 if let networkError = error as? NetworkError,
                    case .authorizationError = networkError {
+                    crashlytics.log(AppCrashlyticsLogEvent.sessionExpiredAtOnboardingStatusCheck)
                     state.route = .auth(AuthReducer.State())
                     return .none
                 }
-
+                crashlytics.record(error, AppCrashlyticsRecordEvent.onboardingStatusCheckFailed)
                 state.route = .onboarding(OnboardingCoordinator.State(
                     pendingReceivedCode: state.pendingInviteCode
                 ))
@@ -225,8 +232,9 @@ struct AppCoordinator {
 
                 state.pendingNotificationDeepLink = nil
                 return .send(.route(.mainTab(.notificationDeepLinkReceived(deepLink))))
-
-            case .route(.auth(.delegate(.loginSucceeded))):
+
+            case let .route(.auth(.delegate(.loginSucceeded(authResult)))):
+                crashlytics.setUserIdentifier("\(authResult.userId)")
                 return .merge(
                     // 1. 온보딩 상태 체크
                     .run { [onboardingClient] send in

Projects/Core/CaptureSession/Interface/Sources/CaptureSessionError.swift

@@ -13,3 +13,18 @@ public enum CaptureSessionError: Error {
     case photoDataUnavailable
     case deviceInputNotCreated
 }
+
+// MARK: - CustomNSError
+
+extension CaptureSessionError: CustomNSError {
+    public static var errorDomain: String { "org.yapp.twix.capture" }
+
+    public var errorCode: Int {
+        switch self {
+        case .sessionDeallocated:    return 1
+        case .sessionNotConfigured:  return 2
+        case .photoDataUnavailable:  return 3
+        case .deviceInputNotCreated: return 4
+        }
+    }
+}

Projects/Core/Crashlytics/Interface/Sources/CrashlyticsClient.swift

@@ -0,0 +1,68 @@
+//
+//  CrashlyticsClient.swift
+//  CoreCrashlyticsInterface
+//
+
+import ComposableArchitecture
+import Foundation
+
+/// Crashlytics non-fatal 오류 추적 클라이언트입니다.
+///
+/// 화면/Feature별로 정의된 이벤트 타입을 통해 메시지·커스텀 키를 일관되게 전달합니다.
+///
+/// ## 사용 예시
+/// ```swift
+/// @Dependency(\.crashlyticsClient) var crashlytics
+///
+/// // non-fatal 오류 기록
+/// crashlytics.record(
+///     error,
+///     ProofPhotoCrashlyticsRecordEvent.uploadFailed(step: "fetchURL", goalId: 1)
+/// )
+///
+/// // 브레드크럼 로그
+/// crashlytics.log(ProofPhotoCrashlyticsLogEvent.uploadStep(.fetchURL, goalId: 1))
+///
+/// // 유저 식별자 설정 (로그인 성공 시 1회)
+/// crashlytics.setUserIdentifier(userId)
+/// ```
+public struct CrashlyticsClient: Sendable {
+    public var record: @Sendable (Error, any CrashlyticsRecordEvent) -> Void
+    public var log: @Sendable (any CrashlyticsLogEvent) -> Void
+    public var setUserIdentifier: @Sendable (String) -> Void
+
+    public init(
+        record: @escaping @Sendable (Error, any CrashlyticsRecordEvent) -> Void,
+        log: @escaping @Sendable (any CrashlyticsLogEvent) -> Void,
+        setUserIdentifier: @escaping @Sendable (String) -> Void
+    ) {
+        self.record = record
+        self.log = log
+        self.setUserIdentifier = setUserIdentifier
+    }
+}
+
+// MARK: - TestDependencyKey
+
+extension CrashlyticsClient: TestDependencyKey {
+    public static let testValue = Self(
+        record: { _, _ in },
+        log: { _ in },
+        setUserIdentifier: { _ in }
+    )
+
+    public static let previewValue = Self(
+        record: { _, _ in },
+        log: { _ in },
+        setUserIdentifier: { _ in }
+    )
+}
+
+// MARK: - DependencyValues
+
+public extension DependencyValues {
+    var crashlyticsClient: CrashlyticsClient {
+        get { self[CrashlyticsClient.self] }
+        set { self[CrashlyticsClient.self] = newValue }
+    }
+}

Projects/Core/Crashlytics/Interface/Sources/CrashlyticsEvent.swift

@@ -0,0 +1,50 @@
+//
+//  CrashlyticsEvent.swift
+//  CoreCrashlyticsInterface
+//
+
+import Foundation
+
+/// Crashlytics 브레드크럼 로그 이벤트가 따라야 하는 공통 인터페이스입니다.
+///
+/// ## 사용 예시
+/// ```swift
+/// enum ProofPhotoCrashlyticsLogEvent: CrashlyticsLogEvent {
+///     case uploadStep(UploadStep, goalId: Int64)
+///
+///     var message: String {
+///         switch self {
+///         case let .uploadStep(step, goalId):
+///             "upload_step: \(step.rawValue), goalId=\(goalId)"
+///         }
+///     }
+/// }
+/// ```
+public protocol CrashlyticsLogEvent: Sendable {
+    var message: String { get }
+}
+
+/// Crashlytics non-fatal 오류 기록 이벤트가 따라야 하는 공통 인터페이스입니다.
+///
+/// `customKeys`에 화면 식별자(`CrashlyticsKey.screen`) 등 컨텍스트 정보를 담아 전달합니다.
+///
+/// ## 사용 예시
+/// ```swift
+/// enum ProofPhotoCrashlyticsRecordEvent: CrashlyticsRecordEvent {
+///     case uploadFailed(step: String, goalId: Int64)
+///
+///     var customKeys: [String: String] {
+///         switch self {
+///         case let .uploadFailed(step, goalId):
+///             [
+///                 CrashlyticsKey.screen: "proof_photo_upload",
+///                 CrashlyticsKey.uploadStep: step,
+///                 CrashlyticsKey.goalId: "\(goalId)"
+///             ]
+///         }
+///     }
+/// }
+/// ```
+public protocol CrashlyticsRecordEvent: Sendable {
+    var customKeys: [String: String] { get }
+}

Projects/Core/Crashlytics/Interface/Sources/CrashlyticsKey.swift

@@ -0,0 +1,44 @@
+//
+//  CrashlyticsKey.swift
+//  CoreCrashlyticsInterface
+//
+
+/// Crashlytics custom key 상수 모음입니다.
+///
+/// `crashlyticsClient.record(error, [CrashlyticsKey.screen: "home"])` 형태로 사용합니다.
+public enum CrashlyticsKey {
+
+    // MARK: - 사용자 컨텍스트
+    public static let userId = "user_id"
+    public static let goalId = "goal_id"
+
+    // MARK: - 화면 컨텍스트
+    public static let screen = "screen"
+
+    // MARK: - 네트워크
+    public static let networkEndpoint  = "network_endpoint"
+    public static let networkMethod    = "network_method"
+    public static let httpStatusCode   = "http_status_code"
+    public static let networkErrorType = "network_error_type"
+    public static let retryCount       = "retry_count"
+
+    // MARK: - 이미지 업로드
+    // fetchURL | uploadS3 | createLog
+    public static let uploadStep           = "upload_step"
+    public static let originalImageBytes   = "original_image_bytes"
+    public static let optimizedImageBytes  = "optimized_image_bytes"
+    // 이미지 최적화 실패로 원본을 그대로 사용한 경우 "true"
+    public static let optimizationFallback = "optimization_fallback"
+
+    // MARK: - 카메라
+    public static let captureErrorType = "capture_error_type"
+
+    // MARK: - 인증
+    public static let authProvider  = "auth_provider"
+    public static let authErrorType = "auth_error_type"
+
+    // MARK: - 키체인
+    // save | load | delete
+    public static let keychainOperation = "keychain_operation"
+    public static let keychainOsStatus  = "keychain_os_status"
+}

Projects/Core/Crashlytics/Project.swift

@@ -0,0 +1,26 @@
+import ProjectDescription
+import ProjectDescriptionHelpers
+
+let project = Project.makeModule(
+    name: Module.Core.name + Module.Core.crashlytics.rawValue,
+    targets: [
+        .core(
+            interface: .crashlytics,
+            config: .init(
+                dependencies: [
+                    .external(dependency: .ComposableArchitecture)
+                ]
+            )
+        ),
+        .core(
+            implements: .crashlytics,
+            config: .init(
+                dependencies: [
+                    .core(interface: .crashlytics),
+                    .external(dependency: .ComposableArchitecture),
+                    .external(dependency: .FirebaseCrashlytics)
+                ]
+            )
+        )
+    ]
+)

Projects/Core/Crashlytics/Sources/CrashlyticsClient+Live.swift

@@ -0,0 +1,24 @@
+//
+//  CrashlyticsClient+Live.swift
+//  CoreCrashlytics
+//
+
+import ComposableArchitecture
+import CoreCrashlyticsInterface
+import FirebaseCrashlytics
+
+extension CrashlyticsClient: DependencyKey {
+    public static let liveValue = Self(
+        record: { error, event in
+            let instance = Crashlytics.crashlytics()
+            event.customKeys.forEach { instance.setCustomValue($0.value, forKey: $0.key) }
+            instance.record(error: error)
+        },
+        log: { event in
+            Crashlytics.crashlytics().log(event.message)
+        },
+        setUserIdentifier: { userId in
+            Crashlytics.crashlytics().setUserID(userId)
+        }
+    )
+}