- 게스트/이메일/Google 계정, 게스트 기록 이전, 닉네임 정책 - GameRoomDO: 커스텀 1:1·FFA, 가비지 중계·배율·장기전, 타겟팅, KO, 재접속 유예, 리매치 투표 - MatchmakerDO + Glicko-2 + TR/18랭크 + 리그 결과 기록 - 리더보드·솔로 기록·시즌/RD 감쇠 Cron - 단위 테스트 17개 + 종단 테스트 스크립트 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# 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()` 참고.
|