1. 요약

RuleUp 온보딩에서는 다음 여섯 가지를 구현함.

• 카카오·구글 OAuth 로그인을 PKCE 방식으로 처리함.
• 권한 4종 — 알림·위치·카메라·스크린타임 — 을 필요한 시점에 요청함.
• 프로필을 설정함 — 닉네임·생일은 필수, 관심 카테고리·사진은 선택임.
• 약관 5종에 대한 동의를 받음 — 필수 3종과 선택 2종의 동의 여부와 버전을 항목별로 기록함.
• 약관과 별도로 법정 개별 동의 2종 — 개인위치정보·건강정보 — 을 받음.
• 계정 상태를 단일 상태값으로 관리하고, 로그인 및 모든 API 진입 시 이를 기준으로 접근을 제어함.

모든 후속 기능은 사용자 식별자 확정과 필요한 권한·동의 확보를 전제로 함.

2. 배경

• 자동 인증에는 GPS·사진·스크린타임을 사용함. 기능을 사용하려면 필요한 OS 권한을 확보해야 하며, 인증 결과를 티어에 누적하려면 사용자 식별자가 먼저 확정되어야 함.
• 권한 4종은 Android 26~34에서 권한 모델이 크게 다름. 이를 단일 도메인 모델로 추상화하고, 허용된 권한 범위 안에서 기능이 부분적으로 동작하도록 설계함.
• 한국 개인정보보호법상 약관 동의 버전 추적이 필요함.

3. 목표 — Goals

• 카카오·구글 OAuth로 가입·로그인을 처리함 — 기존 사용자와 신규 사용자를 분기하며, 신규 사용자는 5분 유효한 signup_token을 사용함.
• 가입 시 약관 5종과 개별 동의 2종을 항목별 {agreed, version, agreedAt} 형태로 기록함.
• 닉네임은 필수이며 자동 모더레이션을 거침. 생일도 필수이며 만 14세 이상만 가입할 수 있고, 가입 후에는 수정할 수 없음. 관심 카테고리는 12종 중 0~6개를 선택함 — 영문 enum 12종 확정(오픈 이슈 #3 해소). 성별은 API 필수 필드이며 MALE/FEMALE만 허용함. 프로필 사진은 선택이며 가입 완료 후 별도 API로 등록함.
• 가입 완료 시 시작 점수 10점과 브론즈 티어를 부여함 — tier·score·displayTier.
• 단일 활성 기기 정책을 적용함 — 다른 기기에서 로그인하면 기존 세션을 종료하고 기존 기기에 이를 알림.
• User · RefreshToken · UserAgreement 엔티티가 생성돼 후속 모듈이 참조 가능함