Airflux Revenue Simulator

Airflux 도입 시 예상 수익을 시뮬레이션하는 도구입니다. 유사 게임의 실제 Airflux 성과 데이터를 기반으로 코호트 모델링을 통해 현실적인 예측을 제공합니다.

📋 목차

• 프로젝트 구조
• 설치 및 설정
• 사용법
• 주요 기능
• 문서

📁 프로젝트 구조

airflux-revenue-simulator/
├── src/airflux_simulator/     # 핵심 시뮬레이션 엔진
│   ├── improved_pattern_based_simulator.py  # 메인 시뮬레이터
│   ├── cohort_based_revenue_simulator.py    # 코호트 기반 Revenue 계산
│   ├── composite_similarity.py              # 유사 게임 매칭
│   ├── data_driven_retention_model.py       # 리텐션 변화 모델
│   └── ...
├── scripts/phase3/             # 서빙 스크립트
│   └── generate_sales_ready_report.py  # 메인 엔트리 포인트
├── notebooks/                  # 분석 노트북
│   ├── phase1/                # Phase 1: 간단한 시뮬레이션
│   ├── phase2/                # Phase 2: 딥한 분석
│   └── phase3/                # Phase 3: YAML 기반 시뮬레이션
├── models/                     # SQL 모델
│   ├── game_retention_snapshot.sql
│   ├── CUPID_snapshot.sql
│   └── ...
├── archive/                    # 아카이브 (구버전 코드 및 문서)
└── requirements.txt           # Python 의존성

🔧 설치 및 설정

1. 의존성 설치

pip install -r requirements.txt

2. Snowflake 설정

.snowflake_config.yaml.example 파일을 복사하여 .snowflake_config.yaml로 이름을 변경하고 실제 연결 정보를 입력하세요:

cp .snowflake_config.yaml.example .snowflake_config.yaml

.snowflake_config.yaml 파일 편집:

snowflake:
  account: "your_account"
  user: "your_username"
  password: "your_password"
  warehouse: "COMPUTE_WH"
  database: "AIRFLUX"
  schema: "DBT"
  role: "" # 선택사항

🚀 사용법

고객사 보고서 생성

메인 엔트리 포인트는 scripts/phase3/generate_sales_ready_report.py입니다.

python scripts/phase3/generate_sales_ready_report.py \
    --config data/input/customer_config.yaml \
    --output output/report.html

YAML 설정 파일 예시

고객사 입력값은 YAML 파일로 제공됩니다:

game_name: "새로운 게임"
target_countries:
  - country: "KR"
    dau: 10000
    ecpm: 5.0
    iaa_ratio: 0.7
  - country: "US"
    dau: 5000
    ecpm: 8.0
    iaa_ratio: 0.6
simulation_days: 90

✨ 주요 기능

1. 유사 게임 기반 패턴 추출

• 다중 기준 유사도 분석 (국가, eCPM, IAA/IAP 비율, DAU, ARPU)
• Soft Similarity를 통한 경계 근처 게임도 고려
• Robust Statistics (중앙값 기반)로 이상치에 강건한 패턴 추출

2. 코호트 기반 Revenue 시뮬레이션

• 실제 Airflux 도입 게임들의 성과 데이터 활용
• 일일 코호트별 Revenue 계산
• 리텐션 변화 모델 반영

3. 변동성 보정

• 일일 변동성 모델 적용
• 클러스터별 효과 조정
• 국가별 eCPM 조정

4. 고객사 친화적 보고서

• HTML/PDF 형식 지원
• 한국어/영어 지원
• CSV 내보내기 포함

📚 문서

핵심 문서

• archive/worktree_consolidation/core_docs/simulation_methodology_final_ko.md - 시뮬레이션 방법론 (최종안)
• archive/worktree_consolidation/core_docs/sales_technical_background_ko.md - Sales용 기술 백그라운드
• archive/worktree_consolidation/core_docs/retention_calculation_summary.md - 리텐션 계산 기준 요약

작업 히스토리

• archive/worktree_consolidation/work_history/03_handover_guide.md - 작업 승계 가이드
• archive/worktree_consolidation/work_history/00_worktree_work_summary.md - 작업 요약

⚠️ 주의사항

• 시뮬레이션은 참고용 예측이며, 실제 성과는 게임 특성, 시장 상황 등에 따라 다를 수 있습니다.
• Snowflake 연결 정보는 절대 Git에 커밋하지 마세요 (.gitignore에 포함됨).

📝 라이선스

이 프로젝트는 내부 사용을 위한 것입니다.