Reward Engine Foundation v4

06. 데이터 모델 (Data Model)

문서 ID: RES-FND-06
문서명: Data Model
볼륨: Volume 1 --- Reward Engine Foundation v4
버전: 4.0
상태: Official Standard
공개 등급: Public Specification

1. 목적

본 문서는 Reward Engine Standard(RES)의 표준 데이터 모델 원칙을 정의한다.

본 문서는 구현 기술이나 데이터베이스 제품을 지정하지 않으며, 모든 RES 구현체가 공통으로 유지해야 하는 데이터의 의미와 관계를 규정한다.

2. 기본 원칙

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

SHALL 계산 재현에 필요한 데이터를 보존하여야 한다.
SHALL 데이터의 의미를 일관되게 유지하여야 한다.
SHALL 과거 계산에 사용된 기준 데이터를 변경하지 않아야 한다.
SHALL NOT 사용자 표시 데이터를 공식 계산 데이터로 사용하여서는 안 된다.
SHALL 데이터 변경 이력을 추적할 수 있어야 한다.

3. 핵심 엔터티

RES는 최소한 다음 개념을 포함한다.

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

각 엔터티는 고유한 책임과 의미를 가진다.

4. 데이터 관계

Advertisement Revenue
        │
        ▼
Ad Impression Country
        │
        ▼
Standard eCPM
        │
        ▼
Accounting Result
        │
        ▼
Reward Result
        │
        ▼
Experience Engine
        │
        ▼
Point
        │
        ▼
Settlement

5. 필수 데이터 요소

공식 계산을 위해 최소한 다음 정보가 유지되어야 한다.

광고 수익
광고 노출 국가
적용된 Standard eCPM
계산 시점
계산 결과
적용된 규칙 버전

위 정보는 계산 재현과 감사를 위해 보존되어야 한다.

6. 데이터 불변성

공식 계산이 완료된 후에는 계산의 근거가 되는 데이터가 변경되어서는 안 된다(SHALL NOT).

정책 변경이나 UI 변경은 과거 계산 데이터에 영향을 주어서는 안 된다.

7. 이력 관리

RES 구현체는 다음 이력을 관리하여야 한다.

Standard eCPM 변경 이력
계산 규칙 버전
계산 결과
정산 처리 결과

이력 데이터는 과거 계산을 검증할 수 있도록 보존되어야 한다.

8. 구현 요구사항

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

SHALL 공식 계산 데이터를 보존한다.
SHALL 계산 근거를 추적할 수 있다.
SHALL 과거 계산을 재현할 수 있다.
SHALL 변경 이력을 유지한다.
SHALL NOT Point를 Source of Truth로 사용한다.

9. 요약

Data Model은 RES 구현체가 공통으로 유지해야 하는 데이터 구조와 관계를 정의한다.

모든 구현은 데이터의 무결성, 이력 보존 및 계산 재현성을 보장하도록 설계되어야 한다.