문서: 9·10단계 진행 기록, 수집 cron

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-18 22:44:59 +09:00
parent 674cd377b4
commit c81b6b8c9a
2 changed files with 7 additions and 2 deletions

View File

@@ -47,3 +47,6 @@
- .9 `/home/claude/projects/music_quiz` (gitea main 클론), 컨테이너 `music_quiz-app-1`, 볼륨 `music_quiz_app-data`, `deploy/.env` 권한 600
- NPMplus 프록시 호스트 id 14 → `192.168.10.9:2974`, 고급 설정은 `deploy/npmplus-advanced.conf`, 인증서는 `deploy/cert.sh`(다시 돌려도 안전)
- 백업(매일 `VACUUM INTO`)은 노래 DB가 생기는 3단계에서 붙인다
- 수집 cron(.9 crontab, 컨테이너 안에서 `docker exec`): 02:00 차트, 02:20 멜론 곡 정보 1,000곡, 03:15 하이라이트 400곡(4초 간격), 03:55 난이도, 04:10 유튜브 원곡 찾기 3,000곡. 로그 `~/music_quiz-collect.log`, `~/music_quiz-match.log`. 관리자 "수집" 화면에서 따로 실행·멈추기 가능
- 9단계 전 DB 백업: `~/backups/music_quiz/app-before-stage9-*.db`

View File

@@ -13,8 +13,8 @@
| 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 |
| 9. 수집 확장 ✔ | 멜론·지니·벅스 연도별/실시간, 유튜브·스포티파이 플레이리스트, 노래방 차트, 난이도 계산 | 곡 1만+, 난이도 분포 확인 |
| 10. 다듬기 ✔ | 휴대폰 화면, 다크 테마, 접근성 검사, 부하 테스트(100명 방) | axe 위반 0, 100명 방에서 채팅 지연 < 200ms |
- 1~2단계를 먼저 해서 **로그인과 아이콘을 실제 주소에서 바로 확인**할 수 있게 한다
- 3단계(노래 DB)는 오래 걸리므로 4~6단계와 나란히 진행
@@ -27,4 +27,6 @@
- 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