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. 검증 절차

공식 검증은 다음 순서를 따른다.

  1. 입력 데이터 확인
  2. 적용 규칙 확인
  3. Standard eCPM 확인
  4. 공식 계산 수행
  5. 결과 비교
  6. 검증 결과 기록

6. 검증 기준

공식 계산 결과는 다음 조건을 만족하여야 한다.

  • 동일 입력 → 동일 결과
  • 동일 계산 순서
  • 동일 절삭 및 반올림 규칙
  • 동일 정책 버전
  • 동일 Source of Truth

7. 검증 실패

다음 경우 검증 실패로 간주한다.

  • 계산 결과 불일치
  • 잘못된 Standard eCPM 적용
  • 계산 순서 위반
  • 공식 규칙 미준수
  • 필수 데이터 누락

검증 실패 결과는 공식 계산 결과로 인정되어서는 안 된다.


8. 구현 요구사항

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

  • SHALL 공식 계산을 검증할 수 있다.
  • SHALL 검증 이력을 보존한다.
  • SHALL Simulator와 동일한 결과를 생성한다.
  • SHALL 과거 계산을 재검증할 수 있다.
  • SHALL NOT 검증 없이 공식 결과를 확정한다.

9. 요약

Validation Rules는 RES 구현체의 계산 정확성과 일관성을 검증하기 위한 공식 규격이다.

모든 구현체와 Reward Simulator는 본 문서의 규칙을 기준으로 동일한 계산 결과를 생성하고 검증하여야 한다.