Files
joke-app/docs/12-roadmap.md
EJClaw f4d63e1544 docs: 온라인 보드게임 사이트 계획서 (공통 14편 + 게임 26종)
- 개요, 조사(BGA·한국 인기 보드게임·UI/UX), 아키텍처, 실시간 프로토콜,
  안정성·보안, 계정, 로비·방, UI/UX, 데이터 모델, 게임 엔진, 테스트,
  배포·운영, 로드맵(M0~M9), 사용자 결정 항목
- 게임별 규칙·엔진 설계·UI·테스트 체크리스트 26종

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 04:18:29 +09:00

3.0 KiB

12. 로드맵

각 마일스톤은 "완료 기준"을 모두 통과해야 끝난다. 마일스톤이 끝날 때마다 Gitea에 푸시하고, 큰 테스트(부하·장애 주입·E2E)는 푸시한 커밋에서 돌린다.

M0. 계획서 (현재)

  • docs/ 전체 작성 → Gitea 푸시.
  • 완료 기준: 모든 공통 문서 + 26개 게임 문서 존재, 사용자 확인 항목 정리.

M1. 플랫폼 뼈대 + 오목

  • 모노레포, 공용 타입/스키마, 엔진(RNG·러너·테스트 도구), SQLite·마이그레이션.
  • 게스트 로그인, 세션, /api/me, 닉네임 변경. (디스코드 로그인은 코드까지 작성, 실제 연결은 앱 정보 받은 뒤)
  • 방: 생성, 6자리 코드, 링크 입장, 자동 착석, 준비, 시작, 강퇴, 방장 이전, 관전, 채팅/반응, 한 판 더.
  • WS: 재접속, seq, 중복 방지, 속도 제한, 하트비트, 서버 재시작 복구.
  • 웹: 홈, 코드 입력, 대기실(코드/링크 복사, 공유, QR), 오목 화면, 결과, 계정, 글자 크기/다크 모드.
  • 완료 기준: 10-testing.md 3절 12개 시나리오 자동 테스트 통과, 오목 규칙 테스트 통과, E2E 1개 통과, 성능 예산 통과.

M2. 2인 전략 게임 + 안정성 검증

  • 체스, 바둑, 장기, 오셀로. 개인 시계(초읽기/증가), 무르기 요청, 무승부 제안, 기권.
  • 디스코드 로그인 실제 연결(앱 정보가 준비된 경우).
  • 첫 부하 테스트·장애 주입 테스트 + 보고서.
  • 테스트 서버 배포(위치가 정해진 경우).

M3. 카드 게임 기반 + 섯다·포커

  • 공용 카드 컴포넌트(트럼프·화투 SVG 직접 제작), 베팅 엔진(한국식/노리밋), 사이드 팟.
  • 섯다 전 모드, 포커 전 모드.
  • 공정성 확인(시드 해시 공개) 기능.

M4. 가족 게임

  • 윷놀이, 원카드(+색깔 카드 모드), 숫자 타일(루미큐브 방식), 다빈치 코드, 요트 다이스.

M5. 마작·고스톱

  • 리치 마작(4인, 3인), 점수 계산기 테스트(역·부 계산 사례 100개 이상), 초보 모드.
  • 고스톱/맞고.

M6. 뱅 + 실시간 반응 + 땅따먹기

  • 뱅(반응 창 처리), 할리갈리(서버 도착 순서 판정), 주사위 땅따먹기.

M7. 보드게임카페 인기 게임

  • 달무티, 보석 상인, 쿼리도, 라스베가스, 바퀴벌레 포커, 구십구.

M8. 파티 게임

  • 도블, 그림 맞히기(붓질 스트리밍), 마피아(채팅 채널).

M9. 다듬기

  • PWA(홈 화면 추가, 오프라인 안내), 게임 기록 다시 보기, 게임별 튜토리얼 강화.
  • 2차 부하 테스트, 필요 시 방 단위 다중 프로세스 분산 검토.
  • (선택) 혼자 연습용 간단한 컴퓨터 상대.

순서 원칙

  • 플랫폼(M1)의 안정성 기능이 먼저다. 게임은 그 위에 하나씩 얹는다.
  • 각 게임은 "규칙 모듈 + 테스트 통과 → 화면 → E2E 한 판" 순서로 완성하고 다음 게임으로 간다.
  • 진행 중 사용자가 순서를 바꾸고 싶으면 이 문서를 먼저 고친다.