f5671cda70
- 게이트웨이가 사용자별 '마지막 소켓이 닫힌 시각'을 기록(offlineSince). 소켓이 하나라도 열려 있으면 사이트에 있는 것 - sweep: 대기실이 아닌 방에서 자리에 앉은 사람(컴퓨터·게임 중 나간 사람 제외)이 모두 사이트를 떠난 지 1분이면 게임을 무효로 끝내고 방을 닫는다. 관전자가 접속해 있어도 닫고 내보낸다. 대기실은 초대 입장 때문에 기존 규칙 유지 - 홈 등 다른 화면에서 새로 연 창도 자리가 있으면(/api/me activeRoom) 소켓을 연결해 '사이트 열림'으로 남게 - Room.closeByAdmin을 closeWith(summary, notice)로 일반화 - e2e(bots): 오목은 컴퓨터가 3번만 받게(이후 단계 전에 게임이 끝나지 않게), 홈 단계를 원카드 앞으로(턴 시간 초과 방지) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
같이 놀자 보드게임
광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트. 계획서는 docs/에 있고, 구현은 계획서를 따른다.
개발
bun install
bun run --filter '@bg/server' dev # 서버 :3000
bun run --filter '@bg/web' dev # 웹 :5173 (API/WS는 :3000으로 프록시)
브라우저에서 http://localhost:5173 을 연다. 디스코드 값이 없으면 게스트 로그인만 보인다.
확인
bun run typecheck
bun run test # 규칙·서버 통합·방 단위 테스트 (4개 병렬, 무작위 대국은 시드 1/10만, 1분 안쪽)
bun run test:full # 배포 전 전체: 무작위 대국 시드 전부(1,000개 등), 순차 실행이라 10분쯤
(cd apps/web && bunx vite build) # 웹 빌드
bun e2e/omok.e2e.ts # 브라우저 두 개로 오목 한 판 (Chrome 필요)
bun e2e/admin.e2e.ts # 관리자: 슈퍼어드민 로그인 → 규칙 변경·잠금 → 새 방 반영
bun e2e/games.e2e.ts [게임id...] # 게임별: 방 만들기 → 친구 입장 → 실제 화면 조작으로 여러 턴(일부는 끝까지)
bun e2e/a11y.e2e.ts # 접근성(axe) 검사
bun e2e/pwa.e2e.ts # PWA: 매니페스트·아이콘, 서비스 워커, 오프라인 안내, 홈 화면에 추가
bun scripts/loadtest.ts --help # 부하·장애 주입 (docs/reports 참고)
배포
deploy/.env.example을 deploy/.env로 복사해 값을 채운 뒤:
cd deploy && docker compose up -d --build
이미 HTTPS 리버스 프록시가 있는 서버(지금 운영 중인 .5 + NPMplus)에서는 docker compose -f docker-compose.proxy.yml up -d --build로 앱만 띄운다.
자세한 절차는 docs/11-deployment-ops.md.
관리자
/admin. 슈퍼어드민은 디스코드 ID 293719842274541579, 1352267557213573160(환경 변수 SUPERADMIN_DISCORD_IDS), 어드민은 관리자 화면에서 디스코드 ID로 추가한다. 자세한 내용은 docs/14-admin.md.
구조
packages/engine— 게임 공통 타입, 시드 난수, 테스트 도구packages/shared— 프로토콜, 닉네임·방 코드 규칙, 게임 목록 (/lite는 브라우저용)packages/games/<id>— 게임 규칙(순수 함수)apps/server— Bun 서버(HTTP API, WebSocket, 방 관리, SQLite)apps/web— React 웹