- 규칙 모듈 packages/games/src/magical-athlete: 선수 24명(능력 처리 순서가 하나로 정해지는 선수만), 뱀 순서 뽑기(2~3명은 선수 8명·경주마다 둘, 4~6명은 4명·하나), 몰래 동시에 출전 선수 고르기, 경주 4번(순한 판·거친 판 번갈아, 거친 판은 화살표·돌·별 칸), 1등 3점·2등 1점(갈수록 커지는 점수표 옵션). 능력 처리 순서 고정: 칸 효과 → 차례인 사람 → 시계 방향, 연쇄는 줄 끝, 선수당 한 차례 5번, 두 번째 도착 즉시 종료, 경주 차례 상한. 시간 초과는 안전한 기본값(능력 안 씀), 나간 사람 선수는 자동으로 끝까지. - 컴퓨터: 평가값 뽑기, 칸 수 기대 이득으로 능력 판단, 레벨별 실수. - 화면: 뱀 모양 경주로 SVG(PC 11칸·휴대폰 8칸 줄), 말 이동 애니메이션, 능력 버튼, 경주 기록, 결과 표, 도움말·30초 요약. 판이 화면보다 길면 위에서 시작(가운데 정렬이면 위가 잘려 고르기 카드를 못 누름). - 등록(GAMES, CATALOG, BOT_GAMES, BOT_STRATEGIES, 화면 레지스트리, 아이콘·판 탭), 문서 docs/games/magical-athlete.md. - 테스트: 규칙·능력·순서 42개(문서 예시 포함), 컴퓨터 10개, 도움말 2개, 방 통합 2개(컴퓨터 1·3명과 끝까지), E2E(PC 방장 + 휴대폰, 실제 뽑기·고르기·굴리기·능력으로 네 경주 끝까지). 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 | 사용자 결정 항목(확정/대기) |
| 14-admin.md | 관리자 사이트: 권한(슈퍼어드민/어드민), 게임·사이트 설정, 사용자 관리, 기록 |
게임 문서
games/README.md — 전체 게임 목록, 우선순위, 제외 이유, 상표 표시 방침.
게임별 문서는 games/<id>.md, 형식은 games/_TEMPLATE.md.