다크 모드
레퍼럴 코드
정보
레퍼럴 코드는 기존 사용자가 초대 링크를 통해 새로운 사용자를 초대할 수 있는 시스템입니다. 추천인과 피추천인의 관계(UserReferral)가 기록됩니다.
기능 소개
- 모든 사용자에게 고유한 레퍼럴 코드가 계정 생성 시 자동으로 부여됩니다.
- 레퍼럴 코드가 포함된 초대 링크를 통해 앱에 진입한 신규 사용자가 가입하면 추천 관계가 자동으로 등록됩니다.
- 추천인과 피추천인의 연결 이력이 UserReferral로 관리됩니다.
- 자신의 레퍼럴 코드가 포함된 초대 링크를 다른 사람에게 공유할 수 있습니다.
동작 규칙
- 자동 레퍼럴 코드 부여: 모든 사용자에게 계정 생성 시 고유한 레퍼럴 코드가 자동으로 발급됩니다. 사용자가 직접 코드를 생성하거나 변경할 수 없습니다.
- 딥링크를 통한 자동 적용: 레퍼럴 코드는 초대 링크(딥링크)에 포함되어 전달됩니다. 신규 사용자가 초대 링크를 통해 앱에 진입한 후 가입하면 레퍼럴 코드가 자동으로 적용됩니다. 사용자가 직접 레퍼럴 코드를 입력하는 별도 화면은 없습니다.
- 유효하지 않은 코드 무시: 초대 링크에 포함된 레퍼럴 코드가 존재하지 않는 코드인 경우 추천 관계가 등록되지 않을 뿐, 가입 자체에는 영향을 주지 않습니다.
- 1회 적용 제한: 한 사용자는 하나의 레퍼럴 코드만 적용할 수 있습니다. 가입 시점에 적용된 추천 관계는 이후에 변경할 수 없습니다.
- 추천 관계 기록: 유효한 레퍼럴 코드가 적용되면 추천인(코드 소유자)과 피추천인(가입자) 간의 UserReferral 관계가 생성됩니다.
- 선택 사항: 레퍼럴 코드 없이도 가입이 가능합니다. 초대 링크가 아닌 일반 경로로 앱에 진입한 경우 추천 관계 없이 가입됩니다.
사용자 흐름
레퍼럴 코드를 통한 가입 (피추천인)
초대 링크 수신
기존 사용자로부터 레퍼럴 코드가 포함된 초대 링크를 받습니다.
앱 진입
초대 링크를 통해 앱에 진입합니다. 레퍼럴 코드가 자동으로 저장됩니다.
온보딩 완료
전화번호 인증과 온보딩을 완료하면 저장된 레퍼럴 코드가 자동으로 적용되어 추천 관계가 등록됩니다.
초대 링크 공유 (추천인)
초대 링크 공유
사용자가 자신의 레퍼럴 코드가 포함된 초대 링크를 공유 기능을 통해 지인에게 전달합니다.
추천 관계 등록
지인이 해당 링크를 통해 앱에 진입하고 가입을 완료하면 추천 관계가 자동으로 등록됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-09 | 최초 작성 |
| 2026-03-10 | 코드 기반 검증: 레퍼럴 코드 적용 방식을 수동 입력에서 딥링크 자동 적용으로 수정, 유효하지 않은 코드 무시 규칙 반영, 사용자 흐름을 초대 링크 기반으로 재구성 |