This website requires JavaScript.
Explore
Help
Sign In
tkrmagid
/
music_quiz
Watch
1
Star
0
Fork
0
You've already forked music_quiz
Code
Issues
Pull Requests
Actions
Packages
Projects
Releases
Wiki
Activity
Files
ced94614ca8ce84ed32cbfdab0587bc79f0bb89b
music_quiz
/
docs
History
EJClaw
666c236a8e
이지선다 모드: 조회수가 더 높은 곡 고르기. 이지선다 퀴즈는 조회수가 든 파일로 만들고(custom_quizzes.kind='duel', custom_quiz_items.views, 013 마이그레이션; 1,234,567·123만·1.2억도 읽음, 조회수 없는 줄은 빠짐) 이지선다에서만, 일반 퀴즈는 듣고맞추기에서만 쓴다. 서버 game/duel.ts: 문제마다 A/B 카드, 카드를 누르면 고른 것(시간 전까지 바꾸기), 시간이 끝나면 조회수 공개·높은 쪽 1점·역배(혼자 맞히고 반대쪽 2명 이상) 2점·같으면 둘 다 정답, 매번 새 두 곡/연속(이긴 곡이 조회수를 보인 채 A로 남음). 화면 DuelScreen: 고른 사람 프로필이 카드 밑에, 카드마다 숨은 플레이어(net/duel-player.ts)로 각자 듣고 다시 누르면 멈춘 곳부터 이어서. 방 설정 이지선다(제한 시간 기본 30초·진행 방식·재생위치·문제 수, 이지선다 퀴즈만 목록에), 결과 화면 역배 성공 수. 관리자 파일로 만들기 종류 선택(조회수 열이 있으면 이지선다), 조회수 편집·내보내기·빈 양식. 폰 점수판 가로 스크롤 키보드 접근(axe). 서버 테스트 146개, e2e duel(실제 유튜브 이어 듣기 포함)·game·quiz·admin·rooms·login·a11y 통과
...
Co-Authored-By: Claude Opus 5.5 <
noreply@anthropic.com
>
2026-10-23 21:02:43 +09:00
..
mockups
예시 화면: 첫 화면·대기실/방 설정·모드별 설정·게임·가사·휴대폰·관리자 목업
2026-10-18 17:14:17 +09:00
reference
자료: 스타크래프트 노래맞추기 곡 목록(sta_songs.json)과 UI 참고 이미지 추가
2026-10-18 16:59:37 +09:00
research
문서: 개요·구조·로그인/관리자·게임 진행·채팅·유튜브 재생 설계 초안
2026-10-18 17:07:48 +09:00
00-overview.md
문서: 사용자 답변 확정 반영(12-decisions) — IFrame 동기화 재생, 정답인식 기본 켬, 힌트 직접선택·다시듣기 투표, N단계만+기준별 단계, 이어풀기·저장, 채팅 정답 블록 원자성, 쿠키·디스크 정리
2026-10-18 19:21:11 +09:00
01-architecture.md
문서: 사용자 답변 확정 반영(12-decisions) — IFrame 동기화 재생, 정답인식 기본 켬, 힌트 직접선택·다시듣기 투표, N단계만+기준별 단계, 이어풀기·저장, 채팅 정답 블록 원자성, 쿠키·디스크 정리
2026-10-18 19:21:11 +09:00
02-auth-admin.md
원곡 찾기 진행 상황 자세히: 상태 배지(찾는 중·검색 실패 대기·N분째 진행 없음·프로세스 없음), 숫자 카드(처리·남은 곡·최근 10분 속도·지난/남은 시간·끝 예상·마지막 처리), 검색 방법, 결과 비율 막대, 방금 처리한 곡 8개, 작업 기록(쉬운 말), 지난 작업, 전체 확정 비율·다음 자동 실행. 끝 예상은 최근 10분 속도로, 마감(--deadline)은 시작 로그에서 읽음
2026-10-19 22:09:45 +09:00
03-ui-design.md
문서: 디자인·방 설정·노래 DB·배포·작업 순서·질문 정리, 보고서.pdf 생성
2026-10-18 17:19:59 +09:00
04-room-settings.md
이지선다 모드: 조회수가 더 높은 곡 고르기. 이지선다 퀴즈는 조회수가 든 파일로 만들고(custom_quizzes.kind='duel', custom_quiz_items.views, 013 마이그레이션; 1,234,567·123만·1.2억도 읽음, 조회수 없는 줄은 빠짐) 이지선다에서만, 일반 퀴즈는 듣고맞추기에서만 쓴다. 서버 game/duel.ts: 문제마다 A/B 카드, 카드를 누르면 고른 것(시간 전까지 바꾸기), 시간이 끝나면 조회수 공개·높은 쪽 1점·역배(혼자 맞히고 반대쪽 2명 이상) 2점·같으면 둘 다 정답, 매번 새 두 곡/연속(이긴 곡이 조회수를 보인 채 A로 남음). 화면 DuelScreen: 고른 사람 프로필이 카드 밑에, 카드마다 숨은 플레이어(net/duel-player.ts)로 각자 듣고 다시 누르면 멈춘 곳부터 이어서. 방 설정 이지선다(제한 시간 기본 30초·진행 방식·재생위치·문제 수, 이지선다 퀴즈만 목록에), 결과 화면 역배 성공 수. 관리자 파일로 만들기 종류 선택(조회수 열이 있으면 이지선다), 조회수 편집·내보내기·빈 양식. 폰 점수판 가로 스크롤 키보드 접근(axe). 서버 테스트 146개, e2e duel(실제 유튜브 이어 듣기 포함)·game·quiz·admin·rooms·login·a11y 통과
2026-10-23 21:02:43 +09:00
05-game-flow.md
문서: IFrame 재생을 전원 준비 보장 방식으로 보강(자동 진행 없음·소리 허용·일시정지 중 시간 정지·위치 기준 클립), 실제 브라우저 시험 결과·도구 추가, 디스크 정리에서 ~/.tmp 제외
2026-10-18 19:28:10 +09:00
06-chat.md
문서: 사용자 답변 확정 반영(12-decisions) — IFrame 동기화 재생, 정답인식 기본 켬, 힌트 직접선택·다시듣기 투표, N단계만+기준별 단계, 이어풀기·저장, 채팅 정답 블록 원자성, 쿠키·디스크 정리
2026-10-18 19:21:11 +09:00
07-song-database.md
10단계 다듬기: axe 접근성 검사(첫 화면·대기실·게임·정답 공개·결과·관리자, PC/휴대폰 × 밝은/어두운 화면) 위반 0으로 고침(배지·정답 글자 대비, 게임 화면 main·방 정보 영역, 제목 순서, 별 아이콘), 100명 부하 시험 + TJ는 최근 2년만, 멜론 곡 정보는 가사·연도 없는 곡부터
2026-10-18 22:43:26 +09:00
08-youtube-playback.md
연령제한 곡 재생: 유튜브가 퍼가기 플레이어에서 막는(오류 150) 연령제한 영상은 서버가 성인 인증된 계정 쿠키로 소리만 받아 두고(/data/audio, yt-dlp) 게임은 그 파일을 숨긴 <audio>로 재생. 찾기는 소리 크기·하이라이트 수집(로그인 없는 페이지의 성인 인증 화면) + 게임 중 오류 시 age-audio 작업이 다시 확인해 되돌림. 받기 전에는 출제 안 함. prepare·catchup에 videoId 대신 문제마다 새 무작위 주소(/api/audio/<토큰>, Range 지원)라 영상 id가 안 보임. 같은 시각 시작·위치 정지·새로고침 이어 듣기·소리 크기(유튜브 -14 보정 없이) 그대로. 관리자 수집 화면·cli age-audio, Dockerfile에 yt-dlp(버전·체크섬 고정), 수집 CLI가 서버 DB 경로를 물려받게(테스트가 기본 DB를 건드리던 것). 실제 크롬 e2e로 받은 음원+유튜브 곡 섞어 재생 확인
2026-10-20 08:11:55 +09:00
09-deploy-ops.md
연령제한 곡 재생: 유튜브가 퍼가기 플레이어에서 막는(오류 150) 연령제한 영상은 서버가 성인 인증된 계정 쿠키로 소리만 받아 두고(/data/audio, yt-dlp) 게임은 그 파일을 숨긴 <audio>로 재생. 찾기는 소리 크기·하이라이트 수집(로그인 없는 페이지의 성인 인증 화면) + 게임 중 오류 시 age-audio 작업이 다시 확인해 되돌림. 받기 전에는 출제 안 함. prepare·catchup에 videoId 대신 문제마다 새 무작위 주소(/api/audio/<토큰>, Range 지원)라 영상 id가 안 보임. 같은 시각 시작·위치 정지·새로고침 이어 듣기·소리 크기(유튜브 -14 보정 없이) 그대로. 관리자 수집 화면·cli age-audio, Dockerfile에 yt-dlp(버전·체크섬 고정), 수집 CLI가 서버 DB 경로를 물려받게(테스트가 기본 DB를 건드리던 것). 실제 크롬 e2e로 받은 음원+유튜브 곡 섞어 재생 확인
2026-10-20 08:11:55 +09:00
10-roadmap.md
이지선다 모드: 조회수가 더 높은 곡 고르기. 이지선다 퀴즈는 조회수가 든 파일로 만들고(custom_quizzes.kind='duel', custom_quiz_items.views, 013 마이그레이션; 1,234,567·123만·1.2억도 읽음, 조회수 없는 줄은 빠짐) 이지선다에서만, 일반 퀴즈는 듣고맞추기에서만 쓴다. 서버 game/duel.ts: 문제마다 A/B 카드, 카드를 누르면 고른 것(시간 전까지 바꾸기), 시간이 끝나면 조회수 공개·높은 쪽 1점·역배(혼자 맞히고 반대쪽 2명 이상) 2점·같으면 둘 다 정답, 매번 새 두 곡/연속(이긴 곡이 조회수를 보인 채 A로 남음). 화면 DuelScreen: 고른 사람 프로필이 카드 밑에, 카드마다 숨은 플레이어(net/duel-player.ts)로 각자 듣고 다시 누르면 멈춘 곳부터 이어서. 방 설정 이지선다(제한 시간 기본 30초·진행 방식·재생위치·문제 수, 이지선다 퀴즈만 목록에), 결과 화면 역배 성공 수. 관리자 파일로 만들기 종류 선택(조회수 열이 있으면 이지선다), 조회수 편집·내보내기·빈 양식. 폰 점수판 가로 스크롤 키보드 접근(axe). 서버 테스트 146개, e2e duel(실제 유튜브 이어 듣기 포함)·game·quiz·admin·rooms·login·a11y 통과
2026-10-23 21:02:43 +09:00
11-questions.md
문서: 사용자 답변 확정 반영(12-decisions) — IFrame 동기화 재생, 정답인식 기본 켬, 힌트 직접선택·다시듣기 투표, N단계만+기준별 단계, 이어풀기·저장, 채팅 정답 블록 원자성, 쿠키·디스크 정리
2026-10-18 19:21:11 +09:00
12-decisions.md
이지선다 모드: 조회수가 더 높은 곡 고르기. 이지선다 퀴즈는 조회수가 든 파일로 만들고(custom_quizzes.kind='duel', custom_quiz_items.views, 013 마이그레이션; 1,234,567·123만·1.2억도 읽음, 조회수 없는 줄은 빠짐) 이지선다에서만, 일반 퀴즈는 듣고맞추기에서만 쓴다. 서버 game/duel.ts: 문제마다 A/B 카드, 카드를 누르면 고른 것(시간 전까지 바꾸기), 시간이 끝나면 조회수 공개·높은 쪽 1점·역배(혼자 맞히고 반대쪽 2명 이상) 2점·같으면 둘 다 정답, 매번 새 두 곡/연속(이긴 곡이 조회수를 보인 채 A로 남음). 화면 DuelScreen: 고른 사람 프로필이 카드 밑에, 카드마다 숨은 플레이어(net/duel-player.ts)로 각자 듣고 다시 누르면 멈춘 곳부터 이어서. 방 설정 이지선다(제한 시간 기본 30초·진행 방식·재생위치·문제 수, 이지선다 퀴즈만 목록에), 결과 화면 역배 성공 수. 관리자 파일로 만들기 종류 선택(조회수 열이 있으면 이지선다), 조회수 편집·내보내기·빈 양식. 폰 점수판 가로 스크롤 키보드 접근(axe). 서버 테스트 146개, e2e duel(실제 유튜브 이어 듣기 포함)·game·quiz·admin·rooms·login·a11y 통과
2026-10-23 21:02:43 +09:00
보고서.pdf
문서: 정답 정규화에 빈 비교 키 방지 규칙 추가(숫자·기호만 있는 제목), 보고서 재생성
2026-10-18 17:22:30 +09:00