Files
tetrig/server/README.md
tkrmagid 8fcef8e720 서버: Cloudflare Workers 멀티플레이 백엔드 (Phase 4~6 서버 측)
- 게스트/이메일/Google 계정, 게스트 기록 이전, 닉네임 정책
- GameRoomDO: 커스텀 1:1·FFA, 가비지 중계·배율·장기전, 타겟팅, KO, 재접속 유예, 리매치 투표
- MatchmakerDO + Glicko-2 + TR/18랭크 + 리그 결과 기록
- 리더보드·솔로 기록·시즌/RD 감쇠 Cron
- 단위 테스트 17개 + 종단 테스트 스크립트

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 09:27:15 +09:00

50 lines
2.2 KiB
Markdown
Raw 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` — 튜닝 상수 전부
- `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·계정·리그)
```
## 배포
```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 를 넣으면 켜진다.
## 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()` 참고.