EJClaw 9f16bf833a 라이어 게임 입력 중: 설명 차례인 사람이 토론 채팅을 쳐도 "입력 중"이 보이게
- BotActivity hide → hideBots: 컴퓨터 활동에만 적용(사람의 입력 중은 언제나 채팅 칸에서 오므로 숨기지 않음)
- BotActivity.test.tsx: 설명 차례인 사람의 채팅 입력은 보이고, 설명 차례인 컴퓨터의 입력은 숨겨지고, 상태 줄에는 생각 중만
- e2e: 설명 첫 차례에 말하는 사람이 토론 채팅을 치면 다른 사람 채팅 칸에 입력 중, 보낸 말은 설명으로 치지 않음
- apps/web tsconfig: *.test.tsx도 타입 검사에서 제외(.test.ts와 같게)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 01:33:56 +09:00

같이 놀자 보드게임

광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트. 계획서는 docs/에 있고, 구현은 계획서를 따른다.

운영 중: https://game.tkrmagid.kr

게임 (40개)

종류 게임
2인 수 싸움 오목, 커넥트 포(사목), 오셀로, 체스(체스960 포함), 장기, 바둑, 쿼리도(2·4명)
카드·화투 원카드, 우노, 도둑잡기, 섯다, 포커, 블랙잭, 고스톱, 달무티, 티츄, 젝스님트, 구십구, 바퀴벌레 포커, 뱅!
타일·주사위·판 루미큐브, 다빈치 코드, 마작, 요트 다이스, 윷놀이(지역 룰 선택), 라스베가스, 부루마불, 스플렌더, 야단법석 달리기, 클루, 젬블로, 버건디의 성
순발력·대화·파티 할리갈리, 도블, 그림 맞히기, 사과 게임, 마피아, 라이어 게임, 핫스트릭, 사건 파일(협력 추리)

칩·포인트·지폐, 섯다의 "원"은 모두 놀이용이다(실제 돈과 무관, 충전·환전 없음).

주요 기능

  • 로그인: 디스코드 또는 게스트(닉네임만). 게스트는 로그아웃하거나 하루 동안 접속하지 않으면 계정이 지워진다.
  • 방: 방 링크를 보내면 친구가 바로 들어온다. 방 막대에서 링크 복사·채팅·규칙·설정(글자 크기·소리)·나가기를 한 번에 누른다. 게임 중에 나가면 기권으로 처리된다.
  • 모든 게임에 효과음과 움직임(상대·컴퓨터의 수에도 나옴), 오른쪽 위 소리 크기(0~100, 기본 50). 시간 제한이 있는 게임은 모두 "무제한"도 고를 수 있다.
  • 컴퓨터 상대: 실시간·그림 게임(할리갈리, 도블, 그림 맞히기)과 협력 추리(사건 파일)를 뺀 36개 게임. 마피아·라이어 게임의 컴퓨터는 채팅으로 말하고, 다른 게임의 컴퓨터 잡담은 방장이 켤 때만.
  • 처음 하는 사람을 위한 30초 규칙 요약, 게임별 규칙 페이지, 끝난 판 다시 보기, 이름을 누르면 나오는 기록 카드.
  • 홈 화면에 추가(PWA), 휴대폰(320px부터)·PC, 다크 모드.
  • 관리자 화면(/admin): 게임 규칙 기본값·잠금, 게임 속도 배율(애니메이션·컴퓨터 생각 시간, 1/16~16배), 사용자·방 관리, 계정별 기록.

개발

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                      # 바뀐 부분 테스트만 (origin/main 이후 + 커밋 안 한 변경, 없으면 마지막 커밋 기준)
                                  #   예: 체스만 고쳤으면 체스 테스트만, 문서만 고쳤으면 없음. -- --dry-run 으로 고른 것만 보기
bun run test:all                  # 전체 테스트 (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 e2e/bots.e2e.ts               # 컴퓨터 상대, 방 나가기, 게스트 로그아웃
bun e2e/replay.e2e.ts             # 다시 보기
bun e2e/tutorial.e2e.ts           # 처음 하는 사람용 규칙 요약
bun e2e/speed.e2e.ts              # 게임 속도 배율: 판 애니메이션 재생 속도와 컴퓨터 응답 시간
bun e2e/settings.e2e.ts           # 설정 팝업: 게임 중에 열어도 방에서 나가지 않음, 바로 적용, 닫기·포커스
bun e2e/room-back.e2e.ts          # 혼자인 대기실에서 뒤로가기 → 빈 방 바로 닫힘, 친구가 있으면 자리 유지, 규칙 팝업
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로 앱만 띄운다. 운영 서버 업데이트는 main에 푸시한 뒤 서버에서:

git pull && cd deploy && docker compose -f docker-compose.proxy.yml up -d --build
curl -fsS http://localhost:2970/healthz

자세한 절차는 docs/11-deployment-ops.md.

관리자

/admin. 슈퍼어드민은 서버의 deploy/.env에 있는 환경 변수 SUPERADMIN_DISCORD_IDS의 디스코드 ID(저장소에는 넣지 않음), 어드민은 관리자 화면에서 디스코드 ID로 추가한다. 자세한 내용은 docs/14-admin.md.

구조

  • packages/engine — 게임 공통 타입, 시드 난수, 테스트 도구
  • packages/shared — 프로토콜, 닉네임·방 코드 규칙, 게임 목록 (/lite는 브라우저용)
  • packages/games/<id> — 게임 규칙(순수 함수)
  • apps/server — Bun 서버(HTTP API, WebSocket, 방 관리, SQLite)
  • apps/web — React 웹
Description
No description provided
Readme 17 MiB
Languages
TypeScript 99.5%
CSS 0.4%