- 웹(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>
온라인 보드게임 사이트 계획서
광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 한국형 온라인 보드게임 사이트. 구현은 이 문서들을 기준으로 하며, 결정이 바뀌면 문서를 먼저 고친다.
공통 문서
| 문서 | 내용 |
|---|---|
| 00-overview.md | 목표, 원칙(안정성·실시간·쉬움·가벼움), 범위, 성공 기준 |
| 01-research.md | BGA 분석, 한국 인기 보드게임 조사, UI/UX 조사, 출처 |
| 02-architecture.md | 기술 선택, 전체 구조, 저장소 구조, 처리 흐름 |
| 03-realtime-protocol.md | WebSocket 메시지, 순서 보장, 재접속, 타이머, 제한 |
| 04-stability-security.md | 저장·복구, 장애 격리, 숨김 정보·공정성, 사행성·상표, 웹 보안 |
| 05-accounts-auth.md | 게스트·디스코드 로그인, 닉네임, 세션, 계정 페이지 |
| 06-lobby-rooms.md | 방 만들기/참여, 코드·링크·QR·공유, 대기실, 빠른 시작, 한 판 더 |
| 07-ui-ux.md | 디자인 원칙, 색·글자 토큰, 화면 틀, 컴포넌트, 접근성, 성능 예산 |
| 08-data-model.md | SQLite 스키마, 쓰기 시점, 정리, 개인정보 |
| 09-game-engine.md | 게임 모듈 인터페이스, 결정적 난수, GameRunner, 공통 유틸, 공통 테스트 |
| 10-testing.md | 테스트 종류, 핵심 시나리오, 부하 기준, 수동 점검표 |
| 11-deployment-ops.md | Docker/Caddy 배포, 환경 변수, 백업, 감시, 결정 필요 항목 |
| 12-roadmap.md | 마일스톤 M0~M9와 완료 기준 |
| 13-decisions.md | 사용자 결정이 필요한 항목과 기본안 |
게임 문서
games/README.md — 전체 게임 목록, 우선순위, 제외 이유, 상표 표시 방침.
게임별 문서는 games/<id>.md, 형식은 games/_TEMPLATE.md.