Reward Simulator Specification v1
03. 계산 엔진 (Calculation Engine)
문서 ID: RES-SIM-03
문서명: Calculation Engine
볼륨: Volume 3 --- Reward Simulator Specification v1
버전: 1.0
상태: Official Standard
공개 등급: Public Specification
1. 목적
본 문서는 Reward Simulator의 Calculation Engine에 대한 표준 규격을 정의한다.
Calculation Engine은 RES Foundation 및 Reward Formula Specification에서 정의된 규칙을 참조하여 공식 계산을 수행하는 핵심 구성 요소이다.
2. 역할
Calculation Engine의 주요 역할은 다음과 같다.
- 입력 데이터 검증 완료 확인
- Foundation 규칙 적용
- Formula Specification 적용
- 공식 계산 수행
- Accounting Result 생성
- Reward Result 생성
- Validation Engine으로 결과 전달
Calculation Engine은 새로운 계산 규칙을 정의하지 않는다.
3. 기본 원칙
모든 Simulator 구현체는 다음 원칙을 준수하여야 한다.
- SHALL Foundation을 기준으로 계산한다.
- SHALL Formula Specification을 그대로 적용한다.
- SHALL Source of Truth를 기준으로 계산한다.
- SHALL 동일한 입력에 대해 동일한 결과를 생성한다.
- SHALL NOT 구현체 고유의 계산 규칙을 추가한다.
4. 계산 절차
Calculation Engine은 다음 순서로 계산을 수행한다.
- 입력 검증 완료 확인
- Advertisement Revenue 확인
- Ad Impression Country 확인
- Standard eCPM 적용
- Accounting Result 생성
- Reward Result 생성
- Point Conversion 수행
- 결과 저장 및 Validation Engine 전달
계산 순서는 변경되어서는 안 된다.
5. 오류 처리
다음 조건에서는 공식 계산을 중단하여야 한다.
- 필수 입력 누락
- 유효하지 않은 국가 코드
- 유효하지 않은 Standard eCPM
- 지원되지 않는 정책 버전
- Source of Truth 생성 실패
오류가 발생한 계산은 공식 결과로 인정되어서는 안 된다.
6. 출력
Calculation Engine은 최소한 다음 결과를 생성하여야 한다.
- Accounting Result
- Reward Result
- Point Result
- Calculation Log
- Execution Status
7. 구현 요구사항
모든 Simulator 구현체는 다음 요구사항을 만족하여야 한다.
- SHALL 공식 계산 절차를 동일하게 구현한다.
- SHALL 계산 로그를 기록한다.
- SHALL 결과를 Validation Engine에 전달한다.
- SHALL 계산 결과를 재현할 수 있다.
- SHALL NOT 계산 순서를 변경한다.
8. 요약
Calculation Engine은 Reward Simulator의 핵심 계산 구성 요소이다.
모든 Simulator 구현체는 Foundation과 Formula Specification을 동일하게 구현하여 공식 계산 결과를 생성하고, Validation Engine이 이를 검증할 수 있도록 제공하여야 한다.