distribution_erp/docs/KAKAO_HANDOFF_TO_CLIENT.md

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

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

---

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

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

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 코드 — 콘솔 → 앱 설정 → 앱 → 플랫폼 키 → 클라이언트 시크릿 → "카카오 로그인" 의 코드

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

---

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

안녕하세요. 모모유통 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 의 키만 신규 모모유통 앱 키로 교체하면 됩니다. 코드는 변경 없음.