Reward Simulator Specification v1

04. 검증 엔진 (Validation Engine)

문서 ID: RES-SIM-04
문서명: Validation Engine
볼륨: Volume 3 --- Reward Simulator Specification v1
버전: 1.0
상태: Official Standard
공개 등급: Public Specification


1. 목적

본 문서는 Reward Simulator의 Validation Engine에 대한 표준 규격을 정의한다.

Validation Engine은 Calculation Engine이 생성한 결과가 Reward Engine Standard(RES)의 Foundation 및 Formula Specification을 준수하는지 검증하는 공식 구성 요소이다.


2. 역할

Validation Engine은 다음 역할을 수행한다.

  • 계산 결과 검증
  • 표준 규격 일치 여부 확인
  • 동일 입력·동일 결과 검증
  • 검증 결과 기록
  • 검증 보고서 생성

Validation Engine은 계산을 수행하지 않으며, 계산 결과를 평가한다.


3. 기본 원칙

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

  • SHALL Foundation을 기준으로 검증한다.
  • SHALL Formula Specification을 기준으로 검증한다.
  • SHALL 동일한 입력에 대해 동일한 결과를 검증한다.
  • SHALL 검증 결과를 추적 가능하게 기록한다.
  • SHALL NOT 독자적인 검증 기준을 추가한다.

4. 검증 절차

Validation Engine은 다음 절차를 따른다.

  1. 입력 데이터 확인
  2. Calculation Engine 결과 수신
  3. 공식 계산 규칙 적용 여부 확인
  4. 결과 비교
  5. 검증 상태 결정
  6. Validation Report 생성

5. 검증 항목

최소한 다음 항목을 검증하여야 한다.

  • Advertisement Revenue
  • Ad Impression Country
  • Standard eCPM
  • Accounting Result
  • Reward Result
  • Point Result
  • Settlement Result

6. 검증 결과

검증 결과는 다음 상태 중 하나를 가져야 한다.

  • PASS
  • FAIL
  • ERROR

FAIL 또는 ERROR는 공식 계산 결과 승인 이전에 해결되어야 한다.


7. Validation Report

Validation Report는 최소한 다음 정보를 포함하여야 한다.

  • 입력 데이터 요약
  • 계산 결과
  • 검증 결과
  • 실패 항목
  • 실행 시각

8. 구현 요구사항

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

  • SHALL 공식 검증 절차를 구현한다.
  • SHALL 검증 이력을 보존한다.
  • SHALL Validation Report를 생성한다.
  • SHALL 과거 결과를 재검증할 수 있다.
  • SHALL NOT 검증을 생략하고 결과를 승인한다.

9. 요약

Validation Engine은 Reward Simulator의 공식 검증 구성 요소이다.

모든 Simulator 구현체는 동일한 검증 절차와 기준을 적용하여 RES 규격 준수 여부를 일관되게 판단하여야 한다.