다크 모드
온보딩
정보
온보딩은 신규 사용자가 전화번호 인증을 마친 뒤, 유저네임·이름·프로필 사진을 설정하고 truloop의 활성 사용자가 되는 과정입니다.
기능 소개
- 전화번호 인증 후 로그인을 시도했을 때, 해당 전화번호로 가입된 계정이 없으면 온보딩 화면이 표시됩니다.
- 유저네임, 이름, 프로필 사진 등 기본 프로필 정보를 설정합니다.
- 초대 링크를 통해 진입한 경우 레퍼럴 코드가 자동으로 적용되어 추천인과의 관계가 등록됩니다.
- 온보딩이 완료되면 사용자는 활성 상태로 전환되어 서비스를 이용할 수 있습니다.
동작 규칙
- 전화번호 인증 선행 필수: 온보딩은 전화번호 인증이 완료된 신규 사용자에게만 표시됩니다. 기존 사용자는 인증 후 바로 홈 화면으로 이동합니다.
- 유저네임 필수: 유저네임은 반드시 입력해야 합니다. 다른 사용자와 중복되지 않는 고유한 값이어야 합니다. 유저네임은 3~30자의 소문자 영문, 숫자, 밑줄(_), 마침표(.)로 구성되며, 영문 또는 숫자로 시작하고 끝나야 합니다.
- 이름 필수: 이름은 유저네임과 별개의 필수 항목입니다. 다른 사용자와 중복 가능합니다.
- 프로필 사진 선택: 프로필 사진은 선택 사항입니다. 계정 생성 이후 별도 단계에서 업로드할 수 있으며, 설정하지 않으면 기본 이미지가 사용됩니다.
- 레퍼럴 코드 자동 적용: 레퍼럴 코드는 초대 링크(딥링크)를 통해 앱에 진입한 경우 자동으로 적용됩니다. 사용자가 직접 입력하는 별도 화면은 없습니다. 유효한 레퍼럴 코드가 있으면 추천인과 피추천인 간의 추천 관계(UserReferral)가 등록되며, 유효하지 않은 코드는 무시됩니다.
- 온보딩 완료 시 활성 전환: 모든 필수 정보를 입력하고 온보딩을 완료하면 사용자 상태가 활성으로 전환됩니다.
- 온보딩 건너뛰기 불가: 신규 사용자는 온보딩을 완료하지 않으면 서비스의 다른 기능을 사용할 수 없습니다.
- 비회원 참여와의 관계: 비회원 참여자(Guest Participant)로 초대받았던 전화번호로 가입하면, 온보딩 완료 후 기존 비회원 참여 기록이 자동으로 연결됩니다.
- 가입 보너스: 온보딩이 완료되면 LPY(루피) 가입 보너스가 비동기로 지급됩니다. 보너스 지급이 실패하더라도 가입 자체에는 영향을 주지 않습니다.
사용자 흐름
정상 온보딩 흐름
전화번호 인증 완료
신규 사용자가 전화번호 인증을 마치면 로그인을 시도합니다. 해당 전화번호로 가입된 계정이 없으므로 온보딩 화면으로 이동합니다.
유저네임 입력
유저네임을 입력합니다. 실시간으로 중복 여부와 형식이 확인됩니다.
이름 입력
이름을 입력합니다. 이름 입력 완료 시 계정이 생성됩니다.
프로필 사진 설정 (선택)
프로필 사진을 업로드합니다. 건너뛸 수 있습니다.
권한 요청
알림, 연락처, 사진 접근 등 앱 권한을 요청합니다.
온보딩 완료
모든 설정이 끝나면 활성 사용자로 전환되고 홈 화면으로 이동합니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-09 | 최초 작성 |
| 2026-03-10 | 코드 기반 검증: 온보딩 단계 순서 수정 (생년월일 단계 제거, 유저네임/이름 분리), 레퍼럴 코드 딥링크 자동 적용으로 수정, 가입 보너스 규칙 추가, 권한 요청 단계 추가 |