ad7af30daa
- packages/games/src/marble: 판 데이터(board.ts, 40칸·가격표·행운카드 20장), 상태 기계(rules.ts), 게임 정의(index.ts). 더블·3더블 무인도, 무인도/탈출권/탈출비, 우주여행·탑승료, 사회복지기금, 통행료(관광지 2곳 이상 2배·면제권), 빚 갚기·파산(채권자에게 매각 대금), 인수·랜드마크·독점 승리·교환 옵션, 라운드 제한과 총자산 순위(동점이면 포인트 비교). 카드 더미 순서는 비공개(남은 장 수만), 시스템 전용 TIMEOUT(굴리기/안 사기/싼 것부터 매각/거절), onLeave = 기권. - 테스트 80개: 문서 §10 체크리스트 전 항목, 1,000판 시드 무작위 대국(포인트 장부·소유 일관성· onTimeout 합법), 엔진 randomPlayout·리플레이 결정성, 시간 초과만으로도 끝나는지. - 화면: SVG 정사각형 판(도시 이름·소유 색·건물 표시·말), 가운데 주사위·결정 프롬프트, 행운카드 공개, 우주여행 칸 고르기와 미리 보기, 빚 갚기 막대·매각 목록, 교환 시트, 진행 기록, PC·휴대폰·다크 모드. 화폐 대신 놀이용 포인트(P) 표기, no-money-wording 검사 대상에 추가. - 등록: GAMES, CATALOG(주사위 땅따먹기), 웹 registry, GAME_ICON, @bg/games/marble/board export. - E2E marble 계획: PC 방장 + 휴대폰 손님, 15라운드·200P로 결과 화면까지 실제 진행. 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 # 규칙·서버 통합·방 단위 테스트 (무작위 대국이 길어 제한 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 웹