Files
tetrig/server
tkrmagid c05c39ff36 앱: 멀티플레이·계정·리더보드·광고 연결 (Phase 4~7 클라이언트)
- 게스트 자동 발급, 이메일 가입/로그인(게스트 기록 이전), 닉네임 변경, 계정 삭제
- 커스텀 방 만들기/참가, 로비(호스트 규칙), 1:1·FFA 대전, 가비지 게이지·상쇄·삽입,
  상대 미니보드 탭 타겟팅, KO 피드, 관전, 리매치 투표, 재접속
- 리그 대기열·매칭·FT3/FT5·결과(TR/배치), 리더보드 4종, 프로필 전적
- AdMob(UMP 동의) 배너·결과 카드·전면(3판당 1회, 첫 판 제외), 기본은 테스트 ID
- 서버: 앱 레벨 keepalive(auto-response), KO 후 로비 갱신, 재접속 시 결과 재전송,
  x-info 헤더 ASCII 인코딩, 계정 삭제 API
- 개인정보처리방침·스토어 등록정보 갱신 (온라인·광고 반영)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 10:43:32 +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 — 튜닝 상수 전부
  • 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·계정·리그)

배포

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 를 넣으면 켜진다.

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