Reward Formula Specification v3
08. 검증 규칙 (Validation Rules)
문서 ID: RES-FML-08
문서명: Validation Rules
볼륨: Volume 2 --- Reward Formula Specification v3
버전: 3.0
상태: Official Standard
공개 등급: Public Specification
1. 목적
본 문서는 Reward Engine Standard(RES)의 공식 계산 결과를 검증하기 위한 표준 검증 규칙을 정의한다.
Validation Rules는 모든 RES 구현체와 Reward Simulator가 동일한 계산 결과를 생성하는지 확인하기 위한 기준이다.
2. 적용 범위
본 문서는 다음 항목에 적용된다.
- 공식 리워드 계산 검증
- Point 변환 검증
- 추천 리워드 검증
- 그룹 리워드 검증
- 정산 검증
- Reward Simulator 검증
3. 기본 원칙
모든 RES 구현체는 다음 원칙을 준수하여야 한다.
- SHALL 동일한 입력에 대해 동일한 결과를 생성하여야 한다.
- SHALL Foundation과 Formula Specification을 동일하게 구현하여야 한다.
- SHALL 검증 가능한 계산 이력을 유지하여야 한다.
- SHALL NOT 구현체별로 다른 계산 결과를 생성하여서는 안 된다.
4. 검증 대상
다음 항목은 검증 대상에 포함된다.
- Advertisement Revenue
- Ad Impression Country
- Standard eCPM
- Accounting Result
- Reward Result
- Point Conversion
- Settlement Result
5. 검증 절차
공식 검증은 다음 순서를 따른다.
- 입력 데이터 확인
- 적용 규칙 확인
- Standard eCPM 확인
- 공식 계산 수행
- 결과 비교
- 검증 결과 기록
6. 검증 기준
공식 계산 결과는 다음 조건을 만족하여야 한다.
- 동일 입력 → 동일 결과
- 동일 계산 순서
- 동일 절삭 및 반올림 규칙
- 동일 정책 버전
- 동일 Source of Truth
7. 검증 실패
다음 경우 검증 실패로 간주한다.
- 계산 결과 불일치
- 잘못된 Standard eCPM 적용
- 계산 순서 위반
- 공식 규칙 미준수
- 필수 데이터 누락
검증 실패 결과는 공식 계산 결과로 인정되어서는 안 된다.
8. 구현 요구사항
모든 RES 구현체는 다음 요구사항을 만족하여야 한다.
- SHALL 공식 계산을 검증할 수 있다.
- SHALL 검증 이력을 보존한다.
- SHALL Simulator와 동일한 결과를 생성한다.
- SHALL 과거 계산을 재검증할 수 있다.
- SHALL NOT 검증 없이 공식 결과를 확정한다.
9. 요약
Validation Rules는 RES 구현체의 계산 정확성과 일관성을 검증하기 위한 공식 규격이다.
모든 구현체와 Reward Simulator는 본 문서의 규칙을 기준으로 동일한 계산 결과를 생성하고 검증하여야 한다.