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
da500f489b530e2a06963cfa4be7bc8bc4a628a7
music_quiz
/
docs
History
EJClaw
da500f489b
제목 정리 4단계: 서버 DB 곡 제목 정리 검토 — title_reviews(015), songs/title-review.ts(만들기·적용·건너뛰기·목록), cli clean-titles(--review: 모두 검토 목록 / 기본: 새 곡은 바로 반영, 일본어·확인 필요만 검토), 관리자 → 수집에 '제목 정리·정답 만들기', 관리자 →
✏️
제목 정리(묶음별 목록, 제목·가수 고쳐서 적용, 건너뛰기, 묶음 전체 적용, 처리한 것). 적용하면 제목·가수와 새 정답·원래 이름(별칭), match_key는 그대로, 그사이 바뀐 곡은 적용 안 함. 영어 발음 다듬기(운영 사본 표본에서): 자음 뒤 l(플렉스·블루), s+w(스위트), ts(렛츠), ow+모음(플라워), 철자 o의 ɑ는 ㅗ(존·아이콘), 약모음은 철자대로(프로미스·사이렌), 단어 끝 -sle/-zle(캐슬), 대문자 한 글자는 글자 이름(알 오 디), 아포스트로피는 's/'t 등만. 단위·API 테스트, e2e admin(제목 정리), docs 13
...
Co-Authored-By: Claude Opus 5.5 <
noreply@anthropic.com
>
2026-11-04 16:33:19 +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
이지선다 조회수 자동: 빈 양식에서 조회수 열을 빼고, 올린 뒤 서버가 곡마다 토픽 음원 + MV 조회수를 불러와 더함. 짝은 유튜브 뮤직 노래↔동영상 전환(watch 응답의 counterpart, 쿠키 필요), 조회수는 로그인 없이 player videoDetails.viewCount(안 되면 watch 화면 숫자). quizzes/duel-views.ts가 pending 곡을 한 곡씩 처리(재시작해도 이어서), 쿠키 만료면 남은 곡 모두 이유와 함께 failed. 짝이 없는 곡은 있는 영상 하나만 쓰고 비고 표시. 파일·편집기에 적은 숫자는 그대로 쓰고 다시 불러오기에서 빠짐, 칸을 비우고 저장하면 자동. 편집기: 조회수(토픽·MV)·비고 칸, 불러오는 중 표시와 2초 폴링(저장 안 됨으로 안 잡힘), 조회수 다시 불러오기(전체/곡), 저장 때 편집기의 옛 사본이 서버가 불러온 값을 덮지 않음. 내보내기는 직접 넣은 숫자만 조회수 열에. 파일로 만들기는 조회수 열이 없으면 고른 종류 유지. 014 마이그레이션, 단위·API 테스트, e2e duel 단계, docs 04·10·12
2026-11-03 21:07:10 +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
유튜브 뮤직 쿠키 끊김 줄이기: 429가 한 번이라도 나오면 쿠키를 쓰는 모든 작업(자동 갱신·로그인 확인·원곡 찾기 검색·조회수 짝 찾기·연령제한 음원 받기)이 3시간 쉼 —
<쿠키 파일>.cooldown
에 끝 시각을 적어 서버와 수집 CLI가 함께 봄(RateLimited). 원곡 찾기는 429에 1분 뒤 다시 묻지 않고 바로 멈춤(stopped), 갱신은 10분 뒤 재시도 대신 쉼이 끝날 때까지 기다림(새 쿠키 파일은 바로 확인). 검색 간격 2초 → 5초, 조회수 곡 간격 0.5초 → 2초. 다른 사이트 요청에서 복사해 __Secure-3P*만 있는 쿠키도 받음: SAPISID를 같은 값인 __Secure-3PAPISID로 읽을 때 채우고, 로그인 값은 __Secure-1PSID/3PSID 중 하나면 됨. 11/03 08:10 원곡 찾기 567곡 직후 갱신 429 → 401로 세션이 끝난 것. 회귀 테스트(채우기·갱신·검색·키퍼·원곡 찾기·연령제한·조회수), docs 08·09·12
2026-11-03 22:32:53 +09:00
09-deploy-ops.md
유튜브 뮤직 쿠키 끊김 줄이기: 429가 한 번이라도 나오면 쿠키를 쓰는 모든 작업(자동 갱신·로그인 확인·원곡 찾기 검색·조회수 짝 찾기·연령제한 음원 받기)이 3시간 쉼 —
<쿠키 파일>.cooldown
에 끝 시각을 적어 서버와 수집 CLI가 함께 봄(RateLimited). 원곡 찾기는 429에 1분 뒤 다시 묻지 않고 바로 멈춤(stopped), 갱신은 10분 뒤 재시도 대신 쉼이 끝날 때까지 기다림(새 쿠키 파일은 바로 확인). 검색 간격 2초 → 5초, 조회수 곡 간격 0.5초 → 2초. 다른 사이트 요청에서 복사해 __Secure-3P*만 있는 쿠키도 받음: SAPISID를 같은 값인 __Secure-3PAPISID로 읽을 때 채우고, 로그인 값은 __Secure-1PSID/3PSID 중 하나면 됨. 11/03 08:10 원곡 찾기 567곡 직후 갱신 429 → 401로 세션이 끝난 것. 회귀 테스트(채우기·갱신·검색·키퍼·원곡 찾기·연령제한·조회수), docs 08·09·12
2026-11-03 22:32:53 +09:00
10-roadmap.md
재생목록으로 엑셀 만들기: 관리자 → 퀴즈 목록 카드. 플레이리스트 가져오기와 같은 검토(서버 DB 곡, 영상 제목 정리, 스포티파이는 유튜브 뮤직 검색, 다른 사이트 재생 확인) 결과를 파일로 만들기가 그대로 읽는 엑셀로 받음 — 시트 '퀴즈'(순번·유튜브 영상 링크·제목·가수·시작(초)·하이라이트(초)·길이(초)·비고)와 '빠진 곡'(재생 막힘·없는 영상·못 찾은 곡·같은 영상, 이유와 함께; 제목 열이 없어 곡으로 읽히지 않음). 비고: DB 곡 / 제목·가수 확인 필요(영상 제목에 가수-제목 형식이 없어 채널 이름을 가수로 씀, 플레이리스트 가져오기에도 표시) / 확인 필요 / 유튜브 뮤직에서 찾음. 조회수 열은 넣지 않음(이지선다는 서버가 불러옴). 파일로 만들기·파일에서 가져오기: '시작·하이라이트가 빈 곡: 자동 / 처음부터' 선택(처음부터 = 0/0으로 적어 하이라이트부터 방에서도 처음부터), 길이(초) 열 읽기. 파일로 만들기의 자동 곡은 서버 DB에 같은 영상이 있으면 그 하이라이트(직접 위치로)와 길이를 씀 — 파일 곡은 DB와 연결하지 않아 자동이 늘 처음부터였던 것. writeXlsxSheets(여러 시트). 단위·API 테스트, e2e quiz 단계, docs 10·12
2026-11-03 23:20:04 +09:00
11-questions.md
문서: 사용자 답변 확정 반영(12-decisions) — IFrame 동기화 재생, 정답인식 기본 켬, 힌트 직접선택·다시듣기 투표, N단계만+기준별 단계, 이어풀기·저장, 채팅 정답 블록 원자성, 쿠키·디스크 정리
2026-10-18 19:21:11 +09:00
12-decisions.md
재생목록으로 엑셀 만들기: 관리자 → 퀴즈 목록 카드. 플레이리스트 가져오기와 같은 검토(서버 DB 곡, 영상 제목 정리, 스포티파이는 유튜브 뮤직 검색, 다른 사이트 재생 확인) 결과를 파일로 만들기가 그대로 읽는 엑셀로 받음 — 시트 '퀴즈'(순번·유튜브 영상 링크·제목·가수·시작(초)·하이라이트(초)·길이(초)·비고)와 '빠진 곡'(재생 막힘·없는 영상·못 찾은 곡·같은 영상, 이유와 함께; 제목 열이 없어 곡으로 읽히지 않음). 비고: DB 곡 / 제목·가수 확인 필요(영상 제목에 가수-제목 형식이 없어 채널 이름을 가수로 씀, 플레이리스트 가져오기에도 표시) / 확인 필요 / 유튜브 뮤직에서 찾음. 조회수 열은 넣지 않음(이지선다는 서버가 불러옴). 파일로 만들기·파일에서 가져오기: '시작·하이라이트가 빈 곡: 자동 / 처음부터' 선택(처음부터 = 0/0으로 적어 하이라이트부터 방에서도 처음부터), 길이(초) 열 읽기. 파일로 만들기의 자동 곡은 서버 DB에 같은 영상이 있으면 그 하이라이트(직접 위치로)와 길이를 씀 — 파일 곡은 DB와 연결하지 않아 자동이 늘 처음부터였던 것. writeXlsxSheets(여러 시트). 단위·API 테스트, e2e quiz 단계, docs 10·12
2026-11-03 23:20:04 +09:00
13-title-answers.md
제목 정리 4단계: 서버 DB 곡 제목 정리 검토 — title_reviews(015), songs/title-review.ts(만들기·적용·건너뛰기·목록), cli clean-titles(--review: 모두 검토 목록 / 기본: 새 곡은 바로 반영, 일본어·확인 필요만 검토), 관리자 → 수집에 '제목 정리·정답 만들기', 관리자 →
✏️
제목 정리(묶음별 목록, 제목·가수 고쳐서 적용, 건너뛰기, 묶음 전체 적용, 처리한 것). 적용하면 제목·가수와 새 정답·원래 이름(별칭), match_key는 그대로, 그사이 바뀐 곡은 적용 안 함. 영어 발음 다듬기(운영 사본 표본에서): 자음 뒤 l(플렉스·블루), s+w(스위트), ts(렛츠), ow+모음(플라워), 철자 o의 ɑ는 ㅗ(존·아이콘), 약모음은 철자대로(프로미스·사이렌), 단어 끝 -sle/-zle(캐슬), 대문자 한 글자는 글자 이름(알 오 디), 아포스트로피는 's/'t 등만. 단위·API 테스트, e2e admin(제목 정리), docs 13
2026-11-04 16:33:19 +09:00
보고서.pdf
문서: 정답 정규화에 빈 비교 키 방지 규칙 추가(숫자·기호만 있는 제목), 보고서 재생성
2026-10-18 17:22:30 +09:00