설계 결정 (Design Decisions)

문서 ID: RES-EG-08
문서명: 설계 결정 (Design Decisions)
볼륨: Executive Guide
버전: 1.0
상태: Official Standard
공개 등급: Public Specification


1. 목적

본 문서는 Reward Engine Standard(RES)의 핵심 설계 결정(Design Decisions)을 공식적으로 기록한다.

이 문서에 포함된 내용은 새로운 설계 제안이 아니라, RES 설계 과정에서 확정된 사항을 표준 문서의 형태로 정리한 것이다.


2. 설계 결정의 원칙

모든 설계 결정은 다음 기준을 따른다.

  • 재무 무결성을 우선한다.
  • 동일한 입력은 동일한 결과를 생성해야 한다.
  • 계산 규칙과 운영 정책은 분리한다.
  • 장기적인 글로벌 확장성을 고려한다.
  • 사용자 경험보다 회계 정확성을 우선한다.

3. 공식 설계 결정

DD-001. Source of Truth

Reward Engine의 Source of Truth는 광고 수익(USD)이다.

사용자에게 표시되는 포인트(Point)는 회계 기준을 표현하는 사용자 경험 요소이며, 회계의 기준이 되어서는 안 된다.


DD-002. 이중 계층 구조

RES는 다음 두 개의 개념적 계층으로 구성된다.

  • Accounting Engine
  • Experience Engine

Accounting Engine은 재무적 정확성을 담당하며, Experience Engine은 사용자 경험을 담당한다.


DD-003. 광고 노출 국가 기준

리워드는 회원의 국적이나 거주 국가가 아니라 광고가 실제 노출된 국가(Ad Impression Country)를 기준으로 계산한다.


DD-004. Standard eCPM 적용

리워드 계산에는 운영자가 승인한 최신 Standard eCPM을 적용한다.

Standard eCPM은 국가별로 관리되며 변경 이력은 보존되어야 한다.


DD-005. 계산 규칙과 운영 정책의 분리

운영 정책은 변경될 수 있으나 계산 원칙은 변경되어서는 안 된다.

계산 로직은 RES 표준에 의해 관리되며, 운영 정책은 그 범위 안에서 적용된다.


DD-006. 계산의 재현성

동일한 입력 데이터와 동일한 기준값이 주어질 경우 계산 결과는 항상 동일해야 한다.

과거의 계산은 언제든지 재현 가능해야 한다.


DD-007. 글로벌 표준

RES는 특정 서비스를 위한 규격이 아니라 다양한 리워드 플랫폼에서 공통으로 사용할 수 있는 표준을 목표로 한다.

Reward Train, Pinoy Perks 및 향후 RES를 채택하는 모든 플랫폼은 동일한 핵심 원칙을 공유한다.


4. 변경 정책

본 문서의 설계 결정은 표준 개정 없이 변경되어서는 안 된다.

새로운 아이디어나 개선 사항은 Future Considerations에서 관리하며 기존 설계에는 영향을 주지 않는다.


5. 요약

본 문서는 Reward Engine Standard의 핵심 설계 결정을 공식적으로 기록한다.

이러한 설계 결정은 Foundation, Formula, Simulator 및 Administration 문서의 기준이 되며, 모든 RES 구현은 본 문서의 원칙을 준수해야 한다.


관련 문서

  • RES-EG-04 핵심 철학
  • RES-EG-05 핵심 아키텍처
  • RES-EG-07 거버넌스
  • Reward Engine Foundation v4