[WORKSOUT JP] 이메일 인증

화면 정보

Screen ID	Screen Title	Screen Path
AUTH-JOIN-EMAIL-01	이메일 인증	회원가입 / 비밀번호 재설정

개요

일본향 서비스에서 사용자 본인 확인을 위해 이메일로 발송되는 6자리 숫자 인증코드 정책. 회원가입, 비밀번호 재설정 화면에서 공통으로 사용된다. 한국(WORKSOUT)의 본인인증은 휴대폰 PASS 인증을 사용하지만, 일본은 이메일 인증코드 방식을 사용한다는 점이 가장 큰 차이다.

관리 어드민: 해당 없음

화면 구성

흐름

Step 1. 이메일 입력 및 인증코드 발송
  → Step 2. 인증코드 입력
  → (필요 시) Step 3. 인증코드 재전송

Step 1 — 이메일 입력 및 인증코드 발송

사용자가 이메일 주소 입력
“인증번호 받기” 버튼 클릭
이메일로 6자리 인증코드 발송
화면에 10분 카운트다운 타이머 표시

Step 2 — 인증코드 입력

사용자가 받은 6자리 코드 입력
“확인” 버튼 클릭
검증 성공 시 다음 단계로 진행

Step 3 — 인증코드 재전송

“인증번호 재전송” 버튼 클릭
동일한 인증코드 재발송 (새 코드 발급 X)
재전송 버튼 30초간 비활성화
타이머는 최초 발송 시점 기준으로 계속 카운트다운

정책

동작 규칙

항목	규칙
사용 화면	회원가입, 비밀번호 재설정
인증코드 형식	6자리 숫자
유효시간	최초 발송 시점부터 10분
재전송 정책	10분 이내 재전송 시 동일한 코드 재발송
타이머 표시	최초 발송 시점 기준으로 카운트다운 (재전송 시에도 리셋되지 않음)
재전송 쿨다운	30초 (재전송 버튼 비활성화)
검증 실패 제한	5회
일일 최대 발송	10회

비즈니스 룰

동일 이메일로 10분 이내 재요청 시 동일한 인증코드 재발송
재전송 시 유효시간은 최초 발송 시점 기준으로 유지
타이머는 최초 발송 시점부터 계산하여 표시 (재전송 시 리셋 X)
30초 쿨다운 적용 (프론트엔드에서 버튼 비활성화 처리)
일일 최대 10회 발송 제한
5회 실패 시 일정 시간 동안 검증 차단
유효시간 만료 시 별도 에러 메시지 반환
검증 성공 시 해당 인증코드 무효화

에러 메시지

상황	메시지
재전송 쿨다운 중	30초 후 재요청이 가능합니다
재전송 성공	새 인증번호를 전송했습니다.
코드 불일치	올바른 인증번호를 입력해주세요.
검증 성공	인증되었습니다
유효시간 만료	인증번호 유효기간이 만료되었습니다.
5회 실패	인증이 일시적으로 제한되었습니다. 잠시 후 다시 시도해주세요.
이메일 미입력	이메일을 입력해주세요. (인라인 에러)
인증코드 미입력	인증번호를 입력해주세요. (인라인 에러)
재전송 쿨다운 중 클릭	30초 후 재요청이 가능합니다 (토스트) + 버튼 비활성화 유지
네트워크 오류	네트워크 연결을 확인해주세요. (토스트)

API 호출 실패 처리

실패 API	처리 방식
인증코드 발송	“인증번호 발송에 실패했습니다. 다시 시도해주세요.” 토스트 메시지
인증코드 검증	“인증 처리 중 오류가 발생했습니다. 다시 시도해주세요.” 토스트 메시지

API 연동

이메일 인증코드 발송

엔드포인트: [확인 필요] 호출 시점: 사용자가 “인증번호 받기” 또는 “인증번호 재전송” 버튼 클릭 시

비즈니스 룰

동일 이메일로 10분 이내 재요청 시 동일한 인증코드 재발송
재전송 시 유효시간은 최초 발송 시점 기준으로 유지
타이머는 최초 발송 시점부터 계산하여 표시 (재전송 시 리셋 X)
30초 쿨다운 적용 (프론트엔드에서 버튼 비활성화 처리)
일일 최대 10회 발송 제한

이메일 인증코드 검증

엔드포인트: [확인 필요] 호출 시점: 사용자가 6자리 코드 입력 완료 시 또는 “확인” 버튼 클릭 시

비즈니스 룰

5회 실패 시 일정 시간 동안 검증 차단
유효시간 만료 시 별도 에러 메시지 반환
검증 성공 시 해당 인증코드 무효화

미결 사항

항목	내용
인증코드 발송/검증 API 엔드포인트	원본 문서에 `[확인 필요]`로 명시됨 — 개발팀 확인 필요
API 응답 필드	원본 문서에 `[확인 필요]`로 명시됨 — 개발팀 확인 필요
일본향 회원가입 전체 플로우와의 연결 지점	이 문서는 이메일 인증코드 단계만 다룸. 회원가입 전체 플로우(약관 동의 → 이메일 인증 → 계정 정보 입력 등) 문서화는 별도 필요

변경 이력

버전	날짜	변경 내용
v1.0	2026-07-30	최초 작성 (인증 및 계정 마스터.md 이전)