인증 API 연동 및 로그인 상태 관리 구조 구현 (#104) * feat: 인증 관련 데이터 및 도메인 레이어 구현 및 서버 로그인 연동 * **feat: 인증 관련 네트워크 데이터 소스 및 API 구현** * `AuthService`: `login`, `logout`, `reissueToken`, `withdraw` 등 인증 관련 Ktorfit API 엔드포인트 정의 * `AuthRemoteDataSourceImpl`: 서버 API 호출 및 인증 토큰 응답 로깅 로직 구현 * `LoginRequest`, `LoginResponse` 등 인증 관련 데이터 모델(DTO) 추가 * **feat: 도메인 및 데이터 레이어 내 AuthRepository 추가** * `core:domain` 모듈에 `AuthRepository` 인터페이스를 정의하고, `core:data`에 `AuthRepositoryImpl` 구현체를 추가했습니다. * Hilt를 이용한 `RepositoryModule` 및 `DataSourceModule` 의존성 주입 설정을 완료했습니다. * **feat: Kakao 로그인 idToken 연동 및 서버 로그인 로직 추가** * `KakaoAuthClient`: 로그인 성공 시 SDK로부터 받은 `idToken`을 `AuthResult.Success`에 포함하여 반환하도록 수정했습니다. * `LoginViewModel`: 소셜 로그인 성공 후 받은 `idToken`을 `AuthRepository.login`을 통해 서버에 전달하고 인증을 완료하는 흐름을 구현했습니다. * `LoginUiState` 및 `Intent`: 로그인 요청 중인 제공자(`pendingProvider`) 상태를 관리하도록 개선했습니다. * **refactor: 네트워크 보안 설정 및 UI 컴포넌트 개선** * `network_security_config.xml`: 개발 서버 도메인(`prezel.p-e.kr`)에 대해 명시적으로 Cleartext 트래픽 허용 설정을 추가했습니다. * `StatusView`: `StatusLottie`의 `modifier` 적용 방식을 개선하여 크기 지정 로직을 수정했습니다. * **build: 모듈 구조 변경 및 의존성 추가** * `core:domain` 모듈을 신규 생성하고 `settings.gradle.kts`에 등록했습니다. * `feature:login:impl`, `core:data` 등 주요 모듈에 `core:domain` 및 인증 관련 의존성을 추가했습니다. * `.gitignore`: `.kotlin`, `.DS_Store` 등 불필요한 파일 제외 설정을 추가했습니다. * feat: 인증 관련 UseCase 구현 및 AuthRepository 로직 확장 * **feat: 인증 관련 UseCase 및 도메인 모델 추가** * 인증 상태를 관리하기 위한 `AuthToken` 및 `WithdrawReason` 도메인 모델을 `core:model`에 추가했습니다. * `LoginUseCase`, `LogoutUseCase`, `ReissueTokenUseCase`, `WithdrawUseCase`를 추가하여 인증 관련 비즈니스 로직을 구현했습니다. * **feat: 네트워크 응답 모델 추가** * 서버 통신을 위한 `LoginResponse`, `ReissueTokenRequest`, `WithdrawRequest` DTO를 `core:network`에 추가했습니다. * **refactor: AuthRepository 및 구현체 개선** * `AuthRepository` 인터페이스에 `reissueToken`, `logout`, `withdraw` 메서드를 추가하고, `login`의 반환 타입을 `Result`으로 변경했습니다. * `AuthRepositoryImpl`에서 `WithdrawReason`을 서버 카테고리 문자열로 변환하는 매핑 로직을 구현했습니다. * `ApiResponse`를 `Result`로 변환하는 공통 확장 함수 `toResult`를 `core:data`에 추가하여 코드 중복을 제거했습니다. * **refactor: LoginViewModel 내 로그인 호출 로직 수정** * 서버 로그인 요청 시 불필요한 `provider` 파라미터를 제거하고 `idToken`만 전달하도록 수정했습니다. * **build: 모듈 의존성 및 플러그인 설정 업데이트** * `feature:login:impl`에 `core:model` 의존성을 추가했습니다. * `AndroidFeatureImplConventionPlugin`에 `timber` 라이브러리 의존성을 추가했습니다. * feat: DataStore 기반의 인증 토큰 관리 및 자동 갱신(Refresh) 시스템 구현 * **feat: `AuthTokenStore` 인터페이스 및 DataStore 기반 구현체 추가** * 인증 토큰(Access/Refresh Token)을 안전하게 저장하고 관리하기 위한 구조를 설계했습니다. * `AuthTokenStore`: 토큰 조회, 저장, 삭제를 위한 인터페이스 정의 * `DataStoreAuthTokenStore`: `Jetpack DataStore`를 사용하여 로컬에 토큰을 영구 저장하는 구현체 추가 (메모리 캐싱 및 비동기 저장 로직 포함) * `AuthTokenModule`: Hilt를 이용한 `AuthTokenStore` 의존성 주입 설정 * `libs.versions.toml` 및 `core:network` 모듈에 `datastore-preferences` 의존성 추가 * **feat: 토큰 자동 재발급 및 인증 로직 구현** * 네트워크 요청 시 인증 상태를 관리하고, 401 오류 발생 시 토큰을 자동으로 갱신하는 로직을 추가했습니다. * `AuthTokenRefresher`: Refresh Token을 사용하여 새로운 Access Token을 발급받는 기능 구현 (Mutex를 이용한 중복 요청 방지 및 실패 시 토큰 삭제) * `TokenRefreshAuthenticator`: OkHttp `Authenticator`를 구현하여 401 Unauthorized 발생 시 토큰 재발급 및 재시도 로직 처리 * `requiresAuthorization()`: 로그인, 토큰 재발급 등 인증 헤더가 불필요한 경로를 판별하는 확장 함수 추가 * **refactor: `NetworkModule` 구조 개선 및 인증 인터셉터 적용** * 인증이 필요한 요청과 토큰 재발급을 위한 클라이언트를 분리하고 공통 설정을 통합했습니다. * `provideHttpClient`: `TokenRefreshAuthenticator`를 등록하고, 요청 헤더에 `Authorization` 토큰을 자동으로 추가하도록 개선 * `provideRefreshHttpClient`: 토큰 재발급 시 무한 루프를 방지하기 위해 별도의 `@Named("refresh")` 클라이언트 추가 * `configureBaseClient`: 공통적인 Ktor 클라이언트 설정(ContentNegotiation, Logging 등)을 별도 함수로 추출 * **refactor: `AuthRepositoryImpl` 내 토큰 관리 로직 연동** * 인증 관련 API 호출 결과에 따라 로컬 토큰 상태를 동기화하도록 수정했습니다. * `login`, `reissueToken` 성공 시 발급된 토큰을 `AuthTokenStore`에 저장하도록 `saveTokens` 도우미 함수 추가 * `logout`, `withdraw` 성공 시 저장된 토큰 정보를 삭제(`clear`)하도록 변경 * refactor: `AuthTokenStore` 비동기 처리 및 로깅 보안 강화 * **refactor: `AuthTokenStore` 및 `DataStoreAuthTokenStore` 비동기화 및 안정성 개선** * `saveTokens`와 `clear` 메서드를 `suspend`로 변경하여 비동기 데이터 저장을 보장하도록 개선했습니다. * `DataStoreAuthTokenStore` 내부 로직에 `Mutex`를 도입하여 토큰 읽기/쓰기 시 발생할 수 있는 race condition을 방지했습니다. * `init` 블록에서 `runBlocking`으로 초기화하던 로직을 별도의 `initializeCache` 메서드로 분리하고 `applicationScope`를 사용하도록 수정했습니다. * **refactor: `AuthTokenRefresher` 예외 처리 및 토큰 갱신 로직 개선** * `runCatching` 대신 `try-catch` 블록을 사용하여 토큰 재발급 로직의 명시성을 높였습니다. * 토큰 재발급 성공 시 로직을 정돈하고 `Result` 반환 흐름을 개선했습니다. * **refactor: `ApiResponse` 확장 함수 및 저장 로직 비동기 대응** * `ApiResponse.toResult` 확장 함수에 `suspend` 및 `crossinline` 키워드를 추가하여 비동기 `transform` 함수를 지원하도록 변경했습니다. * `AuthRepositoryImpl`의 `saveTokens`를 `suspend`로 변경하여 변경된 `AuthTokenStore` 인터페이스를 반영했습니다. * **security: 디버그 로그 내 민감 정보 출력 제거** * `AuthRemoteDataSourceImpl`, `KakaoAuthClient`, `AuthTokenRefresher`에서 디버그 시 출력하던 실제 토큰 값(`accessToken`, `refreshToken`, `idToken`)을 로그에서 삭제하고, 성공 여부만 출력하도록 변경하여 보안을 강화했습니다. * refactor: 네트워크 로깅 정책 개선 및 AuthTokenStore 초기화 로직 단순화 * **refactor: Ktor HTTP 클라이언트 로깅 설정 변경** * 보안 강화를 위해 `Authorization` 헤더 값이 로그에 노출되지 않도록 `sanitizeHeader` 설정을 추가했습니다. * 디버그 모드에서의 로그 레벨을 `LogLevel.BODY`에서 `LogLevel.HEADERS`로 변경하여 출력 정보의 범위를 조정했습니다. * **refactor: DataStoreAuthTokenStore 초기화 방식 개선** * `AuthTokenStore` 인터페이스에서 불필요한 `initializeCache()` 메서드를 제거했습니다. * `DataStoreAuthTokenStore` 초기화 시 `CoroutineScope.launch`를 통한 비동기 방식 대신 `runBlocking`을 사용하여 인스턴스 생성 시점에 토큰 캐싱이 완료되도록 변경했습니다. * `AtomicBoolean`을 이용한 중복 초기화 방지 로직을 삭제하여 코드를 단순화했습니다. * feat: 로그인 상태 확인 로직 구현 및 스플래시 화면 흐름 개선 * **feat: CheckLoginStatusUseCase 추가** * 로컬에 저장된 토큰 상태를 확인하여 로그인 여부를 판단하는 UseCase를 추가했습니다. * Access Token이 없더라도 Refresh Token이 존재하면 토큰 재발급을 시도하여 로그인 상태를 유지하도록 로직을 구현했습니다. * **feat: SplashViewModel 내 로그인 상태에 따른 화면 전환 로직 적용** * `CheckLoginStatusUseCase`를 사용하여 초기 진입 시 사용자 상태를 확인합니다. * 성공적으로 로그인 상태가 확인되면 홈 화면(`NavigateToHome`)으로, 그렇지 않으면 로그인 화면(`NavigateToLogin`)으로 이동하도록 분기 로직을 추가했습니다. * **refactor: AuthRepository 토큰 조회 메서드 추가** * `AuthRepository` 인터페이스 및 `AuthRepositoryImpl`에 `getAccessToken()`, `getRefreshToken()` 메서드를 추가하여 저장된 토큰에 접근할 수 있도록 개선했습니다. * **build: feature:splash:impl 모듈 의존성 추가** * `CheckLoginStatusUseCase` 사용을 위해 `core:domain` 모듈에 대한 의존성을 추가했습니다. * feat: 프로필 화면 내 로그아웃 및 회원 탈퇴 기능 구현 * **feat: ProfileViewModel 내 인증 관련 비즈니스 로직 추가** * `LogoutUseCase` 및 `WithdrawUseCase`를 호출하여 로그아웃과 회원 탈퇴 기능을 구현했습니다. * `ProfileUiState`를 로딩 상태를 관리하는 `data class` 구조로 개편하고, 화면 이동을 위한 `ProfileUiEffect`를 추가했습니다. * 작업 성공 시 `NavigateToLogin` 이펙트를 발생시켜 로그인 화면으로 이동하도록 처리했습니다. * **feat: ProfileScreen UI 구현 및 ViewModel 연동** * 로그아웃 및 회원 탈퇴 버튼을 추가하고 클릭 이벤트를 ViewModel에 연결했습니다. * `LaunchedEffect`를 통해 `ProfileUiEffect`를 수집하고, `LocalNavigator`를 사용하여 루트 화면을 로그인으로 전환하는 로직을 추가했습니다. * **refactor: 네트워크 설정 및 상태 모델 정리** * `NetworkModule`: JSON 직렬화 설정에서 불필요한 `coerceInputValues` 옵션을 제거했습니다. * `ProfileUiState`: 기존 `sealed interface` 방식에서 `isLoading` 필드를 가진 `data class` 방식으로 단순화했습니다. * **build: 모듈 의존성 추가** * `feature:profile:impl` 모듈에 `core:domain`, `core:model`, `feature:login:api` 의존성을 추가했습니다. * refactor: UseCase 토큰 획득 로직 캡슐화 및 프로필 UI 피드백 개선 * **refactor: Logout 및 Withdraw UseCase 내 토큰 처리 로직 개선** * `ProfileViewModel`에서 직접 수행하던 액세스 토큰 조회 로직을 UseCase 내부로 이동하여 캡슐화를 강화했습니다. * `LogoutUseCase`: `invoke()` 시 파라미터 대신 내부적으로 `AuthRepository`를 통해 토큰을 가져오도록 변경했습니다. * `WithdrawUseCase`: `invoke()` 시 `WithdrawReason`만 받도록 변경하고, 내부에서 토큰 유효성 검사 로직을 추가했습니다. * **refactor: ProfileViewModel 리팩터링** * UseCase 변경에 따라 더 이상 필요하지 않은 `AuthRepository` 의존성을 제거했습니다. * 로그아웃 및 회원탈퇴 실패 시 `ProfileUiEffect.ShowSnackbar`를 통해 에러 메시지를 전달하도록 예외 처리를 추가했습니다. * **feat: 프로필 화면 UI 피드백 및 Scaffold 적용** * `ProfileScreen`에 `Scaffold`와 `SnackbarHost`를 도입하여 에러 발생 시 사용자에게 알림을 표시할 수 있도록 개선했습니다. * `ProfileUiEffect`에 `ShowSnackbar` 타입을 추가하여 ViewModel에서 UI로 메시지 전달이 가능하도록 정의했습니다. * 불필요한 "Profile" 텍스트를 제거하고 레이아웃을 정돈했습니다. * **docs: UseCase KDoc 업데이트** * 변경된 토큰 획득 방식(내부 조회)에 맞춰 `LogoutUseCase`와 `WithdrawUseCase`의 주석 내용을 수정했습니다. * feat: 로그아웃 및 회원 탈퇴 시 로컬 인증 상태 연동 및 AuthManager 개선 * **feat: `AuthManager` 로그아웃 로직 강화** * `currentProvider`가 명시되지 않은 상태더라도 `authClients`에 등록된 공급자가 하나라면 해당 공급자를 통해 로그아웃을 진행할 수 있도록 예외 처리 로직을 개선했습니다. * **refactor: `ProfileViewModel` 내 로그아웃 및 탈퇴 처리 로직 수정** * 서버 측 로그아웃(`logoutUseCase`) 및 탈퇴(`withdrawUseCase`) 요청이 성공한 후, 클라이언트의 로컬 인증 세션을 정리하기 위해 `AuthManager.logout()`을 호출하도록 변경했습니다. * UseCase의 결과를 `fold`로 처리하여 성공 시에만 로컬 인증 해제 로직이 수행되도록 구현했습니다. * **build: `feature:profile:impl` 모듈 의존성 추가** * `AuthManager`를 참조하기 위해 `core:auth` 모듈에 대한 의존성을 추가했습니다. * feat: 로그인 성공 후 홈 화면 이동 로직 및 토큰 저장 방식 개선 * **feat: 로그인 성공 시 홈 화면 내비게이션 추가** * `LoginUiEffect`에 `NavigateToHome` 상태를 추가했습니다. * `LoginScreen` 및 `LoginEntryBuilder`에서 로그인 성공 시 `HomeNavKey`로 루트를 교체하는 로직을 구현했습니다. * **refactor: AuthRepositoryImpl 로그인 및 토큰 저장 로직 개선** * `login` 메서드에서 `ApiResponse` 타입에 따른 명시적인 결과 처리를 수행하도록 수정했습니다. * `ApiResponse.Success`를 직접 처리하여 토큰을 저장하고 도메인 모델(`AuthToken`)로 변환하는 오버로딩 함수를 추가했습니다. * **refactor: ApiResponseConverterFactory 및 네트워크 관련 수정** * `ApiResponseConverterFactory`에서 `ApiResponse.Success` 생성 시 파라미터 이름을 명시적으로 지정하도록 변경했습니다. * `AuthRepositoryImpl`에서 불필요하게 사용되던 기존 `toResult` 확장 함수 의존성을 제거하고 직접 응답 상태를 분기 처리합니다. * refactor: 네트워크 관련 DI 모듈 구조 개선 및 UseCase 주석 추가 * **refactor: 네트워크 DI 모듈 통합 및 이름 변경** * `AuthNetworkModule`을 삭제하고, `AuthService` 제공 로직을 공통 `NetworkModule`로 통합하여 관리 효율성을 높였습니다. * `AuthTokenModule`을 `TokenStoreModule`로 이름을 변경하여 토큰 저장소 관련 의존성 주입 역할을 명확히 했습니다. * **docs: CheckLoginStatusUseCase KDoc 주석 추가** * `core:domain` 모듈의 `CheckLoginStatusUseCase` 클래스에 로그인 상태 확인 로직의 동작 흐름(액세스 토큰 확인, 리프레시 토큰을 통한 재발급 시도 등)을 설명하는 한글 주석을 추가했습니다. * refactor: 인증 경로 정책 모듈화 및 AuthRepository 로직 개선 * refactor: `AuthPathPolicy` 싱글톤 객체 도입 인증이 필요한 API 경로 판별 로직을 별도의 객체로 분리하여 코드 중복을 제거하고 관리를 중앙화했습니다. * `AuthPathPolicy`: `/auth/login`, `/auth/reissue` 경로를 제외한 요청에 대해 인증 필요 여부(`requiresAuthorization`)를 판단하는 로직 추가 * `NetworkModule` 및 `TokenRefreshAuthenticator`에서 개별적으로 구현되어 있던 경로 확인 로직을 `AuthPathPolicy`로 교체 * refactor: `AuthRepositoryImpl` 코드 정리 및 데이터 변환 로직 개선 데이터 레이어의 가독성을 높이고 불필요한 코드를 정리했습니다. * `login`: `toResult` 확장 함수를 사용하여 응답 처리 로직을 간결하게 변경 * `saveTokens`: `ApiResponse.Success` 래퍼 대신 내부 데이터 모델(`LoginResponse`)을 직접 받도록 수정 * `WithdrawReason` 매핑: 기존 커스텀 Getter 형식을 `toCategory()`, `toReasonText()` 메서드로 변경하여 도메인 모델 변환 로직 명확화 * 불필요한 `ApiResponse` 및 관련 확장 함수(`toAuthToken`) 정리 * refactor: 인증 관련 도메인 레이어 패키지 구조 재정의 및 로직 개선 * **refactor: Auth 관련 인터페이스 및 UseCase 패키지 경로 변경** * 도메인 모델의 응집도를 높이기 위해 인증 관련 파일들을 세부 패키지로 이동했습니다. * `AuthRepository`: `core.domain` -> `core.domain.repository.auth` * `LogoutUseCase`, `ReissueTokenUseCase`, `WithdrawUseCase`, `CheckLoginStatusUseCase`, `LoginUseCase`: `core.domain.usecase` -> `core.domain.usecase.auth` * 패키지 이동에 따른 `RepositoryModule` 및 각 기능별(Splash, Login, Profile) `ViewModel` 내 참조 경로를 수정했습니다. * **refactor: AuthTokenRefresher 예외 처리 및 안정성 강화** * 토큰 재발급 중 코루틴이 취소될 경우 `CancellationException`을 명시적으로 다시 던지도록 개선했습니다. * 일반적인 `Exception` 발생 시에만 `isInvalidRefreshToken()` 여부를 확인하여 토큰 저장소를 정리하고 로그를 기록하도록 변경했습니다. * **docs: AuthTokenStore KDoc 주석 추가** * `AuthTokenStore` 인터페이스에 메모리 캐시 동기 조회 및 영속성 저장소 갱신에 관한 동작 계약을 설명하는 주석을 추가했습니다. * **style: 코드 포맷팅 정리** * `AuthRepositoryImpl`, `AuthPathPolicy`, `TokenRefreshAuthenticator` 등 일부 클래스의 줄바꿈 및 불필요한 공백을 수정했습니다. * feat: API 에러 응답 처리 강화 및 프로필 기능 내 인증 예외 처리 구현 * **feat: 공통 API 에러 응답 모델 및 예외 클래스 추가** * 서버 응답 규격에 맞춘 `ApiErrorResponse` 모델을 `core:network`에 추가했습니다. * HTTP 에러 발생 시 상태 코드와 서비스 에러 코드를 포함하는 `ApiHttpException` 도메인 예외 클래스를 정의했습니다. * `ApiResponseConverterFactory`에서 HTTP 에러 응답 바디를 파싱하여 `ApiResponse.Failure.HttpError`에 포함하도록 개선했습니다. * `ApiResponse.toResult` 확장 함수에서 `ResponseException`을 `ApiHttpException`으로 변환하여 반환하도록 수정했습니다. * **refactor: AuthTokenRefresher 로직 개선** * `AuthTokenRefresher`가 직접 `HttpClient`를 사용하지 않고 `AuthRemoteDataSource`를 의존하도록 변경했습니다. * 토큰 재발급 실패 시, 에러 코드(`T001`, `U003`)를 확인하여 복구 불가능한 세션인 경우에만 로컬 토큰을 삭제하도록 로직을 정교화했습니다. * **feat: 프로필(Profile) 기능 내 인증 만료 및 에러 처리 구현** * 로그아웃 및 회원 탈퇴 실패 시, 인증 만료 코드(`U001`) 여부에 따라 로그인 화면으로 강제 이동시키고 안내 메시지를 표시하는 로직을 추가했습니다. * `ProfileUiState`, `ProfileUiEffect`를 `contract` 패키지로 이동하고 `UiState`, `UiEffect` 인터페이스를 상속받도록 리팩터링했습니다. * `ProfileUiMessage` 열거형과 관련 문자열 리소스(`logout_failed`, `withdraw_failed`, `authentication_expired`)를 추가했습니다. * **refactor: 로그인(Login) UI 메시지 네이밍 컨벤션 적용** * `LoginUiMessage`의 상수 이름을 대문자 스네이크 케이스(`LOGIN_CANCELLED` 등)로 변경하여 통일성을 높였습니다. * **misc: 기타 설정 변경** * `AndroidManifest.xml`에 `usesCleartextTraffic="true"` 설정을 추가했습니다. * `AuthManager`에 현재 인증 프로바이더 정보를 초기화하는 `clearCurrentProvider()` 메서드를 추가했습니다. * 루트 `build.gradle.kts`에서 불필요한 `kotlin.jvm` 플러그인 설정을 제거했습니다. * refactor: `AuthTokenStore` 모듈 분리 및 인증 예외 처리 로직 강화 * **feat: `core:datastore` 모듈 생성 및 `AuthTokenStore` 이전** * `core:network`에 위치하던 `AuthTokenStore` 인터페이스와 `DataStoreAuthTokenStore` 구현체를 신규 생성한 `core:datastore` 모듈로 이동하여 책임을 분리했습니다. * DataStore 관련 의존성을 `core:network`에서 `core:datastore`로 재배치했습니다. * `CoroutineScopesModule`을 이동하고 `Dispatchers.IO`를 기본값으로 사용하도록 수정했습니다. * **refactor: `AuthRepository` 및 `UseCase` 인증 로직 개선** * `AuthRepository` 인터페이스에서 `logout`, `withdraw` 호출 시 외부에서 `accessToken`을 전달받던 방식을 내부 `AuthTokenStore`에서 직접 참조하는 방식으로 변경했습니다. * 이에 따라 `LogoutUseCase`와 `WithdrawUseCase`에서 토큰 존재 여부를 확인하던 중복 로직을 제거했습니다. * `AuthRepositoryImpl`에서 인증 실패(U001) 코드 응답 시, 로컬 토큰을 삭제하고 `AuthenticationRequiredException`을 반환하도록 개선했습니다. * **feat: `AuthenticationRequiredException` 도메인 에러 추가** * 인증이 필요한 상황을 명시적으로 처리하기 위한 커스텀 예외 클래스를 `core:domain`에 추가했습니다. * `ProfileViewModel`에서 하드코딩된 에러 코드로 판단하던 로직을 해당 예외 타입을 확인하도록 리팩터링했습니다. * **refactor: `NetworkModule` 정리** * 사용하지 않는 `refresh` 전용 HttpClient 설정을 제거하여 의존성 구조를 단순화했습니다. * refactor: 인증 토큰 관리 로직 개선 및 ProfileViewModel 안정성 강화 * **refactor: `DataStoreAuthTokenStore` 초기화 방식 변경** * 초기 토큰 로드 시 사용하던 `runBlocking`을 제거하고 `applicationScope.launch`를 이용한 비동기 방식으로 변경하여 메인 스레드 차단 가능성을 방지했습니다. * **refactor: `AuthRepositoryImpl` 인증 예외 처리 강화** * 로그아웃 및 회원 탈퇴 시 액세스 토큰이 없는 경우, 단순히 에러를 반환하던 방식에서 로컬 토큰을 초기화(`clear`)한 후 인증 필요 예외를 반환하도록 `clearTokensAndAuthenticationRequired` 메서드를 추가했습니다. * **refactor: `ProfileViewModel` 로딩 상태 관리 개선** * 로그아웃(`logout`) 및 회원 탈퇴(`withdraw`) 로직에 `try-finally` 블록을 적용했습니다. 이를 통해 작업 성공 여부나 예외 발생과 관계없이 `isLoading` 상태가 `false`로 안전하게 변경되도록 보장했습니다. * **style: `AuthRepositoryImpl` 코드 포맷팅 수정** * `login` 메서드의 줄바꿈 등 가독성 향상을 위한 코드 스타일을 정리했습니다. * refactor: `AuthActionResult` 도입 및 인증 관련 비즈니스 로직 리팩터링 * **feat: `AuthActionResult` sealed interface 추가** * 인증 기반 작업(로그아웃, 회원 탈퇴)의 결과를 명확하게 정의하기 위해 `Success`, `AuthenticationRequired`, `Failure` 상태를 가지는 `AuthActionResult`를 `core:domain`에 추가했습니다. * 기존의 `AuthenticationRequiredException`을 제거하고 도메인 모델을 통한 상태 처리를 지향하도록 변경했습니다. * **refactor: `LogoutUseCase` 및 `WithdrawUseCase` 반환 타입 변경** * 기존 `Result` 대신 `AuthActionResult`를 반환하도록 수정했습니다. * UseCase 내부에 있던 토큰 조회 로직을 Repository로 위임하여 책임을 분리하고 설명을 보완하는 KDoc을 업데이트했습니다. * **refactor: `AuthRepository` 및 `AuthRepositoryImpl` 로직 개선** * `logout` 및 `withdraw` 메서드의 반환 타입을 `AuthActionResult`로 변경했습니다. * 토큰 부재 시 `clearTokensAndAuthenticationRequired`를 호출하여 상태를 일관되게 관리하도록 수정했습니다. * API 응답 유형(Success, HttpError, NetworkError)에 따라 `AuthActionResult`를 매핑하는 `toAuthActionResult` 확장 함수를 추가했습니다. * **refactor: `ProfileViewModel` 내 인증 결과 처리 로직 고도화** * `handleAuthActionResult`를 추가하여 `AuthActionResult` 상태에 따른 UI 에펙트(`NavigateToLogin`, `ShowMessage`) 및 `AuthManager` 상태 제어 로직을 통합했습니다. * 로그아웃 및 회원 탈퇴 호출 시 중복되던 후처리 로직을 간소화했습니다. * refactor: AuthActionResult 위치 이동 및 패키지 구조 개선 * refactor: `AuthActionResult` 클래스 패키지 경로 변경 `AuthActionResult` 인터페이스를 UseCase 패키지에서 Result 관련 공통 패키지로 이동하여 도메인 레이어의 구조를 개선했습니다. * `core:domain` 내 `usecase.auth` -> `result.auth`로 파일 이동 및 패키지 명 수정 * refactor: 패키지 이동에 따른 의존성 참조 수정 `AuthActionResult`의 위치가 변경됨에 따라 이를 참조하는 Repository, UseCase, ViewModel 등의 import 문을 업데이트했습니다. * `AuthRepository`, `AuthRepositoryImpl` 내 import 수정 * `WithdrawUseCase`, `LogoutUseCase` 내 import 수정 * `feature:profile:impl` 모듈의 `ProfileViewModel` 내 import 수정 * refactor: 인증 토큰 관리 로직 개선 및 네트워크 모듈 리팩터링 * **refactor: AuthRemoteDataSource 및 AuthService 내 토큰 파라미터 제거** * `logout` 및 `withdraw` API 호출 시 명시적으로 전달하던 `accessToken` 파라미터를 제거했습니다. * 이는 공통 인터셉터나 `Authenticator`를 통해 인증 헤더가 자동으로 처리되도록 개선됨에 따른 변경입니다. * **feat: 토큰 재발급 전용 HttpClient 및 서비스 분리** * 토큰 재발급(`reissueToken`) 시 무한 루프를 방지하기 위해 `@Named("refresh")`를 사용하여 별도의 `HttpClient`와 `AuthService`를 생성하도록 `NetworkModule`을 수정했습니다. * `AuthTokenRefresher`가 `AuthRemoteDataSource` 대신 분리된 `refresh` 전용 `AuthService`를 직접 의존하도록 변경했습니다. * **refactor: WithdrawReason 카테고리 매핑 문자열 수정** * `AuthRepositoryImpl`에서 `WithdrawReason` 도메인 모델을 서버 스펙에 맞는 상수 문자열로 변환하는 로직을 업데이트했습니다. * 예: `TOO_DIFFICULT_OR_COMPLEX` -> `TOO_COMPLEX`, `OTHER` -> `ETC` 등. * **fix: DataStoreAuthTokenStore 초기화 시 스레드 안전성 확보** * `applicationScope`에서 초기 토큰 로드 시 `mutex`를 사용하여 동시성 이슈를 방지했습니다. * **refactor: ApiResponseConverterFactory 에러 처리 개선** * `parseErrorResponse`에서 `runCatching` 대신 `try-catch`를 사용하고, `CancellationException` 발생 시 코루틴 취소 흐름이 유지되도록 `rethrowIfCancellation()`을 추가했습니다. * **chore: ProfileViewModel 로그 및 예외 처리 추가** * 로그아웃 실패 시 Timber를 이용한 경고 로그를 추가하여 로컬 세션 정리 실패 상황을 모니터링할 수 있도록 개선했습니다. * refactor: 네트워크 모듈 주요 클래스 및 함수의 접근 제어자 수정 * **refactor: 네트워크 관련 클래스 및 주입 함수를 `internal`로 변경** * 외부 모듈에 노출될 필요가 없는 인증 및 네트워크 설정 관련 코드의 캡슐화를 강화하기 위해 `internal` 접근 제어자를 추가했습니다. * `NetworkModule.kt`: `provideHttpClient` 함수를 `internal`로 변경 * `AuthTokenRefresher.kt`: `AuthTokenRefresher` 클래스를 `internal`로 변경 및 `@Named` 어노테이션 위치 수정 (`@param:Named`) * `TokenRefreshAuthenticator.kt`: `TokenRefreshAuthenticator` 클래스를 `internal`로 변경 * chore: .gitignore 파일 정리 * `.kotlin/` 디렉토리 및 `.DS_Store` 파일 제외 설정 제거 * refactor: `AuthTokenStore` 초기화 동기화 로직 추가 및 관련 레이어 개선 * **feat: `AuthTokenStore` 초기화 대기 로직 구현** * DataStore의 데이터를 메모리(`accessToken`, `refreshToken`)로 로드하는 비동기 작업을 추적하기 위해 `initializationJob`을 도입했습니다. * `awaitInitialized()` 메서드를 추가하여 토큰 저장(`saveTokens`)이나 삭제(`clear`) 요청 시 초기화가 완료될 때까지 대기하도록 보장했습니다. * **refactor: `AuthRepository` 및 `CheckLoginStatusUseCase` 안정성 강화** * `AuthRepository` 인터페이스와 `AuthRepositoryImpl`에 `awaitTokenStoreInitialized()`를 추가하여 데이터 레이어의 초기화 상태를 도메인 레이어에서 제어할 수 있도록 개선했습니다. * `CheckLoginStatusUseCase` 호출 시, 토큰 존재 여부를 확인하기 전에 저장소 초기화를 먼저 대기하도록 수정하여 정확한 로그인 상태를 판별하게 했습니다. * refactor: 인증 토큰 관리 로직 강화 및 사용자 경험 개선 * **feat: `AuthTokenStore` 초기화 계약 및 대기 로직 추가** * `AuthTokenStore` 인터페이스에 영속 저장소 데이터가 메모리 캐시에 적재될 때까지 대기하는 `awaitInitialized()` 메서드를 추가하고 관련 KDoc을 상세화했습니다. * `CheckLoginStatusUseCase`에서 토큰 확인 전 `awaitTokenStoreInitialized()`를 호출하여 데이터 정합성을 보장하도록 개선했습니다. * **refactor: 토큰 재발급 실패 처리 로직 강화** * `AuthRepositoryImpl`에서 토큰 재발급(`reissueToken`) 실패 시, 복구 불가능한 에러 코드(`T001`: 토큰 무효, `U003`: 사용자 없음 등)인 경우 로컬 토큰을 즉시 삭제하도록 수정했습니다. * **refactor: 프로필 화면 UI/UX 개선** * `ProfileViewModel`: 인증 만료 시 메시지 출력 후 로그인 화면으로 이동하도록 이벤트 순서를 조정했습니다. * `ProfileScreen`: `Scaffold`와 개별 `SnackbarHost` 대신 공통 `LocalSnackbarHostState`를 사용하도록 변경하고 레이아웃 구조를 단순화했습니다. * **style: 코드 정리 및 가독성 개선** * `DataStoreAuthTokenStore` 내 불필요한 import 정리 및 `AuthRepositoryImpl` 내 response 처리 로직의 가독성을 높였습니다. * refactor: AuthRepositoryImpl 내 토큰 재발급 로직 및 예외 처리 방식 개선 * **refactor: 토큰 재발급 실패 시 예외 처리 로직 고도화** * `reissueToken` 호출 시 HTTP 에러가 발생하면 사유와 상관없이 `authTokenStore.clear()`를 호출하여 토큰을 초기화하도록 단순화했습니다. * 에러 반환 시 `ApiResponse` 확장 함수 대신 `ApiHttpException`을 명시적으로 생성하여 실패 결과(`Result.failure`)를 전달하도록 변경했습니다. * 네트워크 에러 발생 시에도 `ApiResponse.Failure.NetworkError`에서 추출한 throwable을 통해 실패 결과를 반환하도록 수정했습니다. * **refactor: 불필요한 에러 코드 및 유틸리티 로직 제거** * 특정 에러 코드(`TOKEN_INVALID_CODE`, `USER_NOT_FOUND_CODE`)에 의존하여 복구 가능 여부를 판단하던 `isRefreshUnrecoverable()` 확장 함수를 삭제했습니다. * 사용하지 않는 `AUTHENTICATION_REQUIRED_CODE`를 제외한 나머지 companion object 상수들을 정리했습니다. * feat: 로그인 상태 확인 로직 개선 및 네트워크 오류 처리 추가 * **feat: `LoginStatusResult` 도메인 모델 추가** * 로그인 상태를 명확하게 구분하기 위해 `Authenticated`, `Unauthenticated`, `RetryableFailure` 상태를 포함하는 sealed interface를 추가했습니다. * **refactor: `CheckLoginStatusUseCase` 반환 타입 및 예외 처리 변경** * 반환 타입을 `Boolean`에서 `LoginStatusResult`로 변경하여 세부적인 상태를 전달하도록 수정했습니다. * 토큰 재발급 실패 시, `ApiHttpException`인 경우 인증되지 않음(`Unauthenticated`)으로 처리하고, 그 외의 네트워크 오류 등은 재시도 가능 실패(`RetryableFailure`)로 분류하도록 로직을 강화했습니다. * **feat: Splash 화면 내 네트워크 오류 대응 로직 구현** * `SplashUiEffect`에 `ShowRetryableFailureMessage`를 추가했습니다. * `SplashViewModel`에서 `CheckLoginStatusUseCase` 결과에 따라 적절한 UI Effect를 발생시키도록 수정했습니다. * `SplashScreen`에서 재시도 가능한 실패 발생 시 스낵바 메시지를 출력하도록 구현하고, 관련 문자열 리소스를 추가했습니다. * refactor: 인증 토큰 재발급 로직 개선 및 불필요한 예외 클래스 제거 * **refactor: `AuthRepository` 및 토큰 재발급 결과 처리 로직 개선** * `reissueToken`의 반환 타입을 `Result`에서 `LoginStatusResult`로 변경하여 인증 상태를 명확하게 관리하도록 수정했습니다. * 토큰 재발급 성공 시 토큰을 저장하고 `Authenticated` 상태를 반환하며, HTTP 에러 발생 시 토큰 저장소를 비우고 `Unauthenticated` 상태를 반환하도록 로직을 강화했습니다. * `CheckLoginStatusUseCase`에서 수동으로 예외를 검사하던 로직을 `AuthRepository`에서 반환된 `LoginStatusResult`를 바로 사용하도록 단순화했습니다. * **refactor: 불필요한 에러 모델 및 확장 함수 정리** * 사용되지 않는 커스텀 예외 클래스인 `ApiHttpException`을 삭제했습니다. * `ApiResponse.toResult` 확장 함수에서 `ApiHttpException`으로 변환하던 로직을 제거하고 원본 `throwable`을 그대로 반환하도록 수정했습니다. * `ReissueTokenUseCase`가 `AuthRepository`의 변경된 구조에 흡수됨에 따라 해당 클래스를 삭제했습니다. * **fix: UI 관련 버그 수정 및 안정성 향상** * `SplashScreen`: 로그인 상태 체크와 UI 효과 수집(collect) 로직이 서로 간섭하지 않도록 별도의 `LaunchedEffect` 블록으로 분리했습니다. * `ProfileScreen`: 스낵바 표시 시 `rememberCoroutineScope`를 사용하여 코루틴 내에서 안전하게 호출되도록 수정했습니다. * refactor: Splash 및 Profile 기능 안정성 강화 및 UI 로직 개선 * **refactor: ProfileScreen 구조 개선 및 리팩터링** * `ProfileScreen`의 UI 렌더링 부분을 `ProfileScreenContent`로 분리하여 가독성을 높였습니다. * `ProfileUiMessage`를 리소스 ID로 변환하는 로직을 별도 확장 함수(`toTextRes`)로 추출했습니다. * 불필요한 `rememberCoroutineScope`를 제거하고 `LaunchedEffect` 내에서 직접 스낵바를 호출하도록 수정했습니다. * **refactor: AuthRepositoryImpl 내 로그인 상태 체크 로직 보완** * HTTP 에러 발생 시 특정 에러 코드(`AUTHENTICATION_REQUIRED_CODE`)인 경우에만 토큰을 삭제하고 미인증 상태로 처리하도록 변경했습니다. * 그 외의 HTTP 에러는 `RetryableFailure`로 분류하여 예외 처리 로직을 강화했습니다. * **refactor: Splash 및 Profile 뷰모델 로깅 및 로직 개선** * `SplashViewModel`: 로그인 상태 확인 실패 시 `Timber`를 이용한 경고 로그를 추가했습니다. * `ProfileViewModel`: 로그 출력 시 사용하던 불필요한 태그(`ProfileTest`)를 제거하고 일관된 로깅 방식을 적용했습니다. * `SplashScreen`: 불필요한 코루틴 스코프 생성을 제거하고 스낵바 호출 로직을 단순화했습니다. * **style: 가시성 제한자 수정** * `ProfileScreen`의 가시성을 `internal`로 변경하여 모듈 캡슐화를 강화했습니다. * refactor: 인증 관련 Repository 구조 개선 및 UseCase 로직 리팩터링 * **refactor: AuthRepository 및 CheckLoginStatusUseCase 개선** * `CheckLoginStatusUseCase`에 흩어져 있던 로그인 상태 확인 로직(토큰 존재 여부 확인 및 재발급 시도)을 `AuthRepository.checkLoginStatus()`로 캡슐화하여 일원화했습니다. * `AuthRepository`에서 외부로 노출되던 `getAccessToken`, `getRefreshToken`, `reissueToken` 등의 저수준 메서드를 인터페이스에서 제거했습니다. * `AuthRepositoryImpl` 내부에 `awaitTokenStoreInitialized` 로직을 통합하여 상태 확인 시 초기화를 보장하도록 수정했습니다. * **refactor: LoginUseCase 및 ViewModel 리팩터링** * `LoginUseCase`의 반환 타입을 `Result`에서 `Result`으로 변경하여 호출부에서 불필요한 토큰 데이터에 의존하지 않도록 개선했습니다. * `LoginViewModel`에서 `AuthRepository`를 직접 참조하던 방식을 `LoginUseCase`를 사용하도록 변경하여 도메인 레이어 의존성 원칙을 준수했습니다. * **docs: UseCase KDoc 업데이트** * 로직 변경에 맞춰 `LoginUseCase` 및 `CheckLoginStatusUseCase`의 동작 흐름 설명을 최신화했습니다. * refactor: Ktor Auth 플러그인 도입 및 네트워크 설정 강화 * **feat: Ktor `Auth` 플러그인을 이용한 토큰 관리 및 자동 갱신 구현** * 기존 OkHttp 기반의 `TokenRefreshAuthenticator`를 삭제하고 Ktor 전용 `Auth` 플러그인으로 대체했습니다. * `loadTokens`: `AuthTokenStore`에서 Access/Refresh 토큰을 불러와 인증 헤더를 구성합니다. * `refreshTokens`: 토큰 만료 시 `AuthTokenRefresher`를 통해 토큰을 자동 갱신하도록 개선했습니다. * `sendWithoutRequest`: `AuthPathPolicy`를 참조하여 인증이 필요한 경로에만 토큰을 전송하도록 설정했습니다. * **feat: 네트워크 타임아웃 및 User-Agent 설정 추가** * `HttpTimeout` 플러그인을 추가하여 요청(15s), 연결(10s), 소켓(15s) 타임아웃을 설정했습니다. * `UserAgent` 플러그인을 도입하여 앱 버전, 안드로이드 OS 버전, 기기 모델 정보를 포함하는 커스텀 User-Agent를 구성했습니다. * **refactor: `AuthRepositoryImpl` 토큰 체크 로직 개선** * `logout` 및 `withdraw` 시 토큰 존재 여부를 확인할 때 `null` 체크 외에 `isNullOrBlank()`를 사용하도록 방어 로직을 강화했습니다. * **build: Ktor Auth 의존성 추가** * `libs.versions.toml` 및 `core:network` 모듈에 `ktor-client-auth` 의존성을 추가했습니다. * build: merge origin/develop to feat/#103-auth-api2 * refactor: 인증 토큰 관리 로직 개선 및 초기화 방식 변경 * **refactor: Ktor Bearer 인증 토큰 로드 및 갱신 로직 개선** * `loadTokens` 단계에서 Access Token 존재 여부만 필수적으로 확인하도록 변경했습니다. (Refresh Token은 `orEmpty()`로 처리) * `refreshTokens` 과정에서 Refresh Token이 null인 경우에도 `BearerTokens`를 생성할 수 있도록 방어 로직을 수정했습니다. * `core:network` 모듈 내 `NetworkModule`의 토큰 처리 구조를 안정화했습니다. * **feat: 앱 실행 시 AuthTokenStore 조기 초기화 적용** * `PrezelApplication`에서 `AuthTokenStore`를 주입받아 `onCreate` 시점에 `getAccessToken()`을 호출하도록 추가했습니다. * 이를 통해 DataStore 기반의 토큰 저장소가 앱 런타임 시작과 동시에 백그라운드에서 미리 초기화되도록 개선했습니다. * **build: app 모듈 의존성 추가** * `app/build.gradle.kts`에 `core:datastore` 의존성을 추가하여 `AuthTokenStore` 접근을 허용했습니다. * feat: AuthLocalDataSource 도입 및 로컬 인증 관리 로직 추상화 * **feat: `AuthLocalDataSource` 인터페이스 및 구현체 추가** * `AuthTokenStore`에 직접 의존하던 로직을 추상화하기 위해 `AuthLocalDataSource` 레이어를 추가했습니다. * 토큰 조회(`getAccessToken`, `getRefreshToken`), 저장(`saveTokens`), 초기화 대기(`awaitInitialized`), 삭제(`clear`) 기능을 포함합니다. * Hilt를 사용하여 `AuthLocalDataSourceImpl`을 `Singleton`으로 주입하도록 `LocalDataSourceModule`을 구성했습니다. * **refactor: `AuthRepositoryImpl` 내 데이터 소스 참조 변경** * 기존에 `AuthTokenStore`를 직접 참조하여 토큰을 관리하던 로직을 새로 추가된 `AuthLocalDataSource`를 거치도록 변경했습니다. * 로그인 상태 확인(`checkLoginStatus`), 로그아웃(`logout`), 회원 탈퇴(`withdraw`) 시 토큰 조작 로직을 일관성 있게 업데이트했습니다. * refactor: 네트워크 모듈 구조 개선 및 `@RefreshNetwork` 한정자 도입 * **refactor: `@Named("refresh")`를 커스텀 한정자 `@RefreshNetwork`로 대체** * 의존성 주입 시 문자열 기반의 `@Named` 대신 타입 안정성을 보장하는 `@RefreshNetwork` 커스텀 한정자(Qualifier)를 정의하고 적용했습니다. * `NetworkModule` 및 `AuthTokenRefresher`에서 토큰 재발급용 클라이언트 식별 방식을 변경했습니다. * **refactor: `NetworkModule` 내 HTTP 클라이언트 및 Ktorfit 설정 로직 구조화** * 중복되는 클라이언트 생성 로직을 `createHttpClient` 및 `createKtorfit` 공통 함수로 추출하여 가독성을 높였습니다. * 인증이 필요한 클라이언트 설정을 `configureAuthenticatedClient` 확장 함수로 분리했습니다. * `AuthTokenStore`의 토큰 정보를 `BearerTokens`로 변환하는 `toBearerTokens` 도우미 함수를 추가하여 코드를 간결화했습니다. * **refactor: UserAgent 빌더 로직 개선** * `buildUserAgent` 함수 내 문자열 결합 방식을 `buildString`을 사용하는 구조로 개선했습니다. * **cleanup: `LoginViewModel` 내 불필요한 메서드 제거** * 사용되지 않는 `fetchMyInfo` 메서드를 삭제하여 코드를 정리했습니다. * refactor: 인증 토큰 관리 로직 개선 및 Ktor BearerAuth 연동 최적화 * **refactor: `AuthTokenStore` 및 `AuthLocalDataSource` 구조 개선** * `AuthTokenStore`에서 메모리 캐싱 및 `awaitInitialized` 로직을 제거하고 DataStore를 통한 비동기 조회(`getToken`) 방식으로 단순화했습니다. * `core:data` 모듈에 있던 `AuthLocalDataSource`를 `core:network` 모듈로 이동하고, `AuthToken` 도메인 모델을 사용하도록 변경했습니다. * `core:datastore` 모듈에 `core:model` 의존성을 추가했습니다. * **refactor: Ktor Bearer Auth 및 토큰 재발급 로직 고도화** * Ktor `BearerAuthProvider`의 `cacheTokens = true` 설정을 적용하여 라이브러리 수준의 캐싱을 활용하도록 개선했습니다. * `AuthTokenRefresher`가 `String?` 대신 `BearerTokens?`를 반환하도록 변경하여 갱신된 Access/Refresh 토큰 쌍을 한 번에 적용합니다. * `NetworkModule` 내에서 `AuthLocalDataSource`를 직접 주입받아 인증 클라이언트를 구성하도록 수정했습니다. * **refactor: `AuthRepositoryImpl` 내 토큰 관리 및 HttpClient 연동** * 토큰 저장(`saveToken`) 또는 삭제(`clearTokens`) 시 `httpClient.clearAuthTokens()`를 호출하여 Ktor 클라이언트의 인증 캐시를 동기화하도록 개선했습니다. * 인증이 필요한 동작(로그아웃, 탈퇴) 전 토큰 존재 여부를 확인하는 로직을 `AuthToken` 모델 기반으로 수정했습니다. * **build: 의존성 및 초기화 로직 정리** * `ktor` 버전을 `3.3.3`에서 `3.4.3`으로 업데이트했습니다. * `PrezelApplication`에서 불필요해진 `AuthTokenStore` 강제 초기화 로직을 제거했습니다. * `core:data` 및 `app` 모듈의 불필요한 의존성을 정리했습니다. * refactor: 토큰 재발급 로직 개선 및 불필요한 네트워크 구성 요소 제거 * **refactor: `AuthTokenRefresher`의 토큰 재발급 방식 변경** * 전용 `AuthService` 대신 Ktor `RefreshTokensParams`에서 제공하는 클라이언트를 사용하여 직접 API를 호출하도록 변경했습니다. * `@RefreshNetwork` 한정자 및 관련 의존성 주입 설정을 제거하여 구조를 단순화했습니다. * `RefreshTokensParams`의 기존 토큰 정보를 활용하도록 개선하고, 재발급 요청 시 `markAsRefreshTokenRequest()`를 호출하여 무한 루프를 방지합니다. * `ResponseException` 발생 시 에러 응답 코드를 분석하여 세션 복구 불가능 여부를 판단하고 토큰을 삭제하는 예외 처리 로직을 강화했습니다. * **refactor: `NetworkModule` 내 중복 클라이언트 제거 및 설정 조정** * 토큰 재발급을 위해 별도로 유지하던 `provideRefreshHttpClient`, `provideRefreshKtorfit`, `provideRefreshAuthService` 등을 모두 삭제했습니다. * `HttpTimeout` 설정의 하드코딩된 밀리초 값을 제거하고 기본 설정을 사용하도록 변경했습니다. * **cleanup: 불필요한 파일 삭제** * 더 이상 사용되지 않는 `@RefreshNetwork` 어노테이션 정의 파일(`RefreshNetwork.kt`)을 삭제했습니다. * refactor: AuthTokenRefresher 리팩터링 및 토큰 재발급 로직 개선 * **feat: `AuthTokenRefreshResult` sealed interface 추가** * 토큰 재발급 결과를 명확하게 처리하기 위해 `Success`, `Failure.Retryable`, `Failure.Unrecoverable` 상태를 정의했습니다. * **refactor: `AuthTokenRefresher` 로직 분리 및 가시성 변경** * 클래스 가시성을 `internal`에서 `public`으로 변경했습니다. * Ktor `Authenticator` 내부에서만 사용되던 로직을 외부에서도 호출 가능하도록 `refreshToken` 메서드로 추출했습니다. * `isSessionRecoveryUnrecoverable` 판단 로직에 인증 필요 코드(`U001`)를 추가하여 세션 만료 처리를 강화했습니다. * **refactor: `AuthRepositoryImpl` 내 로그인 상태 확인 로직 개선** * 기존 `authRemoteDataSource.reissueToken`을 직접 호출하던 방식에서 `AuthTokenRefresher`를 사용하도록 변경했습니다. * `AuthTokenRefreshResult`에 따라 로컬 토큰 삭제 및 인증 상태(`LoginStatusResult`) 반환 로직을 일관성 있게 수정했습니다. * **style: 불필요한 코드 정리** * `AuthRepositoryImpl`에서 사용하지 않는 `AUTHENTICATION_REQUIRED_CODE` 상수를 제거하고 `AuthTokenRefresher` 내부 상수를 사용하도록 변경했습니다. * refactor: UI 및 디자인 시스템 패키지 구조 개선 * **refactor: 디자인 시스템 및 UI 모듈 패키지 경로 변경** * 디자인 시스템의 스낵바 경로를 `component.modal.snackbar`에서 `component.feedback.snackbar`로 변경했습니다. * `UiIntent`, `UiState`, `BaseViewModel` 등 공통 UI 기반 클래스들의 패키지를 `core.ui`에서 `core.ui.base`로 이동했습니다. * `LocalSnackbarHostState`의 패키지 경로를 `core.ui`에서 `core.ui.state`로 변경했습니다. * **refactor: Feature 모듈 내 변경된 패키지 참조 수정** * `splash`, `my`, `login` 기능 모듈에서 변경된 `BaseViewModel`, `UiIntent`, `UiState`, `showPrezelSnackbar` 등의 import 경로를 일괄 업데이트했습니다. * refactor: AuthLocalDataSource 통합 및 인증 토큰 관리 로직 개선 * **refactor: AuthTokenStore와 AuthLocalDataSource 통합 및 위치 변경** * `core:network`에 위치하던 `AuthLocalDataSource` 인터페이스 및 구현체를 `core:datastore` 모듈로 이동하고 `AuthTokenStore`를 흡수 통합했습니다. * `AuthLocalDataSource.getToken()`의 반환 타입을 단일 객체(`AuthToken?`)에서 `Flow`으로 변경하여 데이터 스트림을 지원하도록 개선했습니다. * `saveToken` 및 `clear` 메서드의 반환 타입을 `Result`으로 변경하여 작업 성공 여부를 캡처할 수 있도록 강화했습니다. * **feat: JSON 직렬화 기반 토큰 저장 방식 도입** * `AuthToken` 모델에 `@Serializable` 어노테이션을 추가하고, DataStore 저장 시 개별 키 저장 방식에서 JSON 문자열로 직렬화하여 하나의 키(`auth_token`)로 관리하도록 변경했습니다. * `core:model` 및 `core:datastore` 모듈에 `kotlinx-serialization` 의존성을 추가했습니다. * **refactor: AuthRepositoryImpl 및 AuthTokenRefresher 로직 수정** * `AuthLocalDataSource`의 인터페이스 변경(`Flow` 및 `Result` 반환)에 따라 인증 체크, 로그인, 로그아웃, 탈퇴 로직을 리팩터링했습니다. * `AuthTokenRefresher`에서 재발급된 토큰 저장 실패 시 예외 처리 및 로그 출력을 추가했습니다. * `NetworkModule`에서 토큰 로드 시 `getToken().first()`를 사용하여 최신 토큰을 가져오도록 수정했습니다. * **build: 의존성 주입(Hilt) 모듈 정리** * `TokenStoreModule`을 제거하고 `DataSourceModule`을 통해 `AuthLocalDataSource`를 주입하도록 설정을 업데이트했습니다. * refactor: 인증 토큰 관리 로직 리팩터링 및 Ktor 인증 캐시 무효화 시스템 도입 * **feat: AuthTokenCacheInvalidator 인터페이스 및 구현체 추가** * Ktor의 `clearAuthTokens()`를 호출하여 메모리 내 인증 토큰 캐시를 비우는 `AuthTokenCacheInvalidator` 인터페이스를 추가했습니다. * `KtorAuthTokenCacheInvalidator`: `HttpClient`를 주입받아 실제 무효화 로직을 수행하는 구현체입니다. * `AuthTokenCacheModule`: Hilt를 사용하여 `AuthTokenCacheInvalidator` 의존성을 바인딩했습니다. * **refactor: AuthLocalDataSource를 통한 토큰 캐시 무효화 일원화** * 토큰 저장(`saveToken`) 또는 삭제(`clear`) 시, `AuthTokenCacheInvalidator`를 호출하여 네트워크 클라이언트의 토큰 상태를 동기화하도록 개선했습니다. * 이로 인해 `AuthRepositoryImpl`에서 수동으로 `httpClient.clearAuthTokens()`를 호출하던 중복 로직을 제거했습니다. * **refactor: AuthRepository 및 RemoteDataSource 내 불필요 로직 제거** * `AuthRepositoryImpl`: `checkLoginStatus`에서 수행하던 수동 토큰 재발급(Reissue) 로직을 제거하고 로컬 토큰 존재 여부만 확인하도록 간소화했습니다. (Ktor `Auth` 플러그인에 역할 위임) * `AuthRemoteDataSource`: 사용하지 않는 `reissueToken` 메서드 및 관련 DTO 의존성을 제거했습니다. * **style: NetworkModule 설정 변경** * `NetworkModule`의 Json 설정에서 불필요한 `prettyPrint = false` 옵션을 제거했습니다. * refactor: 인증 토큰 관리 로직 및 토큰 재발급 프로세스 개선 * **refactor: `AuthLocalDataSource` 내 토큰 저장 및 캐시 무효화 로직 개선** * `saveToken` 메서드에 `invalidateCache` 파라미터를 추가하여 토큰 저장 시 캐시 무효화 여부를 선택할 수 있도록 수정했습니다. * `saveToken` 및 `clear` 성공 시에만 캐시 무효화 로직(`invalidateAuthTokenCaches`)이 실행되도록 변경했습니다. * `runSuspendCatching` 내 예외 처리 순서를 조정하여 `CancellationException`이 올바르게 전파되도록 수정하고, 캐시 무효화 실패 시 Timber 로그를 남기도록 개선했습니다. * **refactor: `AuthTokenRefresher` 토큰 재발급 로직 최적화** * 불필요한 `reissueToken` 메서드를 삭제했습니다. * 토큰 재발급 성공 후 `saveToken` 호출 시 `invalidateCache = false` 옵션을 적용하여, 재발급 과정 중 불필요한 캐시 무효화가 발생하지 않도록 개선했습니다. * **remove: `AuthService` 내 미사용 엔드포인트 제거** * `AuthService` 인터페이스에서 더 이상 사용하지 않는 `reissueToken` API 정의와 관련 DTO(`ReissueTokenRequest`) 참조를 삭제했습니다. * **build: `core:datastore` 모듈 의존성 추가** * 로깅 처리를 위해 `libs.timber` 의존성을 추가했습니다. * feat: 인증 세션 만료 이벤트 버스 및 DataStore 기반 토큰 관리 시스템 고도화 * **feat: 인증 세션 만료 알림 시스템 구현** * 인증 만료 이벤트를 정의하는 `AuthSessionEvent` sealed interface 추가 * 이벤트를 발행하고 구독하기 위한 `AuthSessionEventPublisher`, `AuthSessionEventStream` 인터페이스 추가 * `DefaultAuthSessionEventBus`를 통해 앱 전역에서 세션 만료를 감지하고 처리할 수 있는 구조 구현 * `MainActivity` 및 `PrezelApp`에서 세션 만료 시 로그인 화면으로 전환하고 사용자 정보를 정리하도록 연동 * **refactor: `AuthTokenStore` 도입 및 데이터 레이어 추상화** * `core:network` 모듈에 `AuthTokenStore` 인터페이스를 정의하여 `core:datastore`에 대한 직접적인 의존성 제거 * `core:data` 모듈에서 `AuthTokenStore`를 구현(`DataAuthTokenStore`)하여 `AuthLocalDataSource`와 네트워크 레이어 연결 * 불필요해진 `AuthTokenCacheInvalidator` 관련 로직 및 모듈 제거 * **refactor: `AuthTokenRefresher` 및 네트워크 보안 로직 강화** * `AuthTokenRefresher`가 `AuthTokenStore`를 사용하도록 수정 * 토큰 재발급 실패(Unrecoverable) 시 `AuthSessionExpiredNotifier`를 호출하여 세션 만료 이벤트를 전파하도록 개선 * Ktor `HttpClient` 설정에서 `cacheTokens` 옵션을 `false`로 변경하여 토큰 관리 신뢰성 향상 * **refactor: DataStore 설정 및 모듈 분리** * `DataStoreModule`을 통해 `DataStore` 주입 설정을 별도로 분리 * `AuthLocalDataSourceImpl`에서 직접 수행하던 DataStore 빌드 로직을 삭제하고 주입받은 인스턴스를 사용하도록 변경 * **build: 모듈 간 의존성 정렬** * `core:network`에서 `core:datastore` 의존성 제거 * `app` 모듈에 `core:domain` 의존성 추가 등 레이어 설계에 따른 의존성 최적화 * refactor: 인증 세션 이벤트 버스 구조 개선 및 모듈 분리 * **refactor: `AuthSessionEventBus` 구현 및 이벤트 처리 로직 개선** * `AuthSessionEventStream`의 `events` 타입을 `SharedFlow`에서 일반 `Flow`로 변경하고, 이벤트를 초기화할 수 있는 `clearSessionExpiredEvent()` 메서드를 추가했습니다. * `DefaultAuthSessionEventBus` 구현체를 `MutableSharedFlow`에서 `MutableStateFlow` 기반으로 변경하여 상태 관리 효율성을 높였습니다. * `PrezelApp`에서 세션 만료 이벤트 처리 후 `clearSessionExpiredEvent()`를 호출하여 중복 처리를 방지하도록 수정했습니다. * **feat: `AuthDataModule` 분리 및 의존성 주입 설정** * 기존 `DataModule`에 포함되어 있던 인증 관련 의존성(TokenStore, Notifier, EventBus)을 신규 생성한 `AuthDataModule`로 분리하여 모듈성을 강화했습니다. * **refactor: `AuthTokenRefresher` 예외 처리 로직 강화** * 토큰 재발급 실패 시 토큰 삭제(`clear`) 성공 여부에 따라 세션 만료 알림을 보내도록 흐름을 개선했습니다. * 삭제 실패 시 에러 로그를 출력하고 세션 알림을 건너뛰도록 예외 처리를 구체화했습니다. * refactor: 인증 세션 이벤트 관리 로직 리팩터링 (`AuthSessionEventBus` -> `AuthSessionMonitor`) * **refactor: 인증 세션 모니터링 인터페이스 및 구현체 변경** * 기존의 `AuthSessionEventStream` 및 `DefaultAuthSessionEventBus`를 삭제하고, 보다 명확한 역할을 수행하는 `AuthSessionMonitor`와 `DefaultAuthSessionMonitor`를 도입했습니다. * `clearSessionExpiredEvent()` 메서드명을 `acknowledgeSessionEvent()`로 변경하여 이벤트 확인 처리에 대한 의미를 강화했습니다. * `AuthSessionEventPublisher` 인터페이스를 별도 파일로 분리했습니다. * **refactor: 앱 수준의 세션 관리 구조 개선** * `PrezelAppState`에서 `AuthSessionMonitor`를 직접 보유하도록 수정하여 상태 관리의 응집도를 높였습니다. * `MainActivity`에서 `AuthSessionMonitor`를 주입받아 `PrezelAppState` 생성 시 전달하도록 변경했습니다. * `PrezelApp` UI 컴포넌트에서 `appState`를 통해 세션 이벤트를 구독하고, 세션 만료 시 로그인 화면 이동 및 이벤트 확인 로직을 수행하도록 리팩터링했습니다. * **build: 의존성 주입(Hilt) 설정 업데이트** * `AuthDataModule`에서 새로운 인터페이스인 `AuthSessionMonitor`와 그 구현체인 `DefaultAuthSessionMonitor`를 바인딩하도록 수정했습니다. * test: AuthTokenRefresher 유닛 테스트 구현 및 테스트 환경 설정 * test: `AuthTokenRefresher` 클래스에 대한 단위 테스트 추가 Ktor `MockEngine`을 사용하여 토큰 재발급 및 세션 만료 로직의 시나리오별 동작을 검증하는 테스트 코드를 작성했습니다. * **토큰 재발급 성공**: 서버로부터 새 토큰을 받았을 때 `AuthTokenStore`에 저장하고 `BearerTokens`를 반환하는지 확인 * **토큰 재발급 실패(401 Unauthorized)**: Refresh Token 만료 시 로컬 토큰을 삭제하고 `AuthSessionExpiredNotifier`를 통해 세션 만료 알림이 수행되는지 확인 * `FakeAuthTokenStore`, `FakeAuthSessionExpiredNotifier` 등 테스트용 더블 구현 * build: 테스트를 위한 Ktor Mock 엔진 의존성 추가 * `libs.versions.toml`에 `ktor-client-mock` 라이브러리 추가 * `core:network` 모듈의 `testImplementation`에 해당 의존성 적용 * feat: 인증 및 세션 관리 로직 개선 * **feat: URL 기반에서 속성(Attribute) 기반 인증 정책으로 전환** * 특정 URL 패턴을 하드코딩하여 인증을 제외하던 `AuthPathPolicy`를 삭제했습니다. * `AuthRequestAttributes`를 추가하여 Ktor `AttributeKey`를 통해 요청별로 인증 제외 여부(`SkipAuthKey`)를 설정할 수 있도록 개선했습니다. * `AuthService`의 `login` API에 `@Tag`를 사용하여 인증 제외 속성을 적용했습니다. * **refactor: 로그아웃 및 탈퇴 시 토큰 관리 로직 강화** * `AuthRepositoryImpl`: 로그아웃 요청 시 HTTP 에러나 네트워크 에러가 발생하더라도 로컬 토큰을 강제로 삭제하도록 변경했습니다. * `AuthManager`: 세션 만료 시 각 소셜 로그인 제공자(SDK)의 로그아웃 로직을 일괄 처리하는 `clearAuthSession` 메서드를 추가했습니다. * `MyViewModel`: 로그아웃 및 회원 탈퇴 성공 시 로컬 세션 정리 로직을 `onSuccess` 콜백으로 분리하여 구조를 개선했습니다. * **refactor: 토큰 재발급(Refresh) 및 예외 처리 개선** * `AuthTokenRefresher`: 재발급 요청 시 `SkipAuthKey` 속성을 명시적으로 추가하여 무한 루프를 방지했습니다. * `ResponseException` 분석 시 취소 예외(`CancellationException`)에 대한 전파 로직을 정교화했습니다. * `AuthRemoteDataSourceImpl`: 로그인 실패 로그 메시지를 한글로 변경하고 명확하게 개선했습니다. * **test: 네트워크 테스트 코드 구조 정리** * `AuthTokenRefresherTest` 파일 위치를 `com.team.prezel.core.network` 패키지로 이동하고 불필요한 `.gitkeep` 파일을 삭제했습니다. * **ui: 세션 만료 처리 로직 개선** * `MainActivity` 및 `PrezelApp`: 세션 만료 이벤트 수신 시 `AuthManager.clearAuthSession`을 비동기로 호출하여 외부 SDK 세션까지 안전하게 정리하도록 수정했습니다. * refactor: 인증 토큰 관리 로직 최적화 및 안정성 강화 * **feat: `AuthLocalDataSource` 내 메모리 캐시 계층 도입** * `DataStore` 접근 횟수를 줄이기 위해 `MutableStateFlow`와 `Mutex`를 이용한 토큰 캐싱 로직을 추가했습니다. * 초기 1회 로드 이후에는 캐시된 데이터를 사용하며, 저장/삭제 시 캐시가 동기화되도록 개선했습니다. * **refactor: `AuthTokenRefresher` 중복 재발급 방지 로직 개선** * 토큰 재발급 요청 전, 현재 저장된 토큰이 이미 갱신되었는지 확인하는 로직을 추가했습니다. * 요청 보낸 토큰과 저장된 토큰이 다를 경우, 추가 API 호출 없이 즉시 최신 토큰을 반환하도록 수정했습니다. * 관련 시나리오에 대한 단위 테스트(`AuthTokenRefresherTest`)를 추가했습니다. * **refactor: `AuthRepositoryImpl` 로그인 실패 처리 강화** * `login` 성공 후 토큰 저장 과정에서 실패(`onFailure`)할 경우, 무결성을 위해 `clearTokens()`를 호출하도록 예외 처리를 추가했습니다. * **style: `AuthRepositoryImpl` 응답 처리 가독성 개선** * `login` 메서드 내 `when` 절의 각 브랜치를 블록 형식으로 변경하여 가독성을 높였습니다. * refactor: 인증 응답 모델 및 토큰 관리 구조 개선 * refactor: 전역 이벤트 기반 인증 만료 처리 구조 개선 * refactor: 카카오 로그인 흐름 및 인증 UI 상태 단순화 * refactor: 공용 CoroutineScope 모듈 위치 및 의존 구조 정리 * refactor: ForceLogout 후 Splash 라우팅 및 앱 내비게이션 구조 정리 * refactor: core-ui 로딩 애셋 리소스 prefix 규칙 정리 * refactor: 인증 모듈 구조 개선 * refactor: 인터페이스 구현체 명명 규칙 변경 (Default -> Impl) * **refactor: 주요 인터페이스 구현체의 클래스명 변경** * 기존 `Default-` 접두사를 사용하던 구현체들을 `-Impl` 접미사 형태로 변경하여 명명 규칙을 통일했습니다. * `DefaultAuthRepository` -> `AuthRepositoryImpl` * `DefaultGlobalEventBus` -> `GlobalEventBusImpl` * `DefaultTokenProvider` -> `TokenProviderImpl` * **refactor: DI 모듈 내 변경된 구현체 참조 반영** * `AuthModule`, `RepositoryModule`, `GlobalEventModule`에서 `@Binds`를 통해 주입되는 클래스명을 새로운 구현체 이름으로 업데이트했습니다. * refactor: GlobalEventModule 위치 이동 및 패키지 구조 개선 * **refactor: GlobalEventModule을 core:common 모듈로 이동** * `GlobalEventModule`을 `app` 모듈에서 `core:common` 모듈의 `di` 패키지로 이동했습니다. * 패키지 경로를 `com.team.prezel`에서 `com.team.prezel.core.common.di`로 변경했습니다. * refactor: MyViewModel 내 미사용 의존성 및 import 제거 * **refactor: `MyViewModel` 생성자 및 의존성 정리** * 현재 사용되지 않는 `LogoutUseCase` 및 `WithdrawUseCase` 의존성을 생성자에서 제거했습니다. * 의존성 제거에 따라 불필요해진 관련 import 구문을 삭제했습니다. * refactor: 네트워크 클라이언트 생성 로직 분리 및 `HttpClientFactory` 도입 * **refactor: `HttpClientFactory` 추가를 통한 클라이언트 설정 로직 캡슐화** * `NetworkModule`에 집중되어 있던 Ktor `HttpClient` 구성 로직을 전담 클래스인 `HttpClientFactory`로 이동했습니다. * Default Request, Content Negotiation, UserAgent, Logging, Auth 등 설정을 개별 메서드로 분리하여 가독성과 유지보수성을 높였습니다. * `buildUserAgent` 메서드를 팩토리 내부로 이동하여 Android OS 버전, SDK 버전, 제조사 및 모델명을 포함한 정형화된 User-Agent 형식을 정의했습니다. * **refactor: 인증 및 토큰 재발급 로직 고도화** * `Bearer` 인증 설정 내 `refreshTokens` 로직을 개선하여 토큰 재발급 실패 시 `tokenProvider`를 초기화하고 `GlobalEventBus`를 통해 `ForceLogout` 이벤트를 전송하도록 수정했습니다. * `AuthTokens` 및 `ReissueResponse` 모델을 Ktor의 `BearerTokens`로 변환하는 확장 함수를 추가했습니다. * `authServiceProvider`를 `Provider` 형태로 주입받아 순환 참조 문제를 방지하고 필요한 시점에 `AuthService`를 호출하도록 개선했습니다. * **refactor: `NetworkModule` 구조 단순화** * `HttpClient` 생성 시 `HttpClientFactory.create()`를 사용하도록 변경하여 모듈 내 불필요한 설정 코드를 제거했습니다. * `NetworkModule`에서 직접 관리하…

Uh oh!

Auth API 연동 #103

Description

📌 작업 사항

💡 기타

Metadata

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Issue actions