# 카카오 로그인 — 모모유통 측 요청사항 안내

> **이 문서는 모모유통 담당자분께 전달하기 위한 안내문**입니다. 카카오 로그인 기능을 운영 환경에서 사용하기 위해, **모모유통 명의로 카카오 디벨로퍼스 앱 등록과 비즈 앱 인증**이 필요합니다.

---

## 왜 모모유통 명의가 필요한가요?

현재는 개발자의 개인 카카오 계정으로 임시 등록해 테스트 중입니다. 그러나 다음 이유로 **운영 출시 전 모모유통 명의로 이전이 필수**입니다.

1. **개인정보 처리 책임** — 사용자가 카카오로 로그인할 때 동의 화면에 "이 앱을 운영하는 사업자" 가 모모유통이어야 법적으로 맞습니다 (개인정보 보호법).
2. **이메일 권한** — 개인 앱은 카카오 이메일을 못 가져옵니다. 사업자등록증 기반의 **비즈 앱 인증** 을 받아야 이메일이 풀리고, 인증은 모모유통 명의가 필수.
3. **소유권 안정성** — 개발자가 프로젝트 떠나도 모모유통이 콘솔 접근/키 관리/검수 답변을 계속 할 수 있어야 합니다.
4. **비용 청구 책임** — 향후 카카오톡 메시지 등 유료 기능을 쓸 경우 청구가 등록자(=모모유통)에게 갑니다.

---

## 모모유통 측 작업 단계

### 0. 준비물

- **(주)모모유통 사업자등록증 PDF** (스캔본 또는 정부24 발급분)
- **회사 대표 이메일 계정** (예: `momo8443@daum.net`) — 카카오 계정 가입에 사용
- 약 **1~3 영업일 검수 대기 시간**

### 1. 카카오 계정 만들기 (카카오톡 계정과 별도)

이미 카카오톡 쓰고 계신 개인 계정이 아닌 **회사 대표 이메일로 별도 카카오 계정**을 만드는 것을 강력 권장. 담당자 변경 시 인계가 쉽고, 개인-법인 분리도 깔끔합니다.

1. https://accounts.kakao.com/weblogin/account/signup 접속
2. 이메일: `momo8443@daum.net` (또는 회사 대표 이메일)
3. 비밀번호 설정 (회사 비밀번호 관리도구에 보관 권장)

> 이미 회사 대표 이메일로 카카오톡 계정이 있으면 그걸 그대로 쓰셔도 됩니다.

### 2. 카카오 디벨로퍼스 가입

1. https://developers.kakao.com 접속
2. 우측 상단 "**로그인**" → 위에서 만든 카카오 계정으로 로그인
3. 약관 동의 화면이 뜨면 동의

### 3. 애플리케이션(앱) 등록

1. 좌측 메뉴 "**내 애플리케이션**" → "**애플리케이션 추가하기**"
2. 입력값:
   - **앱 이름**: `MOMO 유통 ERP`
   - **사업자명**: `(주)모모유통`
   - **카테고리**: 쇼핑 (또는 적절한 항목)
3. 저장하면 자동으로 앱 키들이 발급됨 (REST API 키 등)

### 4. 비즈 앱 전환 (사업자 인증)

이 단계가 **이메일 권한** 과 **운영용 정식 앱** 자격을 부여합니다.

1. 좌측 메뉴 "**비즈니스**" 클릭
2. "**비즈 앱 전환**" 또는 "**사업자 인증**" 버튼 클릭
3. 사업자등록증 PDF 업로드
4. 회사 정보 입력 (사업자등록번호, 대표자명, 주소 등 — 사업자등록증과 동일하게)
5. 신청 → **카카오 검수 대기 (1~3 영업일)**
6. 통과되면 콘솔 상단에 "비즈 앱" 배지가 붙습니다

### 5. 카카오 로그인 활성화

비즈 앱 검수 통과 **이전에도 진행 가능**합니다.

1. 좌측 메뉴 "**제품 설정 → 카카오 로그인 → 일반**"
2. 상단 "**활성화 설정**" 토글을 **ON** 으로
3. 같은 페이지 또는 "**제품 설정 → 카카오 로그인 → 동의항목**" 에서:
   - **닉네임**: "필수 동의" 로 변경
     - 동의 목적: `회원가입 시 업체명 자동 입력`
   - **카카오계정(이메일)**: 비즈 앱 인증 통과 후 "필수 동의" 로 변경
     - 동의 목적: `회원 식별 및 거래명세표 발송`

### 6. Redirect URI 등록 (개발자가 알려준 주소)

1. 좌측 메뉴 "**앱 설정 → 앱 → 플랫폼 키**"
2. "**Default Rest API Key**" 카드를 클릭
3. 페이지 안의 "**카카오 로그인 리다이렉트 URI**" 섹션에 두 줄 등록:
   - `http://localhost:3000/api/auth/kakao/callback` (개발자 로컬 테스트용)
   - `https://momotogether.com/api/auth/kakao/callback` (운영용)
4. 페이지 하단 "**저장**" 클릭

### 7. Client Secret 활성화

같은 페이지에서:

1. "**클라이언트 시크릿**" 섹션 클릭
2. "**카카오 로그인**" 옆 "**코드 발급**" → 활성화 **ON**
3. 발급된 코드는 절대 외부 노출 금지 (개발자에게 전달 시 보안 채널 사용)

