# 카카오 OAuth 설정 가이드

## 카카오 앱 정보

- **앱 ID**: 1165131
- **앱 이름**: 청춘약국
- **앱 유형**: 비즈 앱
- **개발자 콘솔**: https://developers.kakao.com/console/app/1165131

## Redirect URI 등록 (2025년 12월 개편 후)

> **주의**: 2025년 12월 카카오 콘솔 UI가 개편되면서 Redirect URI 위치가 변경됨.
> 기존에는 `카카오 로그인 > 일반`에 있었지만, 현재는 `앱 > 플랫폼 키` 하위로 이동됨.

### 현재 경로 (2025.12~ )

```
앱 > 플랫폼 키 > REST API 키 클릭 > 리다이렉트 URI
```

### 이전 경로 (~ 2025.11, 더 이상 사용 안 함)

```
카카오 로그인 > 일반 > Redirect URI  ← 여기 더 이상 없음
```

### 등록된 Redirect URI 목록

| 서비스 | Redirect URI |
|--------|-------------|
| 게시판 (board-system) | `https://bbs.0bin.in/auth/kakao/callback` |
| 마일리지 적립 (pharmacy-pos-qr) | `https://mile.0bin.in/claim/kakao/callback` |

## 로그아웃 Redirect URI (별도)

로그아웃용 Redirect URI는 **다른 위치**에서 설정:

```
카카오 로그인 > 고급 > 로그아웃 리다이렉트 URI
```

로그인용 Redirect URI와 혼동하지 않도록 주의.

## 웹 도메인 등록

```
앱 > 제품 링크 관리 > 웹 도메인
```

등록된 도메인 (최대 10개):
- `https://img.0bin.in` (기본)
- `https://api.0bin.in`
- `https://0bin.in`
- `https://bbs.0bin.in`
- `https://drug.0bin.in`
- `https://ani.0bin.in`
- `https://figma.0bin.in`
- `https://am.0bin.in`
- `https://ka.0bin.in`
- `https://mile.0bin.in`

## 동의항목 설정

```
카카오 로그인 > 동의항목
```

| 항목 | ID | 용도 | 비즈앱 필요 |
|------|-----|------|------------|
| 닉네임 | profile_nickname | 사용자 이름 | X |
| 프로필 사진 | profile_image | 아바타 | X |
| 이메일 | account_email | 계정 연동 | X |
| 이름 (실명) | name | 마일리지 적립자명 | O |
| 전화번호 | phone_number | 마일리지 유저 매칭 | O |

## 환경변수

```bash
KAKAO_CLIENT_ID=<REST API 키>
KAKAO_CLIENT_SECRET=<카카오 개발자 콘솔 > 앱 > 보안에서 확인>
KAKAO_REDIRECT_URI=https://mile.0bin.in/claim/kakao/callback
```

### Client ID 확인 위치

```
앱 > 플랫폼 키 > REST API 키 > 키 값
```

### Client Secret 확인 위치

```
앱 > 보안 > Client Secret 코드
```

## 관련 파일

| 프로젝트 | 파일 | 설명 |
|---------|------|------|
| pharmacy-pos-qr-system | `backend/services/kakao_client.py` | 카카오 API 클라이언트 |
| pharmacy-pos-qr-system | `backend/app.py` | OAuth 라우트 (`/claim/kakao/*`) |
| board-system-project | `backend/services/kakao_client.py` | 카카오 API 클라이언트 (원본) |
| board-system-project | `backend/routes/auth.py` | OAuth 라우트 (`/auth/kakao/*`) |

## 참고 링크

- [카카오 로그인 REST API 문서](https://developers.kakao.com/docs/latest/ko/kakaologin/rest-api)
- [카카오 로그인 설정하기](https://developers.kakao.com/docs/latest/ko/kakaologin/prerequisite)
- [카카오 앱 키 구조 개편 공지 (2025.12)](https://devtalk.kakao.com/t/upcoming-kakao-developers-app-key-update/147295)