4c5c3e5707
- 규칙 모듈 packages/games/src/one-card: 원카드(트럼프 54장, 6명부터 2벌)와 색깔 카드(108장) 두 모드. 공격·받아치기·3 방어·7 무늬 지정·J/Q/K·조커 기준 카드·여러 장 내기·마지막 카드 제한, 원카드 선언/잡기, 파산, 드로우 더미 재구성, +4 의심하기(의심한 사람에게만 손패 공개), +2/+4 받아치기, 목표 점수 여러 판, 시간 초과(자동 먹기·넘기기·받아들이기, 3번 연속이면 5초), 나가기. 모든 옵션에 한국어 메타. - 테스트: 문서 10절 시나리오 45개 + 모드별 무작위 대국 1,000판(카드 수 보존, 종료, 결정성, 유출, onTimeout 합법) + 엔진 randomPlayout(매 단계 유출·직렬화 검사) 18판. - 화면 apps/web/src/games/one-card: 상대 좌석, 판(더미·바닥·방향·지정 무늬/색·공격 누적), 손패(정렬·힌트· 두 번 눌러 내기·끌어 놓기·방향키), 원카드 버튼, 무늬/색 고르기, 의심하기, 기록·특수 카드 표. 색깔 카드는 직접 그린 SVG(색맹용 무늬 패턴과 색 이름 포함). - 등록: GAMES, 카탈로그, 웹 레지스트리, 아이콘(곧 나와요 목록에서 제외), E2E 계획(PC 1 + 휴대폰 2). 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 test # 규칙·서버 통합·방 단위 테스트
(cd apps/web && bunx vite build) # 웹 빌드
bun e2e/omok.e2e.ts # 브라우저 두 개로 오목 한 판 (Chrome 필요)
bun e2e/admin.e2e.ts # 관리자: 슈퍼어드민 로그인 → 규칙 변경·잠금 → 새 방 반영
bun e2e/games.e2e.ts # 오셀로·체스·바둑·장기: 방 만들기 → 친구 입장 → 첫 수
bun e2e/a11y.e2e.ts # 접근성(axe) 검사
bun scripts/loadtest.ts --help # 부하·장애 주입 (docs/reports 참고)
배포
deploy/.env.example을 deploy/.env로 복사해 값을 채운 뒤:
cd deploy && docker compose up -d --build
자세한 절차는 docs/11-deployment-ops.md.
관리자
/admin. 슈퍼어드민은 디스코드 ID 293719842274541579(환경 변수 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 웹