### 8. 개발자를 팀원으로 초대

1. 좌측 메뉴 "**앱 설정 → 앱 → 멤버**"
2. "**멤버 초대**" 클릭
3. 개발자의 카카오 계정 (이메일 또는 카카오 ID) 입력
4. 권한: "**개발자**" 또는 "**관리자**" 선택 → 초대

---

## 개발자에게 전달할 정보

위 작업 완료 후, 아래 두 가지를 **보안 채널**(1Password, 슬랙 비공개 DM, 회사 메일 등 — **공개 채팅이나 깃허브 이슈 본문에는 절대 금지**) 로 전달:

1. **REST API 키** — 콘솔 → 앱 설정 → 앱 → 플랫폼 키 → "Default Rest API Key" 의 32자리 코드
2. **Client Secret 코드** — 콘솔 → 앱 설정 → 앱 → 플랫폼 키 → 클라이언트 시크릿 → "카카오 로그인" 의 코드

또한 팀원 초대를 보내주시면 개발자도 콘솔 접근 가능.

---

## 메시지 템플릿 (그대로 복사해서 모모유통에 전송 가능)

```text
안녕하세요. 모모유통 ERP 의 카카오 로그인 기능 준비를 위해 한 가지 부탁드릴 사항이 있습니다.

지금은 제 개인 카카오 계정으로 임시 등록해 개발/테스트 중인데, 운영 출시 전에는
모모유통 명의로 카카오 디벨로퍼스 앱을 새로 등록하시고 사업자등록증으로 비즈 앱 인증을
받으셔야 합니다. 이유는 다음과 같습니다.

1. 사용자가 카카오로 로그인할 때 동의 화면에 "이 앱을 운영하는 사업자"가 모모유통으로
   표시되어야 개인정보보호법상 책임 소재가 맞습니다.
2. 카카오 이메일을 가져오려면 비즈 앱 인증이 필수이고, 인증은 사업자등록증 명의 회사로만
   가능합니다. (현재 임시 앱은 인증 미보유라 사용자가 이메일을 직접 입력해야 합니다.)
3. 향후 제가 운영에서 빠지더라도 모모유통이 키 관리/검수 답변을 계속할 수 있어야 합니다.

아래 단계로 진행해주시면 감사하겠습니다.

[준비물]
- (주)모모유통 사업자등록증 PDF
- 회사 대표 이메일 (카카오 계정 가입용 — 가능하면 회사 메일로 별도 카카오 계정 생성)

[작업 순서]
1. https://developers.kakao.com 가입 (회사 대표 이메일 계정으로)
2. 애플리케이션 추가 (앱 이름: "MOMO 유통 ERP", 사업자명: "(주)모모유통")
3. 비즈니스 → 비즈 앱 전환 → 사업자등록증 업로드 → 검수 신청 (1~3영업일 소요)
4. 카카오 로그인 활성화 ON
5. Redirect URI 등록 (제가 별도 안내드릴 두 줄)
6. 클라이언트 시크릿 발급
7. 멤버 메뉴에서 저를 팀원으로 초대

자세한 화면별 안내는 첨부한 KAKAO_HANDOFF_TO_CLIENT.md 문서를 참고해주세요.

검수 통과되면 REST API 키와 Client Secret 코드를 보안 채널 (회사 메일이나 1Password
등 — 카카오톡이나 공개 메신저는 피해주세요) 로 전달 부탁드립니다. 운영 환경 적용은
제가 진행하겠습니다.

문의 사항 있으시면 언제든 연락 주세요. 감사합니다.

— 담당 개발자 드림
```

---

## 자주 묻는 질문

### Q. 비즈 앱 인증 안 받고 운영 시작은 안 되나요?

가능은 합니다. 다만 다음 제약이 있습니다.
- **카카오에서 이메일을 못 가져옴** → 사용자가 회원가입 시 이메일을 직접 입력해야 함 (현재 테스트 환경 동작과 동일)
- **앱이 "테스트 단계"** 로 표시되어 카카오 동의 화면에 경고가 뜰 수 있음
- **앱 관리자/팀원 외에는 로그인 못 함** 가능성 (앱 상태에 따라)

권장: 출시와 거의 동시에 비즈 인증 신청. 검수 1~3일이면 끝나니 큰 부담은 아닙니다.

### Q. 사업자등록증 외에 필요한 서류는?

기본은 사업자등록증 PDF 1장이면 충분합니다. 카카오가 추가 자료(통신판매업신고증 등)를 요청할 수 있는데, 그때 따로 안내가 옵니다.

### Q. 검수가 거절되면?

거절 사유가 메일로 옵니다. 흔한 이유:
- 사업자등록증 이미지 흐림 → 다시 촬영/스캔
- 입력 정보가 사업자등록증과 불일치 → 정확히 똑같이 (대표자명, 주소까지)
- 앱 이름이 부적절 → 회사명 또는 서비스명으로 변경

수정 후 재신청 가능합니다.

### Q. 검수 통과까지 개발/테스트는 어떻게?

지금 하던 임시 앱(개발자 명의) 그대로 사용합니다. 검수 끝나면 운영 `.env.production` 의 키만 신규 모모유통 앱 키로 교체하면 됩니다. 코드는 변경 없음.