Reward Engine Foundation v4
03. Source of Truth
문서 ID: RES-FND-03
문서명: Source of Truth
볼륨: Volume 1 --- Reward Engine Foundation v4
버전: 4.0
상태: Official Standard
공개 등급: Public Specification
1. 목적
본 문서는 Reward Engine Standard(RES)의 Source of Truth를 공식적으로 정의한다.
Source of Truth는 모든 공식 리워드 계산의 유일한 기준이며, 모든 RES 구현체는 본 문서에서 정의하는 규칙을 준수하여야 한다.
2. 공식 정의
Source of Truth는 공식 계산에 사용되는 유일한 재무 기준(Financial Authority) 이다.
RES에서 Source of Truth는 Accounting Engine이 생성한 재무 기준 계산 결과를 의미한다.
사용자 인터페이스, Point, 이벤트 화면 또는 운영 화면의 표시 값은 Source of Truth가 아니다.
3. 기본 원칙
모든 RES 구현체는 다음 원칙을 준수하여야 한다.
- SHALL 하나의 Source of Truth만 유지하여야 한다.
- SHALL 모든 공식 계산은 Source of Truth를 기준으로 수행하여야 한다.
- SHALL 동일한 입력은 동일한 Source of Truth를 생성하여야 한다.
- SHALL NOT 사용자 표시 값이 공식 계산 기준이 되어서는 안 된다.
- SHALL NOT Experience Engine이 Source of Truth를 변경해서는 안 된다.
4. Source of Truth의 구성
Source of Truth는 최소한 다음 요소를 포함하여야 한다.
- Advertisement Revenue
- Ad Impression Country
- 적용된 Standard eCPM
- Accounting Engine 계산 결과
- 계산 시점에 유효한 기준값
각 요소는 계산 재현성을 보장할 수 있도록 관리되어야 한다.
5. Source of Truth가 아닌 데이터
다음 데이터는 Source of Truth가 아니다.
- Point
- 화면 표시 값
- 이벤트 배율
- UI 계산 결과
- 임시 캐시 데이터
이러한 데이터는 사용자 경험을 위한 표현이며 공식 회계 기준으로 사용되어서는 안 된다.
6. 재현성
동일한 입력 데이터와 동일한 Standard eCPM이 주어질 경우 Source of Truth는 항상 동일한 결과를 생성하여야 한다.
과거 계산은 언제든지 동일한 결과로 재현 가능하여야 한다.
7. 감사 가능성
Source of Truth는 모든 공식 계산의 근거가 되므로 추적 및 검증이 가능하여야 한다.
모든 계산은 사용된 기준값을 확인할 수 있어야 하며, 과거 계산 이력을 변경해서는 안 된다.
8. 구현 요구사항
모든 RES 구현체는 다음 요구사항을 만족하여야 한다.
- SHALL Source of Truth를 공식 계산 기준으로 사용한다.
- SHALL 계산 결과를 재현할 수 있다.
- SHALL 과거 계산을 검증할 수 있다.
- SHALL Standard eCPM 변경 이력을 유지한다.
- SHALL NOT Point를 회계 기준으로 사용한다.
- SHALL NOT Experience Engine이 Source of Truth를 수정한다.
9. 요약
Source of Truth는 RES의 재무 무결성과 계산 재현성을 보장하는 핵심 기준이다.
모든 RES 구현은 Source of Truth를 중심으로 설계되어야 하며, 이후 Formula, Simulator 및 Administration 문서는 본 문서의 원칙을 기반으로 구현되어야 한다.