Reward Engine Foundation v4

07. 계산 원칙 (Calculation Principles)

문서 ID: RES-FND-07
문서명: Calculation Principles
볼륨: Volume 1 --- Reward Engine Foundation v4
버전: 4.0
상태: Official Standard
공개 등급: Public Specification

1. 목적

본 문서는 Reward Engine Standard(RES)의 모든 계산이 따라야 하는 공통 계산 원칙을 정의한다.

본 문서에서 정의하는 원칙은 개별 계산식보다 상위의 규범이며, 모든 RES 구현체는 본 문서를 준수하여야 한다.

2. 적용 범위

본 문서는 다음 계산에 적용된다.

공식 리워드 계산
국가별 계산
Point 산출
추천 보상 계산
정산 대상 계산
시뮬레이션 계산

3. 기본 원칙

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

SHALL 동일한 입력에 대해 항상 동일한 결과를 생성하여야 한다.
SHALL 계산 순서를 변경하여서는 안 된다.
SHALL 모든 계산은 Source of Truth를 기준으로 수행하여야 한다.
SHALL 계산 과정은 추적 가능하여야 한다.
SHALL NOT 사용자 인터페이스의 표시값을 계산 입력으로 사용하여서는 안 된다.

4. 결정성(Determinism)

모든 계산은 결정적(Deterministic)이어야 한다.

동일한 입력 데이터와 동일한 기준값이 제공될 경우 계산 결과는 항상 동일하여야 한다.

난수(Random), 사용자 환경, 화면 표시 방식 또는 실행 순서에 따라 계산 결과가 달라져서는 안 된다.

5. 계산 순서

모든 공식 계산은 다음 순서를 따른다.

Advertisement Revenue 확인
Ad Impression Country 결정
Standard eCPM 적용
Accounting Engine 계산
공식 Reward Result 생성
Experience Engine을 통한 Point 표현

구현체는 이 순서를 변경하여서는 안 된다(SHALL NOT).

6. 계산 시점

공식 계산은 광고 가치가 확정된 시점을 기준으로 수행되어야 한다.

계산 이후 정책이 변경되더라도 이미 확정된 계산 결과는 변경되어서는 안 된다.

7. 반올림 및 절삭

반올림(Rounding) 및 절삭(Truncation)의 구체적인 규칙은 Volume 2 --- Reward Formula Specification에서 정의한다.

모든 구현체는 해당 규격을 동일하게 적용하여야 한다(SHALL).

8. 오류 처리

계산에 필요한 필수 데이터가 존재하지 않는 경우 공식 계산은 완료되어서는 안 된다.

불완전한 입력으로 생성된 결과를 공식 계산 결과로 사용하여서는 안 된다(SHALL NOT).

9. 구현 요구사항

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

SHALL 결정적 계산을 수행한다.
SHALL 동일한 계산 순서를 유지한다.
SHALL 공식 계산 과정을 추적할 수 있다.
SHALL 과거 계산을 재현할 수 있다.
SHALL NOT 비공식 데이터를 계산 입력으로 사용한다.

10. 요약

Calculation Principles는 RES의 모든 계산이 공통적으로 따라야 하는 규범을 정의한다.

모든 계산식은 본 문서의 원칙을 기반으로 구현되어야 하며, 세부 계산식은 Volume 2 --- Reward Formula Specification에서 정의한다.