# 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()` 참고.