o2o-castad-backend/app/user/services/kakao.py

"""
카카오 OAuth API 클라이언트

카카오 로그인 인증 흐름을 처리하는 클라이언트입니다.
"""

import logging

import aiohttp
from fastapi import HTTPException, status

from config import kakao_settings

logger = logging.getLogger(__name__)

from app.user.schemas.user_schema import KakaoTokenResponse, KakaoUserInfo


# =============================================================================
# 카카오 OAuth 예외 클래스 정의
# =============================================================================
class KakaoException(HTTPException):
    """카카오 관련 기본 예외"""

    def __init__(self, status_code: int, code: str, message: str):
        super().__init__(status_code=status_code, detail={"code": code, "message": message})


class KakaoAuthFailedError(KakaoException):
    """카카오 인증 실패"""

    def __init__(self, message: str = "카카오 인증에 실패했습니다."):
        super().__init__(status.HTTP_400_BAD_REQUEST, "KAKAO_AUTH_FAILED", message)


class KakaoAPIError(KakaoException):
    """카카오 API 호출 오류"""

    def __init__(self, message: str = "카카오 API 호출 중 오류가 발생했습니다."):
        super().__init__(status.HTTP_500_INTERNAL_SERVER_ERROR, "KAKAO_API_ERROR", message)


class KakaoOAuthClient:
    """
    카카오 OAuth API 클라이언트

    카카오 로그인 인증 흐름:
    1. get_authorization_url()로 카카오 로그인 페이지 URL 획득
    2. 사용자가 카카오에서 로그인 후 인가 코드(code) 발급
    3. get_access_token()으로 인가 코드를 액세스 토큰으로 교환
    4. get_user_info()로 사용자 정보 조회
    """

    AUTH_URL = "https://kauth.kakao.com/oauth/authorize"
    TOKEN_URL = "https://kauth.kakao.com/oauth/token"
    USER_INFO_URL = "https://kapi.kakao.com/v2/user/me"

    def __init__(self) -> None:
        self.client_id = kakao_settings.KAKAO_CLIENT_ID
        self.client_secret = kakao_settings.KAKAO_CLIENT_SECRET
        self.redirect_uri = kakao_settings.KAKAO_REDIRECT_URI

    def get_authorization_url(self) -> str:
        """
        카카오 로그인 페이지 URL 반환

        Returns:
            카카오 OAuth 인증 페이지 URL
        """
        auth_url = (
            f"{self.AUTH_URL}"
            f"?client_id={self.client_id}"
            f"&redirect_uri={self.redirect_uri}"
            f"&response_type=code"
        )
        logger.info(f"[KAKAO] 인증 URL 생성 - redirect_uri: {self.redirect_uri}")
        logger.debug(f"[KAKAO] 인증 URL 상세 - auth_url: {auth_url}")
        return auth_url

    async def get_access_token(self, code: str) -> KakaoTokenResponse:
        """
        인가 코드로 액세스 토큰 획득

        Args:
            code: 카카오 로그인 후 발급받은 인가 코드

        Returns:
            KakaoTokenResponse: 카카오 토큰 정보

        Raises:
            KakaoAuthFailedError: 토큰 발급 실패 시
            KakaoAPIError: API 호출 오류 시
        """
        logger.info(f"[KAKAO] 액세스 토큰 요청 시작 - code: {code[:20]}...")
        try:
            async with aiohttp.ClientSession() as session:
                data = {
                    "grant_type": "authorization_code",
                    "client_id": self.client_id,
                    "redirect_uri": self.redirect_uri,
                    "code": code,
                }

                if self.client_secret:
                    data["client_secret"] = self.client_secret

                logger.debug(f"[KAKAO] 토큰 요청 데이터 - redirect_uri: {self.redirect_uri}, client_id: {self.client_id[:10]}...")

                async with session.post(self.TOKEN_URL, data=data) as response:
                    result = await response.json()
                    logger.debug(f"[KAKAO] 토큰 응답 상태 - status: {response.status}")

                    if "error" in result:
                        error_desc = result.get(
                            "error_description", result.get("error", "알 수 없는 오류")
                        )
                        logger.error(f"[KAKAO] 토큰 발급 실패 - error: {result.get('error')}, description: {error_desc}")
                        raise KakaoAuthFailedError(f"카카오 토큰 발급 실패: {error_desc}")

                    logger.info("[KAKAO] 액세스 토큰 발급 성공")
                    logger.debug(f"[KAKAO] 토큰 정보 - token_type: {result.get('token_type')}, expires_in: {result.get('expires_in')}")
                    return KakaoTokenResponse(**result)

        except KakaoAuthFailedError:
            raise
        except Exception as e:
            logger.error(f"[KAKAO] API 호출 오류 - error: {str(e)}")
            raise KakaoAPIError(f"카카오 API 호출 중 오류 발생: {str(e)}")

    async def get_user_info(self, access_token: str) -> KakaoUserInfo:
        """
        액세스 토큰으로 사용자 정보 조회

        Args:
            access_token: 카카오 액세스 토큰

        Returns:
            KakaoUserInfo: 카카오 사용자 정보

        Raises:
            KakaoAuthFailedError: 사용자 정보 조회 실패 시
            KakaoAPIError: API 호출 오류 시
        """
        logger.info("[KAKAO] 사용자 정보 조회 시작")
        try:
            async with aiohttp.ClientSession() as session:
                headers = {"Authorization": f"Bearer {access_token}"}

                async with session.get(self.USER_INFO_URL, headers=headers) as response:
                    result = await response.json()
                    logger.debug(f"[KAKAO] 사용자 정보 응답 상태 - status: {response.status}")

                    if "id" not in result:
                        logger.error(f"[KAKAO] 사용자 정보 조회 실패 - response: {result}")
                        raise KakaoAuthFailedError("카카오 사용자 정보를 가져올 수 없습니다.")

                    kakao_id = result.get("id")
                    kakao_account = result.get("kakao_account", {})
                    profile = kakao_account.get("profile", {})

                    logger.info(f"[KAKAO] 사용자 정보 조회 성공 - kakao_id: {kakao_id}")
                    logger.debug(f"[KAKAO] 사용자 상세 정보 - nickname: {profile.get('nickname')}, email: {kakao_account.get('email')}")
                    return KakaoUserInfo(**result)

        except KakaoAuthFailedError:
            raise
        except Exception as e:
            logger.error(f"[KAKAO] API 호출 오류 - error: {str(e)}")
            raise KakaoAPIError(f"카카오 API 호출 중 오류 발생: {str(e)}")


kakao_client = KakaoOAuthClient()