33 lines
7.8 KiB
Markdown
33 lines
7.8 KiB
Markdown
# 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
|
||
|