Files
tetrig/server/README.md
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

62 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 스키마
## 개발
```bash
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
```
## 배포
```bash
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()` 참고.