# 🔑 API Keys & 외부 연동 설정

모든 키는 **없어도 앱은 동작**합니다 (fallback 또는 dry-run). 키 등록 시 해당 기능이 자동으로 실 연동.

## 1. Anthropic Claude (AI 보험금 판정)
- **발급**: [https://console.anthropic.com](https://console.anthropic.com) → API Keys
- **k8s secret key**: `api-secrets.anthropicApiKey`
- **환경변수**: `ANTHROPIC_API_KEY`
- **없을 때**: 룰베이스 판정 (키워드 매칭)

## 2. Naver Clova OCR (영수증/증권 OCR)
- **발급**: [https://www.ncloud.com/product/aiService/ocr](https://www.ncloud.com/product/aiService/ocr) → 도메인 생성 → APIGW 호출 URL + Secret Key
- **k8s secret key**: `api-secrets.clovaOcrUrl`, `api-secrets.clovaOcrSecret`
- **환경변수**: `CLOVA_OCR_URL`, `CLOVA_OCR_SECRET`
- **없을 때**: Google Vision 시도 → 그것도 없으면 OCR 스킵 (수동 입력)

## 3. Google Cloud Vision (OCR fallback)
- **발급**: [https://console.cloud.google.com](https://console.cloud.google.com) → Vision API 활성화 → API key
- **환경변수**: `GCP_VISION_API_KEY`

## 4. Solapi 카카오 알림톡
- **발급**: [https://solapi.com](https://solapi.com) 가입 + API key
- **카카오 비즈채널**: [https://center-pf.kakao.com](https://center-pf.kakao.com) 개설 → 검색ID (pfId)
- **발신번호 등록** + **알림톡 템플릿 심사** (1~2주)
- **환경변수**: `SOLAPI_API_KEY`, `SOLAPI_API_SECRET`, `SOLAPI_PFID`, `SOLAPI_SENDER_KEY`
- **없을 때**: `console.log`로 드라이런

## 5. 카카오 로그인 (웹)
- **발급**: [https://developers.kakao.com](https://developers.kakao.com) → 앱 생성 → 플랫폼: Web (`https://insurance.junggomoa.com`) → JavaScript 키
- **클라이언트 빌드 환경변수**: `EXPO_PUBLIC_KAKAO_JS_KEY`
- **백엔드에서 access_token 검증**은 이미 구현 (`/auth/kakao`)

## 6. 네이버 로그인
- **발급**: [https://developers.naver.com](https://developers.naver.com) → 애플리케이션 등록 → Client ID/Secret
- 웹: 네이버 SDK 연동 필요 (LoginScreen onNaver() 커스터마이즈)
- 백엔드는 이미 완성 (`/auth/naver`)

## 7. Apple 로그인
- **Apple Developer 계정 필요** (연 $99)
- 서비스 활성화: Sign in with Apple
- iOS: `expo-apple-authentication` 자동 동작 (네이티브 빌드 후)
- 백엔드는 이미 완성 (`/auth/apple`)

## 8. CODEF 보험 통합조회
- **발급**: [https://developer.codef.io](https://developer.codef.io) → 상품 계약
- 비즈니스 계약 필요 (월 수십만원~)
- **환경변수**: `CODEF_CLIENT_ID`, `CODEF_CLIENT_SECRET`
- **없을 때**: mock 데이터 반환 (ENABLE_CODEF_MOCK=true가 기본)

## 9. Expo Push (iOS/Android 푸시)
- iOS: Apple Developer 계정 + APNs 인증서 (EAS Build 시 자동)
- Android: FCM server key 등록 (`eas credentials`)
- 무료

---

## 📦 서버에 키 등록하는 법

SSH 접속 후:
```bash
# /home/chpark/.insurance-secrets 에 export 형식으로 추가
cat >> /home/chpark/.insurance-secrets <<EOF
ANTHROPIC_API_KEY=sk-ant-...
CLOVA_OCR_URL=https://...apigw-ntruss.com/custom/v1/.../general
CLOVA_OCR_SECRET=...
SOLAPI_API_KEY=...
SOLAPI_API_SECRET=...
SOLAPI_PFID=@채널검색ID
SOLAPI_SENDER_KEY=...
CODEF_CLIENT_ID=...
CODEF_CLIENT_SECRET=...
EOF

# 재배포
cd /home/chpark/insurance && bash scripts/deploy-remote.sh
```

k8s secrets에 자동 반영됩니다.

---

## 📱 클라이언트 빌드 환경변수

`.env` 또는 EAS Build 환경변수:
```
EXPO_PUBLIC_API_BASE=https://api.insurance.junggomoa.com
EXPO_PUBLIC_KAKAO_JS_KEY=<카카오 JS 키>
EXPO_PUBLIC_NAVER_CLIENT_ID=<네이버 Client ID>
```