Files
joke-app/docs
EJClaw 8aad123222 새 게임 핫스트릭: 마스코트 넷의 카드 경주에 티켓으로 거는 파티 게임(2~10명, 놀이용 가상 돈)
- 엔진 packages/games/src/hot-streak/(cards·rules·race·index·sim·bot): 뱀 순서 티켓 뽑기(안전/위험 면) → 비밀 카드 넣기 → 경주 → 정산, 경주 3번
  - 경주는 서버 타이머가 flipSeconds마다 카드 한 장씩(timeoutPlayers 한 자리 + timeoutNotBefore, 끊겨도 빨라지지 않음), 모두 [빨리 보기]면 끝까지 바로
  - 카드 53장·충돌·기어가기·꺾기·초록 카드·허들·경주로 접기(13→10→7→3→0)·시상대 공동 실격·사이드 질문 12개 판정
  - 섞을 때마다 카드 id 접미사(#gen)를 새로 붙여 유출 검사가 헷갈리지 않음
  - §2 옵션 13개 모두: bettingMode(9~10명 상금 나누기 포함), races, finalBet, draftStart, reverseBets, cardsPerRace, burn, spicyDeck, hurdles, potScale, lifeStory, turnSeconds, flipSeconds
- 컴퓨터: 공개 정보로 덱을 추정해 몬테카를로 경주(레벨 1: 30번 ~ 60: 400번), 티켓·두 배·카드 넣기·상금 나누기 기대값, humanBest
- 화면 apps/web/src/games/hot-streak/: 직접 그린 SVG 마스코트(곰·핫도그·아귀·여왕)와 카드, PC 가로·휴대폰 세로 경주로, 경주 기록을 한 박자 늦게 다시 그리기(폴짝·쾅·실격·등수·접기), 티켓 더미·두 배·비밀 카드·상금 나누기·정산·최종 결과(인생 결과), 도움말·30초 요약
- 등록: GAMES·BOT_STRATEGIES·BOT_GAMES·CATALOG·GAME_UI·GAME_ICON·여럿이 파티 탭, docs/games/README.md, 설계 문서 §13 구현 메모(정한 세부 규칙)
- 테스트: 엔진 64개(§10 체크리스트·§5.8 예시·무작위 대국·시간 초과만으로 끝·유출 없음), 컴퓨터 15개, 도움말 2개, 방 통합 3개, e2e/games.e2e.ts hot-streak(PC + 휴대폰, 320px 넘침 확인)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 23:28:18 +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.