Files
music_quiz/docs/13-title-answers.md

9.8 KiB

13. 제목 정리 · 정답 나누기 (2026-11-04 요청)

확정된 결정 (사용자 답변)

  • 화면 제목: 괄호는 전부, feat., 버전 표시(Remix·Live·Acoustic·Inst.·MR·Ver./Version·Edit·Remaster·Sped up)까지 지움
    • 괄호 안이 다른 이름이면(사랑을 했다(LOVE SCENARIO)) 정답 별칭으로 남김
    • 앞 괄호는 단어로 남김: (I Can't Help) Falling In Love With You → I Can't Help Falling In Love With You (별칭 Falling In Love With You)
    • Part/Pt. 번호는 단어로 남김(Part I/II가 같은 제목이 되지 않게), 단어 안 괄호(Time Is [L]over)는 그대로
    • 가수 이름의 괄호는 건드리지 않음
  • 제목·가수는 정답 열과 상관없이 늘 정답 (Q1)
  • 영어 제목 한글 발음 정답: 무료 발음사전 + 외래어 표기 규칙, 국립국어원 용례로 보정 (Q2). DB 영어 제목 곡(약 4,072)에도 추가, 검토 목록에서 묶어서 승인 (Q3)
  • J-POP: 화면 제목은 뜻을 옮긴 공식 한글 이름(위키백과 → 멜론 괄호 → 읽는 소리 → 확인 필요), 정답은 일본어 원어·읽는 소리·한글 이름 모두
  • 파일에서 가져오기: '정답' 열이 비면 자동으로 채움 (Q5)
  • 앞으로 수집하는 곡: 일본어 곡과 '확인 필요' 곡만 검토 목록, 나머지는 바로 반영 (Q6)
  • 엑셀 양식
    • 일반: 순번 | 링크 | 제목 | 가수 | 정답 | 가수 정답 | 힌트 | 시작 | 하이라이트 | 길이 | 비고 (정답은 ;로 여러 개)
    • 이지선다: 순번 | 링크 | 제목 | 가수 | 조회수 | 시작 | 하이라이트 | 길이 | 비고
    • 재생목록으로 엑셀 만들기에서 두 양식을 따로 받음. 예전 양식(정답=제목, 다른 정답) 파일도 읽힘
  • 원곡이 아닌 곡 (Q7·Q8)
    • 제목이 리믹스·라이브·Inst.인 21곡 중 '사이렌 Remix'(7985)만 남기고 휴지통
    • 영상이 라이브·반주인 재생 곡도 휴지통: 119, 915, 2022, 2174, 9883 + 같은 기준으로 찾은 5424(Mr. Bang Bang (Inst.)), 7303(달콤한 빈말 (MR))
    • 9066 Opus "Live Is Life"는 원곡 자체가 라이브 녹음이라 남김
    • 앞으로: 차트가 리믹스·라이브·Inst.를 새 곡으로 넣지 않음, 원곡 찾기는 그런 영상을 연결하지 않음

단계

  1. packages/shared/src/title-clean.ts cleanTitle / versionKind / videoVersionKind, cli.ts drop-versions, 차트·원곡 찾기 규칙 (239c314)
  2. 엑셀 양식: 제목/정답 열 나누기(quiz-file.ts), 재생목록 엑셀 두 양식, 파일 정답 자동 채움(POST /api/admin/quizzes/answers, 서버 answers/index.ts)
  3. 정답 자동 생성 apps/server/src/answers/
    • en-ko.ts: CMU 발음사전(첫 영어 제목 때 읽음, 약 95MB) + 외래어 표기 규칙 + 흔한 표기 단어표(COMMON). 못 읽는 단어가 있으면 그 제목은 발음 없음. 사전에 없는 단어는 로마자(일본어)·두 단어 붙임으로 읽어 봄
    • ja-ko.ts: 가나 → 한글 두 가지(rule 표기법: 요루니 가케루 / common 거센소리: 요루니 카케루), 로마자 → 가나
    • ja-reading.ts + ja-worker.ts: 한자 읽기는 kuromoji를 별도 bun 프로세스로(약 350MB, 서버에 올리지 않음, 묶음마다 한 번, 약 0.3초)
    • wiki.ts: 일본어 위키백과 → 한국어 문서 이름(50개씩, 넘겨주기 따라감)
    • index.ts songAnswersBatch: korean 옵션이면 일본어 제목·가수를 한글 이름으로 보여 줌(위키백과 → 괄호 안 한글 → 읽는 소리 '한글 이름 자동 변환' → '확인 필요')
    • 플레이리스트 가져오기·재생목록 엑셀: korean + 위키백과, 파일 정답 채우기: 이름은 그대로 두고 정답만
  4. 서버 DB 적용: 제목 정리 검토 (songs/title-review.ts, 015 마이그레이션 title_reviews, 관리자 → ✏️ 제목 정리 /admin/titles)
    • cli.ts clean-titles --review: 처음 한 번, 바뀔 곡 전부 검토 목록(묶음: 제목·가수 정리 / 정답만 추가 / 일본어 곡 / 확인 필요)
    • cli.ts clean-titles(관리자 → 수집 버튼, cron): 아직 안 본 곡(새 곡)만 — 바로 반영, 일본어·확인 필요만 검토 목록
    • 적용: 제목·가수 바꾸고 새 정답과 원래 이름을 song_aliases(source auto)로, match_key는 그대로(차트가 원래 이름으로 찾음). 그사이 바뀐 곡은 적용 안 함
    • 운영 사본(10,762곡) 결과: 제목·가수 정리 614, 정답만 3,641, 일본어 7, 확인 필요 2, 그대로 6,498 — 약 6초
  5. 배포 (2026-11-04 16:39~): 백업 ~/backups/music_quiz/app-before-title-clean-20261104-1639.db → 651bc98 배포(015 마이그레이션) → drop-versions --keep 7985,9066 27곡 휴지통(목록 확인 뒤) → clean-titles --review: 제목·가수 정리 592, 정답만 3,638, 일본어 8, 확인 필요 2 검토 대기 → .9 crontab 02:50 clean-titles
    • 일본어 곡 중 アイドル은 위키백과가 낱말 문서(일본의 아이돌)로 이어져 이름이 틀림 — 검토 화면에서 고쳐 적용할 것

2026-11-04 저녁: 가수 정답 섞임 · 한글 발음 검수 (사용자 답 Q1~Q4 모두 진행)

  • 퀴즈 편집 화면: '추가 정답' 한 칸 → '제목 정답' · '가수 정답' 두 칸 (게임 판정은 원래 따로였음)
  • 괄호 안이 그 곡 가수 이름이면 제목 정답이 아님: cleanTitle(title, artist) (Crank That (Soulja Boy), 레이 (LAY)). 정답 생성·플레이리스트·파일 읽기 모두 가수를 넘김
  • 재생목록으로 엑셀 만들기: 정답·가수 정답 칸에 제목·가수를 다시 적지 않음(다른 표기만, 빈 칸은 파일로 만들 때 자동 채움). 내보내기(quizToRows)는 그대로 — 빈 칸이면 다시 읽을 때 자동 채움이 돌기 때문
  • 한글 발음: 규칙(en-ko.ts)은 후보로만, 정답은 검수한 표기표 apps/server/src/answers/lexicon.json(lexicon.ts)만
    • words 2,299 / titles 74(단어별로 읽으면 틀리는 제목) / artists 1,111(가수 이름 통째, 한국 공식 이름·일본 이름 성-이름 순서 포함)
    • 만든 방법: DB 영어 제목 단어 2,265개·가수 이름 1,155개(+ 영어 위키백과 → 한국어 문서 이름 764개)를 10묶음으로 나눠 검수, 띄어쓰기 보정, 손으로 고친 것(overrides). 작업 파일은 저장소 밖(~/work/mq/lex/)
    • 두 표기가 흔하면 둘 다(썸머/서머), 확실하지 않은 것은 넣지 않음(제목 단어 16, 가수 60)
    • 띄어 쓴 꼴과 붙여 쓴 꼴 둘 다 넣음(로드 스튜어트 / 로드스튜어트). 처음에는 기본값이 띄어쓰기를 봐서 넣었고, 2026-11-04부터 기본값은 띄어쓰기를 무시하지만 방장이 띄어쓰기를 켠 방을 위해 그대로 둠
    • 표기표에 없는 단어가 있으면 그 글에는 발음 정답 없음 → unknownWords. 새 곡(02:50 clean-titles)은 '확인 필요' 검토(비고 '발음 확인 필요: …'), 관리자 → 제목 정리에서 '제목/가수 정답 더하기'로 직접 넣고 적용
    • 다음 표기표 갱신: cli.ts lexicon-missing(없는 단어, 규칙 후보, 곡 수) → lexicon.json에 추가 → 배포
  • 이미 들어간 발음 정답 바꾸기: cli.ts redo-readings [--dry-run] [--old-lexicon 고치기전.json] — 옛 규칙(과 넘긴 이전 표기표)이 그 곡 이름에서 만든 것과 같은 정답(source auto)만 빼고 표기표 표기를 넣음. 관리자가 넣은 별칭·퀴즈에 직접 쓴 정답은 그대로, 이지선다 퀴즈는 안 건드림. 표기표를 고친 뒤에는 git show <고치기 전>:apps/server/src/answers/lexicon.json을 --old-lexicon으로 넘겨야 이전 표기가 빠짐
  • 멜론 차트 파서: 재생이 막힌 곡은 제목 칸에 링크가 없어 다음 링크(가수)를 제목으로 읽던 것 → 제목 칸만 읽음. cli.ts fix-melon-titles [--dry-run]: 제목이 가수 이름과 같은 멜론 곡을 곡 정보 페이지 제목으로 고침(자기 이름 곡 소녀시대 등은 그대로), 자동 정답·제목 정리 행을 지우고 clean-titles로 다시, 제목으로 잘못 찾은 후보 영상은 원곡 찾기로 되돌림
  • decodeEntities: &eacute;·&deg; 등 라틴 문자 이름 추가(Céline Dion) → cli.ts fix-text로 DB 고침
  • 퀴즈 파일 가수 칸의 따옴표 안('Miki Matsubara Official "stay with me"')을 with로 자르지 않음(가수 정답 '미' 같은 조각)
  • 배포 (2026-11-04 20:44~): 백업 ~/backups/music_quiz/app-before-readings-20261104-2044.db → eac4d97 배포 → fix-text(16곡, Céline Dion 등) → fix-melon-titles 18곡(Rod Stewart → Your Song 등, Chuckie는 같은 곡 10449에 합침, 16곡 바로 반영) → redo-readings(DB 3,707곡: 옛 발음 2,328개 빼고 10,533개 넣음 / 일반 퀴즈 30곡) → 테스트용1 真夜中のドア 가수 칸 'Miki Matsubara'로 → redo-readings 한 번 더(그 곡 가수 발음 6개). 두 번째부터는 바뀌는 것 없음. 표기표에 없는 단어가 남은 곡 56곡(대부분 누군지 확인 안 된 가수 이름)
    • redo-readings는 아직 적용 안 된 제목 정리 행(pending)의 정답도 같이 바꿈(나중에 적용해도 옛 발음이 안 돌아오게). 퀴즈 정답에는 누가 썼는지 기록이 없어서 '그 곡 이름으로 옛 규칙이 만든 것과 같은 값'을 자동으로 봄 — 연결된 DB 곡에 사람이 넣은 별칭(source quiz/admin)으로도 있는 값은 남김. 반영 때 빠진 퀴즈 정답 18개는 백업과 대조해 모두 옛 규칙 결과(융 쿠크, 어 하, 헤벤, 미 …)임을 확인
    • 'Sheep (Alan Walker Relift)'(10550)는 리믹스라 휴지통 기준에 해당 — 사용자 확인 대기

운영 DB에서 확인한 숫자 (2026-11-04 사본)

  • 10,762곡, 제목이 바뀌는 곡 617곡
  • drop-versions: 제목 21곡(사이렌 제외 20) + 영상 7곡(9066 제외) = 27곡, 퀴즈·플레이 기록에 쓰인 곡 없음