같이 놀자 보드게임

광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트. 계획서는 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 필요)

배포

deploy/.env.example을 deploy/.env로 복사해 값을 채운 뒤:

cd deploy && docker compose up -d --build

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

구조

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