Files
tkrmagid c864b65ef4 수익화: 광고 간격 저장·보상형 광고·Play 결제·시즌 패스·꾸미기·미디에이션·초대 링크·결과 공유
앱
- 전면 광고: 판 수를 기기에 저장해 앱을 다시 켜도 이어 센다. 규칙은 "마지막 전면 뒤 3판 이상 + 세션 첫 판 제외"
- 보상형 광고: 30분 전면 끄기, TIME ATTACK 이어하기(1판 1회, 기록·리더보드 미반영), 리소 스킨·흑연 보드 해금
- Play Billing 9.1: remove_ads / supporter_pack(비소모) / season_pass(소모). 승인 즉시, 시즌 패스는 서버 적용 뒤 소비, 실행 때마다 복원
- 상점 탭: 시즌 패스 트랙, 블록 스킨 7종·보드 테마 5종, 배지 장착, 상품, 구매 복원
- 광고 제거 구매 시 배너·결과·전면 끔 (보상형은 선택지로 유지)
- AdMob 미디에이션 어댑터: AppLovin, Pangle
- 커스텀 방 초대 링크 https://tetrig.pages.dev/r/CODE (앱 링크) + 공유, 결과 카드 PNG 공유
- 로비·리더보드·프로필에 배지 표시

서버
- 0002_shop 마이그레이션: season_xp, user_items, purchases, users.badge
- 시즌 패스 XP(솔로 10/커스텀 20+10/리그 25+15), 30레벨 무료·프리미엄 트랙
- /api/pass, /api/purchase(Google Play Developer API 검증, PLAY_SA_KEY), /api/badge
- 게스트 병합·계정 삭제 시 패스·아이템·구매 이전/삭제

웹
- /r/<코드> 초대 안내 페이지, scripts/build-pages.sh, 개인정보처리방침·스토어 문구 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 09:58:10 +09:00
..

TETRIG 서버 (Cloudflare Workers)

배포 주소: https://tetrig.tkrmagid.workers.dev

  • src/index.js — REST API + WebSocket 라우팅 + Cron
  • src/room-logic.js — 경기방 상태 기계 (리그 1:1 · 커스텀 N인 공용, 순수 로직)
  • src/room.js — GameRoomDO (WebSocket Hibernation, 상태는 DO storage 에 저장)
  • src/matchmaker.js / src/matchmaking.js — 리그 대기열 (R ± 2×RD, 30초마다 ×1.2 확장)
  • src/glicko.js — Glicko-2, src/rules.js — 튜닝 상수 전부
  • src/shop.js — 시즌 패스(XP·레벨·보상 트랙)·꾸미기 아이템·배지·Play 구매 적용, src/play.js — Google Play 영수증 확인
  • migrations/ — D1 스키마

개발

npm install
npm test                                   # 단위 테스트
printf 'TOKEN_SECRET=dev\n' > .dev.vars
npx wrangler d1 migrations apply tetrig --local
npx wrangler dev --local --port 8799
node scripts/e2e.mjs http://127.0.0.1:8799 # 종단 테스트 (게스트·FFA·계정·리그)

# 시즌 패스·결제·배지 (가짜 영수증은 로컬 + PLAY_VERIFY_FAKE=1 일 때만 통과)
npx wrangler dev --local --port 8799 --var PLAY_VERIFY_FAKE:1
node scripts/e2e-shop.mjs http://127.0.0.1:8799

배포

export CLOUDFLARE_API_TOKEN=... CLOUDFLARE_ACCOUNT_ID=...
npx wrangler d1 migrations apply tetrig --remote
npx wrangler deploy

비밀값 TOKEN_SECRET 은 wrangler secret put 으로만 넣는다 (재설정하면 기존 로그인 세션이 모두 끊김). Google 로그인은 wrangler.toml 의 GOOGLE_CLIENT_IDS 에 OAuth 클라이언트 ID 를 넣으면 켜진다.

Play 결제 확인은 PLAY_SA_KEY(서비스 계정 JSON 키 전체)를 wrangler secret put PLAY_SA_KEY 로 넣으면 켜진다. 서비스 계정은 Google Cloud 에서 만들고, Play Console > 사용자 및 권한에 초대해 "재무 데이터 보기 / 주문 관리" 권한을 준다. 없으면 /api/purchase 는 503, /api/pass 의 purchasable 은 false (앱이 시즌 패스 구매 버튼을 숨김).

API 요약

경로 설명
POST /api/guest 게스트 발급 (랜덤 닉) → {token, user}
POST /api/register 이메일 가입. 게스트 토큰을 같이 보내면 그 계정을 승격(기록 유지)
POST /api/login 이메일 로그인. 게스트 토큰을 같이 보내면 기록 병합
POST /api/google Google ID 토큰 로그인
GET /api/me 프로필·리그 요약·솔로 베스트·최근 전적
POST /api/nickname · GET /api/nickname/check?n= 닉 변경(30일 쿨다운) · 중복 검사
POST /api/solo 솔로 베스트 제출 {mode, value} (+시즌 패스 XP). {mode, xpOnly:true} 는 기록 없이 XP 만
GET /api/pass 시즌 패스: 시즌·XP·레벨·프리미엄 여부·보상 트랙
POST /api/purchase Play 구매 적용 {productId, purchaseToken} → {ok, consume, items}
POST /api/badge 배지 장착 {badge} (null 이면 해제, 가진 배지만)
GET /api/leaderboard?board=league|sprint|time|endless 상위 100 (계정만)
POST /api/rooms · GET /api/rooms/:code 커스텀 방 생성 · 조회
WS /ws/room/:code · WS /ws/league/:id · WS /ws/queue 경기방 · 리그 경기 · 리그 대기열 (?token=)

WebSocket 메시지 형식은 명세서 §14.3 + src/room-logic.js 의 handle() 참고.