EJClaw 11ad2be147 M7: 보석 상인 규칙·화면·테스트
- 규칙 모듈 packages/games/src/splendor: 카드 90장·귀족 10장 데이터 파일 분리(cards.ts),
  보석 가져오기(3색/같은 색 2개, allowFewerTokens), 예약(공개/더미, 황금), 구매(자동·수동 지불),
  10개 한도 반납, 귀족 방문·선택, 라운드 끝까지 진행 후 종료, 동점은 카드 적은 쪽,
  넘기기와 모두 넘기면 종료, 기권, 시간 초과 자동 행동(3번 연속이면 자리 비움),
  view는 더미·블라인드 예약·제외 귀족을 숨기고 살 수 있는 카드·지불 미리보기를 계산
- 테스트: 문서 10절 시나리오 42개 + 무작위 대국 1,000판(보존·정보 유출·onTimeout 합법·결정성)
  + 엔진 randomPlayout
- 화면 apps/web/src/games/splendor: 자체 카드·귀족·보석 그림(색+모양+글자), 3단계 시장과 더미,
  보석 은행, 내 보너스·보석·예약, 상대 요약, 살 수 있는 카드 강조, 반납·귀족 선택, PC/휴대폰·다크 모드
- 등록: GAMES, 카탈로그, 화면 레지스트리, 아이콘
- E2E: PC 방장 + 휴대폰 친구가 10점 판을 결과까지 진행

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 14:53:35 +09:00
2026-10-05 14:21:11 +09:00

같이 놀자 보드게임

광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트. 계획서는 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                      # 규칙·서버 통합·방 단위 테스트 (무작위 대국이 길어 제한 60초)
(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 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 웹
Description
No description provided
Readme 2.2 MiB
Languages
TypeScript 99.5%
CSS 0.4%