Files
music_quiz/docs/10-roadmap.md
2026-10-18 22:44:59 +09:00

33 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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단계(배포) 후
- 2026-10-18 2단계: .9 `/home/claude/projects/music_quiz`에 Docker(포트 2974, 메모리 1GB) 배포, NPMplus 프록시 호스트 14 + Let's Encrypt(인증서 32, HTTP/2·HSTS·CSP·noindex). 실제 주소에서 첫 화면·게스트 로그인·WebSocket·디스코드 동의 화면 이동 확인. 디스코드 실제 로그인(Redirect 등록 확인)은 사용자 로그인으로 확인
- 2026-10-18 3단계(진행 중): 곡 8,958곡(노라보세 8,518 + 스타맵 새 곡 440, 겹치는 363곡은 합침), 가사 8,261곡, 관리자 노래·수집 화면 배포. 유튜브 원곡 확정은 쿠키가 로그아웃돼 멈춤 → 새 쿠키를 받으면 매일 04:10에 하루 3,000곡씩(약 3일) 진행. 로그인 없는 대체 검색은 표본 60곡 중 19곡만 확정돼 대량 실행하지 않음(같은 집 IP의 music_bot_v2 차단 위험)
- 2026-10-18 4단계: 방 만들기(게스트 포함)·숫자 6자리 코드·열린 방 목록(전체/대기 중/진행 중, 🔒 비밀번호 방), 인원 무제한 대기실(방장·준비·방장 넘기기·내보내기, 끊겨도 60초 자리 유지), 방 설정 전체가 모두에게 즉시 반영, "조건에 맞는 곡 N곡" + 원곡 확인 중 곡 수(1분마다 다시 셈), 대기실 채팅, 서버 재시작 안내. 서버 테스트 49개, 브라우저 e2e(`e2e/rooms.e2e.ts`, 3명) 11단계 통과. 결정은 12 문서 "4단계 확인". 같은 날 새 쿠키로 유튜브 원곡 찾기 다시 시작(표본 20곡 중 16곡 확정)
- 2026-10-18 사용자: "목록으로 나갔을 때 방에 아무도 없으면 바로 삭제, 나머지 전부 진행" → 마지막 사람이 나가면(← 방 목록·로고·뒤로 가기·나가기·내보내기 시간 초과) 방을 바로 닫음. 만들고 아무도 안 들어간 방만 5분. 탭 닫기·끊김은 60초 자리 유지 그대로
- 2026-10-18 5~7단계(엔진이 하나라 함께 진행): 서버 게임 진행기(`apps/server/src/game/engine.ts`) — 출제 목록(최근 3게임 곡 뒤로, 같은 가수 연속 안 나오게), 전원 준비 뒤 같은 시각 재생, 버퍼링·소리 차단이면 모두 멈추고 같은 위치에서 다시, 30초 늦은 사람은 방장이 이번 문제만 제외, 재생 오류 100/101/150이면 같은 번호로 다른 곡(그 곡은 재생 불가 표시), 문제 시간(멈춘 시간 제외), 클립은 재생 위치로 정지. 정답 판정(`packages/shared/src/answer.ts`), 먼저 맞힌 1명 +1(동점은 평균 정답 시간), 정답 줄 + 5줄 블록 한 덩어리, 입력 중, Ctrl+I/K/R, 힌트(시간·직접선택), 스킵·다시듣기 투표, 3모드, 결과·이어풀기·다시 하기, 퀴즈 저장·불러오기(디스코드 계정, 20개). 서버 테스트 80개, 브라우저 e2e(`e2e/game.e2e.ts`) 3명 30문제 끝까지 + 모드 3종 + 실제 유튜브 2명 동시 재생(위치 차이 0.02초, 3초 클립 정지 오차 0.01초 이내) 통과. 결정은 12 문서 "5~7단계 확인"
- 2026-10-18 8단계: 관리자 노래(추가·초성 검색·하이라이트/가사/숨김 필터·출제 수·정답률 정렬·일괄 작업(숨김·난이도·장르 넣기/빼기·유튜브 다시 찾기·휴지통)·휴지통 30일·CSV/JSON 내보내기·가져오기(이미 있는 곡은 그대로)·중복 병합·미리듣기 "지금 위치를 하이라이트로"), 가수 별칭(정답 인정), 장르 추가·이름·순서·숨김, 통계(곡별 출제·정답률·평균 시간, 5회 이상이면 난이도 제안 → 승인), 방(비공개 포함 목록·강제 종료), 수집(실행·멈추기·로그, 쿠키 로그아웃 경고), 사이트(문제 제한 시간, 새 방 기본 설정·잠금), 대시보드(게임 중 방·24시간 게임 수). 서버 테스트 91개, 브라우저 e2e(`e2e/admin.e2e.ts`) 10단계 통과. 가수의 그룹/유닛 연결·대표 이미지는 아직(이름·구분·별칭만)
- 2026-10-18 9단계: 차트 수집(멜론 연도별 가요·팝 1984~2025와 실시간, 지니 연도별 1990~2025, 벅스 실시간, TJ 노래방 2024~2025) 140개 차트 10,670줄 → 새 곡 1,798곡, **전체 10,756곡**. 인기도 점수로 난이도 다시 계산(전체 + 장르 11개 + 연대 5개 기준, 전체 기준 1~10단계 333·548·1,059·1,290·1,632·1,605·1,283·1,303·1,185·518곡). 멜론 곡 정보(발매일·장르·가사)와 유튜브 하이라이트는 매일 새벽 나눠서 채움(cron 02:00 차트, 02:20 멜론 1,000곡, 03:15 하이라이트 400곡, 03:55 난이도, 04:10 원곡 찾기 3,000곡). 스포티파이·유튜브 플레이리스트는 하지 않음(키 없음·같은 IP 차단 위험)
- 2026-10-18 10단계: axe 검사(`e2e/a11y.e2e.ts`) 첫 화면·대기실·게임·정답 공개·결과·관리자 × PC/휴대폰 × 밝은/어두운 화면 **위반 0**(정답 초록은 글자 대비 때문에 #24733d로 조금 어둡게). 부하 시험(`e2e/load.ts`, 서버 따로 띄움) 100명 한 방: 채팅이 100명 모두에게 닿는 시간 95% 1.8ms·최대 30ms, 20명 동시 8ms, 게임 3문제 모두 같은 시작 시각·정답 블록 9ms 이내, 서버 메모리 최대 102MB