Files
music_quiz/docs/10-roadmap.md
EJClaw 391bbe69e5 1단계 뼈대: joke-app에서 로그인(디스코드·게스트)·세션·권한·관리자·DB를 가져와 음악퀴즈용으로 정리, 새 디자인·아이콘, WS 연결·시계 맞추기, 테스트·e2e
- apps/server: Hono API(auth/me/config/admin), Bun WebSocket(welcome·ping/pong, 압축 끔), SQLite 마이그레이션
- 사이트 설정: 채팅 도배 방지 기본 꺼짐(관리자가 켬, 초당·순간 횟수)
- apps/web: 첫 화면·로그인·관리자(대시보드·사이트·사용자·관리자·기록), 라이트/다크, 휴대폰, noindex
- packages/shared: 닉네임 규칙, 프로토콜(zod), 시계 차이 계산
- 테스트 20개 + 브라우저 e2e 6단계 통과

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

2.8 KiB

10. 작업 순서

각 단계가 끝날 때마다 gitea main에 커밋·푸시하고, 테스트 결과를 남긴다.

단계 내용 끝났다고 보는 기준
0. 설계 ✔ md 문서, 아이콘, 예시 화면, 보고서.pdf, 답변 반영(12 문서) 사용자 답변 완료(2026-10-18)
1. 뼈대 ✔ joke-app에서 auth·세션·관리자·DB·UI 키트 가져오기, 봇 코드 제거, 새 색·아이콘 적용 디스코드 로그인 → 아이콘 보이는 동의 화면 → 로그인 성공(e2e), 슈퍼어드민 2명 관리자 접근
2. 배포 먼저 Docker, 2974 포트, NPMplus, 인증서 https://mquiz.tkrmagid.kr 에서 로그인 실제 확인
3. 노래 DB 1차 sta_songs 803곡 + 노라보세 8,572곡 가져오기, 멜론 정보, 유튜브 Topic 매칭 곡 9천+, 유튜브 확정률 90%+, 관리자 노래 목록에서 확인
4. 방·로비 방 목록, 방 만들기, 인원 무제한, 방 설정 전체(04 문서) 설정 변경이 모두에게 즉시 반영, "조건에 맞는 곡 N곡" 정확
5. 게임 핵심 라운드 진행, 숨긴 유튜브 플레이어 동기화 재생(준비·동시 시작·버퍼링 일시정지), 정답 판정, 점수, 결과, 이어풀기·저장/불러오기 3명 동시 e2e로 30문제 끝까지, 정답 판정 단위 테스트
6. 채팅 가운데 아래 큰 채팅, 입력 중, 5줄 정답 블록, 단축키 체감 지연 없음(로컬 왕복 < 50ms), Ctrl+I/K 동작
7. 힌트·스킵·모드 초성 힌트(시간/직접선택 투표), 스킵·다시듣기 투표, 가수노래·가사 모드, 하이라이트 모드 3종 e2e
8. 관리자 완성 노래 CRUD·필터·후보 확인·하이라이트 지정, 수집 작업 UI, 통계, 사용자/관리자 관리자 e2e(joke-app admin.e2e 확장)
9. 수집 확장 멜론·지니·벅스 연도별/실시간, 유튜브·스포티파이 플레이리스트, 노래방 차트, 난이도 계산 곡 1만+, 난이도 분포 확인
10. 다듬기 휴대폰 화면, 다크 테마, 접근성 검사, 부하 테스트(100명 방) axe 위반 0, 100명 방에서 채팅 지연 < 200ms
  • 1~2단계를 먼저 해서 로그인과 아이콘을 실제 주소에서 바로 확인할 수 있게 한다
  • 3단계(노래 DB)는 오래 걸리므로 4~6단계와 나란히 진행

진행 기록

  • 2026-10-18 1단계: joke-app에서 로그인(디스코드·게스트)·세션·권한·관리자(대시보드·사이트·사용자·관리자·기록)·DB 마이그레이션을 가져오고 보드게임·컴퓨터 대결 코드는 제외. 새 색·아이콘 적용, WebSocket 연결 + 시계 맞추기(ping). 서버·공용 테스트 20개, 브라우저 e2e 6단계(e2e/login.e2e.ts) 통과. 실제 디스코드 동의 화면 확인은 2단계(배포) 후