Reward Formula Specification v3

04. 추천 리워드 계산식 (Referral Formula)

문서 ID: RES-FML-04
문서명: Referral Formula
볼륨: Volume 2 --- Reward Formula Specification v3
버전: 3.0
상태: Official Standard
공개 등급: Public Specification

1. 목적

본 문서는 Reward Engine Standard(RES)의 추천 리워드(Referral Reward) 계산 규칙을 정의한다.

추천 리워드는 광고 활동을 통해 발생한 공식 리워드를 기준으로 계산되며, 독립적인 리워드가 아니라 공식 리워드 계산 결과를 기반으로 생성된다.

2. 적용 범위

본 문서는 다음 항목에 적용된다.

직접 추천 리워드
다단계 추천 리워드
추천 체인 검증
추천 정산 대상 계산

3. 기본 원칙

모든 RES 구현체는 다음 원칙을 준수하여야 한다.

SHALL 공식 리워드 계산 결과를 기준으로 추천 리워드를 계산한다.
SHALL 최초 등록된 추천인을 유지한다.
SHALL 추천 관계는 임의로 변경되어서는 안 된다.
SHALL 삭제 회원은 추천 계산 대상에서 제외한다.
SHALL 정지 회원은 정책에 따라 추천 계산 대상에 포함할 수 있다.
SHALL NOT 추천 리워드를 공식 회계 계산보다 먼저 계산한다.

4. 추천 관계

추천 관계(Referral Chain)는 회원 가입 시 최초로 확정된다.

추천인은 변경되지 않으며, 모든 추천 계산은 확정된 추천 관계를 기준으로 수행한다.

5. 계산 기준

추천 리워드는 다음 정보를 기반으로 계산한다.

공식 Reward Result
Referral Chain
적용 중인 Referral Policy
Calculation Timestamp

추천 리워드는 반드시 공식 리워드 계산 이후에 생성되어야 한다.

6. 회원 상태 처리

회원 상태는 다음 원칙을 따른다.

활성 회원: 계산 대상
정지 회원: 정책에 따라 계산 대상 포함 가능
삭제 회원: 계산 대상 제외

회원 상태 정책은 공식 계산 결과를 변경하지 않는다.

7. Accounting Engine과의 관계

추천 리워드는 Accounting Engine이 생성한 공식 리워드를 기반으로 계산된다.

Experience Engine은 추천 리워드를 표시할 수 있으나 계산 결과를 변경하여서는 안 된다.

8. 구현 요구사항

모든 RES 구현체는 다음 요구사항을 만족하여야 한다.

SHALL 추천 관계를 영구적으로 유지한다.
SHALL 공식 리워드 계산 이후 추천 리워드를 계산한다.
SHALL 삭제 회원을 계산 대상에서 제외한다.
SHALL 정지 회원 처리 정책을 일관되게 적용한다.
SHALL NOT 추천 관계를 사후 변경한다.

9. 요약

Referral Formula는 공식 리워드 계산 결과를 기반으로 추천 리워드를 생성하는 표준 규격이다.

모든 구현체는 확정된 추천 관계와 회원 상태 정책을 기준으로 일관된 추천 리워드를 계산하여야 한다.