Files
music_quiz/docs/10-roadmap.md

11 KiB
Raw Permalink Blame History

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 57단계(엔진이 하나라 함께 진행): 서버 게임 진행기(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 문서 "57단계 확인"

  • 2026-10-18 8단계: 관리자 노래(추가·초성 검색·하이라이트/가사/숨김 필터·출제 수·정답률 정렬·일괄 작업(숨김·난이도·장르 넣기/빼기·유튜브 다시 찾기·휴지통)·휴지통 30일·CSV/JSON 내보내기·가져오기(이미 있는 곡은 그대로)·중복 병합·미리듣기 "지금 위치를 하이라이트로"), 가수 별칭(정답 인정), 장르 추가·이름·순서·숨김, 통계(곡별 출제·정답률·평균 시간, 5회 이상이면 난이도 제안 → 승인), 방(비공개 포함 목록·강제 종료), 수집(실행·멈추기·로그, 쿠키 로그아웃 경고), 사이트(문제 제한 시간, 새 방 기본 설정·잠금), 대시보드(게임 중 방·24시간 게임 수). 서버 테스트 91개, 브라우저 e2e(e2e/admin.e2e.ts) 10단계 통과. 가수의 그룹/유닛 연결·대표 이미지는 아직(이름·구분·별칭만)

  • 2026-10-18 9단계: 차트 수집(멜론 연도별 가요·팝 19842025와 실시간, 지니 연도별 19902025, 벅스 실시간, TJ 노래방 20242025) 140개 차트 10,670줄 → 새 곡 1,798곡, 전체 10,756곡. 인기도 점수로 난이도 다시 계산(전체 + 장르 11개 + 연대 5개 기준, 전체 기준 110단계 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

  • 2026-10-22 원곡 찾기 후보 자동 확정 기준 정리(12 문서), 후보 282곡 확정. 제작된 퀴즈 1~3단계: 관리자 퀴즈 편집(곡 추가·검색·순서·복수정답→DB 별칭·수동 저장·설정·공개방식·제한), 곡별 처음·하이라이트 위치 편집기, 방 설정 "제작된 퀴즈 / 직접 선택"과 실제 플레이. 서버 테스트 130개, e2e 전체 통과

  • 2026-10-22 제작된 퀴즈 4~6단계: 플레이리스트 가져오기(.6 Lavalink, 유튜브·스포티파이), 검토 대기(전체공개 퀴즈 → 서버 DB, 난이도 조정), 통계 상세(힌트·오답·다시듣기·퀴즈별). 서버 테스트 132개, e2e 전체 통과

  • 2026-10-23 퀴즈 파일 A단계: 관리자 → 퀴즈 "파일로 만들기"(.xlsx·.csv, 라이브러리 없이 브라우저가 읽음 — packages/shared/src/sheet.ts), 열 이름으로 링크·정답·설명·힌트·순번 등을 찾고(quiz-file.ts) 못 찾은 열만 고름, 시트 고르기, 잘못된 링크·같은 영상 줄 표시. 편집 화면 "파일에서 가져오기"(뒤에 추가·목록 바꾸기), "엑셀로 내보내기"(다시 올릴 수 있는 형식)·빈 양식. 파일 곡은 적힌 값 그대로(서버 DB 연결·검토 대기 없음, 설명 비어도 됨). 곡별 힌트(custom_quiz_items.hints): 힌트를 하나씩 → 마지막에 초성(자동은 N초마다, 직접선택은 투표마다). 사용자 BGM 파일 390곡 그대로 생성 확인. 테스트 140개, e2e quiz·game·admin·a11y 통과

  • 2026-10-23 이지선다(B단계): 모드 "이지선다"와 이지선다 퀴즈(파일의 조회수, kind/views 013 마이그레이션). 서버 game/duel.ts(A/B 카드, 고르기·바꾸기, 시간 끝나면 조회수 공개, 1점·역배 2점, 매번 새 두 곡/연속), 화면 DuelScreen.tsx(카드마다 숨은 플레이어 net/duel-player.ts로 각자 듣고 이어 듣기, 고른 사람 프로필), 방 설정(제한 시간·진행 방식·재생위치·문제 수), 관리자 파일로 만들기 종류 선택·조회수 편집·내보내기. 테스트 146개, e2e duel(실제 유튜브 이어 듣기 포함)·game·quiz·admin·rooms·login·a11y 통과

  • 2026-11-03 이지선다 조회수 자동: 빈 양식에서 조회수 열을 빼고, 올린 뒤 서버가 곡마다 토픽 + MV 조회수를 불러와 더함(유튜브 뮤직 노래↔동영상 짝, 쿠키 필요 · 조회수는 로그인 없이). 편집기에 곡마다 토픽·MV 조회수, 비고(한쪽만 있는 곡·직접 넣은 값·실패 이유), 불러오는 중 표시, 조회수 다시 불러오기(전체/곡). 파일에 적힌 숫자는 그대로 씀. 014 마이그레이션, 단위·API 테스트, e2e duel 단계 추가

  • 2026-11-03 재생목록으로 엑셀 만들기: 관리자 → 퀴즈 카드, 플레이리스트 검토 결과를 파일로 만들기용 엑셀(퀴즈 + 빠진 곡 시트, 비고·길이)로 받음. 파일로 만들기에 "시작·하이라이트가 빈 곡: 자동 / 처음부터", 길이(초) 열, 자동이면 같은 영상의 DB 하이라이트·길이를 씀. 영상 제목 형식이 달라 채널 이름을 가수로 쓴 곡은 "제목·가수 확인 필요". 단위·API 테스트, e2e quiz 단계 추가 (12 문서 제작된 퀴즈 13·14)