17b1d0fcda
- 웹(React+Vite): 홈(큰 버튼 2개·하던 게임 돌아가기), 6자리 코드 입력(붙여넣기 감지·자동 입장), 링크 입장(닉네임 한 칸), 대기실(코드/링크 복사·공유·QR·자리·준비·방장 메뉴·설정), 오목(SVG 판·두 번 눌러 확정·금수/위험 표시·시계·무르기·무승부·기권·키보드 조작·스크린리더 안내), 결과(한 판 더 투표·방 전적·공정성 확인), 채팅·반응, 계정(닉네임 변경·글자 크기·테마·소리·진동) - WS 클라이언트: 지수 백오프+지터 재연결, 화면 복귀/온라인 즉시 재연결, seq 순서 처리, ping/pong 지연·시계 보정, 서버 재시작 안내, 다른 창 접속 처리 - @bg/shared/lite: 브라우저용 진입점(zod 제외) → 첫 화면 JS 약 90KB gzip - e2e/omok.e2e.ts: 브라우저 두 개(모바일·PC)로 방 만들기→링크 입장→대국→새로고침 복구→승리→한 판 더 - deploy: Dockerfile(운영 의존성만, 267MB), docker-compose(app+Caddy), Caddyfile(보안 헤더·CSP), .env.example - 프록시 뒤에서만 X-Forwarded-For 신뢰(TRUST_PROXY=1) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# 같이 놀자 보드게임
|
|
|
|
광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 온라인 보드게임 사이트.
|
|
계획서는 [docs/](docs/README.md)에 있고, 구현은 계획서를 따른다.
|
|
|
|
## 개발
|
|
```bash
|
|
bun install
|
|
bun run --filter '@bg/server' dev # 서버 :3000
|
|
bun run --filter '@bg/web' dev # 웹 :5173 (API/WS는 :3000으로 프록시)
|
|
```
|
|
브라우저에서 http://localhost:5173 을 연다. 디스코드 값이 없으면 게스트 로그인만 보인다.
|
|
|
|
## 확인
|
|
```bash
|
|
bun run typecheck
|
|
bun test # 규칙·서버 통합·방 단위 테스트
|
|
(cd apps/web && bunx vite build) # 웹 빌드
|
|
bun e2e/omok.e2e.ts # 브라우저 두 개로 오목 한 판 (Chrome 필요)
|
|
```
|
|
|
|
## 배포
|
|
`deploy/.env.example`을 `deploy/.env`로 복사해 값을 채운 뒤:
|
|
```bash
|
|
cd deploy && docker compose up -d --build
|
|
```
|
|
자세한 절차는 [docs/11-deployment-ops.md](docs/11-deployment-ops.md).
|
|
|
|
## 구조
|
|
- `packages/engine` — 게임 공통 타입, 시드 난수, 테스트 도구
|
|
- `packages/shared` — 프로토콜, 닉네임·방 코드 규칙, 게임 목록 (`/lite`는 브라우저용)
|
|
- `packages/games/<id>` — 게임 규칙(순수 함수)
|
|
- `apps/server` — Bun 서버(HTTP API, WebSocket, 방 관리, SQLite)
|
|
- `apps/web` — React 웹
|