게임 랭킹 시스템 아키텍처 설계

아키텍처 개요

• 메인 사이트: cosmo-verse.com (Cloudflare Pages)
• API 서버: api.cosmo-verse.com (Cloudflare Workers)
• 게임별 서브도메인: tetris., snake. 등 (Cloudflare Pages)

데이터베이스 설계 (Cloudflare D1)

핵심 테이블

• games - 게임 메타정보, 점수 범위 검증 설정
• rankings - 게임별 랭킹 기록 (인덱스: game_id+score DESC)
• request_idempotency - 중복 요청 방지 (5분 유효)

API 명세

주요 엔드포인트

• GET /rankings/{gameId} - 랭킹 조회 (페이지네이션, 기간 필터)
• POST /rankings - 점수 등록 (X-Request-ID 멱등성)
• GET /games - 게임 목록 (통계 포함)
• GET /players/{playerName}/rankings - 플레이어 기록

보안

• CORS 정책 적용
• Rate Limiting (POST 10req/min)
• Prepared Statement로 SQL Injection 방지

구현 계획 (8단계)

1. API 초기 설정
2. D1 데이터베이스 설정
3. Workers 개발
4. 배포
5. 메인/게임 연동
6. 모니터링
7. E2E 테스트
8. 프로덕션 릴리스

예상 기간: 2-3주