Files
joke-app/docs
EJClaw c9f81804cf 클루: 규칙·컴퓨터 상대·화면·테스트
- 규칙 모듈 packages/games/src/clue: 3~6명, 용의자 6·흉기 6·방 9, 봉투 3장, 나머지는 같은 장수로
  나누고 남는 카드는 공개(원작). 9개 방 + 복도를 거리 표로 단순화한 저택(비밀 통로 부엌↔서재,
  온실↔라운지), 주사위 2개 합만큼 이동해 닿는 방에 들어가거나 먼 방 쪽으로 걸어가기, 빠른 이동 옵션.
  추리 시 용의자 말·흉기 이동과 불려 온 사람의 제자리 추리, 다음 사람부터 반증(반증자가 직접 고름,
  보여 준 카드는 두 사람만), 고발(틀리면 탈락하되 반증은 계속, 모두 틀리면 무승부).
  카드 id(card-*)와 추리 이름을 나눠 view 누출 검사가 의미 있게, 이벤트에는 카드 없음.
  시간 초과는 차례를 통째로 자동 진행, 반증은 첫 카드 자동, 나가면 카드 공개.
- 컴퓨터 상대(bot.ts): 소거 노트(내 카드·공개·받은 카드 → 못 보여 준 사람·손패 수 → "셋 중 하나"
  제약·틀린 고발), 단계가 높을수록 깊게, 확실할 때만 고발, 모르는 카드로 추리, 모르는 방으로 이동.
- 화면 apps/web/src/games/clue: 저택 지도(말·흉기·거리·통로), 주사위·방 고르기, 추리/고발 칩,
  반증 카드 고르기, 내 카드·공개 카드, 추리 노트(localStorage, 방 코드+게임 번호), 추리 기록.
- 등록(GAMES, 카탈로그, BOT_GAMES, BOT_STRATEGIES, 화면 레지스트리, 아이콘·분류), 문서
  docs/games/clue.md, E2E 계획(PC 1 + 휴대폰 2, 끝까지).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 03:09:33 +09:00
..

온라인 보드게임 사이트 계획서

광고 없이 가볍고, 링크 하나로 친구·가족과 바로 즐기는 한국형 온라인 보드게임 사이트. 구현은 이 문서들을 기준으로 하며, 결정이 바뀌면 문서를 먼저 고친다.

공통 문서

문서 내용
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.