Files
joke-app/docs/12-roadmap.md
EJClaw a10139b51a M2: 바둑 추가, 4게임 E2E 안정화, 로드맵 M2 결과 기록
- 바둑: 9·13·19줄, 따내기·자충수 금지·슈퍼코(Zobrist)/한국식 삼패 무승부, 접바둑·덤, 패스,
  사석 확인 단계(자동 제안·동의·이의 시 재개), 집/영역 계가, 초읽기·피셔 시계 (테스트 50개)
- 쓰이지 않던 바둑 옵션(연결 끊김 유예 — 방 설정이 담당) 제거
- 홈 '방 만들기'가 게임 고르기 창을 거치도록 바뀐 것에 맞춰 E2E 수정, 장기 상차림 단계 E2E 안정화
- 전체: 테스트 230개, E2E 오목·관리자·4게임·접근성 모두 통과

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

3.8 KiB

12. 로드맵

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

M0. 계획서 (현재)

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

M1. 플랫폼 뼈대 + 오목

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

M1.5 관리자 사이트

  • 슈퍼어드민(디스코드 ID 고정)·어드민(디스코드 ID로 추가) 권한, 관리자 API, 관리자 화면(대시보드·게임·방·사이트·사용자·관리자·기록).
  • 게임 옵션 스키마로 설정 화면 자동 생성, 옵션 잠금, 사이트 설정(공지·점검·금지어·제한값).
  • 완료 기준: 14-admin.md 9절 테스트 통과, 관리자 화면 E2E 통과.

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

  • 체스, 바둑, 장기, 오셀로. 개인 시계(초읽기/증가), 무르기 요청, 무승부 제안, 기권.
  • 디스코드 로그인 실제 연결(앱 정보가 준비된 경우).
  • 첫 부하 테스트·장애 주입 테스트 + 보고서.
  • 테스트 서버 배포(위치가 정해진 경우).
  • 진행 결과(2026-10-04): 네 게임 완료(규칙 테스트 체스 40·장기 46·바둑 50·오셀로 31), 게임 공통 E2E(PC 방장+휴대폰 친구), 접근성 axe 위반 0, 부하·장애 주입 통과(reports/load-20261004.md). 체스960은 chess.js가 지원하지 않아 후순위(M9). 디스코드 실제 연결·테스트 서버 배포는 사용자 정보 대기.

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

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

M4. 가족 게임

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

M5. 마작·고스톱

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

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

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

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

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

M8. 파티 게임

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

M9. 다듬기

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

순서 원칙

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