[FE/Auth] 소셜 신규가입 동의 화면 및 가입 완료 흐름 연동

[bottlenote-app]

목적

소셜 로그인 응답이 신규 가입 필요 상태일 때 동의 화면으로 전환하고, 필수 동의 항목·문서 버전을 가입 완료 API로 전송한 뒤 소셜 로그인을 다시 수행하는 흐름을 구현한다.

연동 계약

• Backend 계약: [BE/Auth] 인증 후 동의 이력 API·Agreement Gate #362
• 기존 회원 로그인 응답: 기존 로그인 완료 흐름과 동일하게 토큰 기반 세션 진입
• 신규 회원 로그인 응답: SIGNUP_REQUIRED 상태와 signupToken 수신, 일반 인증 토큰 없음
• 가입 완료: POST /api/v2/auth/signup

{
  "signupToken": "신규 사용자 임시 인증 토큰",
  "agreements": [
    { "type": "TERMS_OF_SERVICE", "version": "2026-08-01" },
    { "type": "PRIVACY_COLLECTION_USE", "version": "2026-08-01" }
  ]
}

작업 범위

• Apple/Kakao 소셜 로그인 응답의 상태값으로 기존 로그인과 신규 가입 필요 흐름을 분기한다.
• 신규 회원은 가입 동의 화면으로 이동하며, 일반 인증이 필요한 화면으로 진입하지 않는다.
• 이용약관·개인정보 수집·이용 동의 항목을 필수값으로 표시하고 해당 문서 버전을 함께 전송한다.
• 가입 완료 API 성공 후 Apple/Kakao 소셜 로그인 흐름을 다시 호출하여 정식 로그인 세션으로 진입한다.
• 가입 실패·토큰 만료·재시도·뒤로가기 시 동의 상태와 오류 안내를 일관되게 처리한다.
• 기존 회원의 Apple/Kakao 로그인·refresh 흐름에 회귀가 없도록 확인한다.

완료 기준

• 기존 회원은 소셜 로그인 직후 기존과 같은 로그인 완료 흐름으로 진입한다.
• 최초 회원은 SIGNUP_REQUIRED 응답 후 동의 화면으로 전환된다.
• 필수 동의가 없으면 가입 완료 요청을 보내지 않는다.
• 제공된 signupToken, 동의 유형, 문서 버전을 가입 완료 API에 전송한다.
• 가입 완료 후 재로그인으로 정식 세션에 진입한다.
• Apple/Kakao 각각에서 신규·기존 회원 흐름을 QA한다.

관련

• 정책/문서 페이지 작업: [FE/Policy] 이용약관·개인정보 처리방식 내부 페이지 전환 #324
• 가입 동의 정책/계약: 기획: 신규가입 동의·개인정보 처리 기준 및 구현 계약 확정 #361 (closed)