v2.14change journal

POP-SPOT v2.14 — 음악 검색 정확도 + cover/live/remix 회피

김동현48
#백엔드#프론트엔드#회고#트러블슈팅
v2.14 릴리즈에 포함된 Git 기록을 빠짐없이 펼친 기술 기록이다. 전문 용어는 바로 풀어 쓰고, 바뀐 모든 코드 줄을 Before → After로 비교했다.

먼저 쉽게 설명하면

음악 검색 정확도 + cover/live/remix 회피 작업이 중심이다. 이 릴리즈는 눈에 보이는 결과뿐 아니라 그 결과를 만든 파일과 코드까지 모두 추적했다.

읽는 법

  • Before는 바뀌기 전 줄이다.
  • After는 바뀐 뒤 줄이다.
  • ‘해당 코드 없음’은 새로 추가했거나 완전히 지운 구간이라는 뜻이다.
  • 영상·이미지처럼 글자로 비교할 수 없는 파일은 Git의 추가·수정·삭제 상태로 기록했다.
  • Git 기준 범위

  • 릴리즈: v2.14
  • 기준 날짜: 2026-05-21
  • 커밋: 2개
  • 파일 변경 기록: 7개
  • 추가한 줄: 394줄
  • 삭제한 줄: 17줄
  • 검증 ID: bd2f77cfac142dbc575ee80415efd99829f4e403719ffb0c7edb7af6387838b1
  • 기준 커밋: 765dd49ae007

  • 커밋 0ee987d — fix(v2.13.3.1): admin 진입 시 인트로 페이지 튕김 핫픽스변경 파일 1

    GitHub에서 이 커밋 보기

    쉬운 설명: admin 진입 시 인트로 페이지 튕김 핫픽스 작업이다.

    바꾼 이유: 문제: 관리자 토큰으로 /admin 접근 시 인트로 페이지로 리다이렉트되는 회귀.

    파일 수: 1개이다.


    파일 1. popspot-frontend/app/admin/page.tsx

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    커밋 765dd49 — feat(v2.14): 음악 검색 정확도 + cover/live/remix 회피변경 파일 6

    GitHub에서 이 커밋 보기

    쉬운 설명: 음악 검색 정확도 + cover/live/remix 회피 작업이다.

    바꾼 이유: 사용자 보고: - "촛불 하나" 같은 검색 시 이상한 음악 노출 - 재생 시 공식 음원이 아닌 cover 가 나옴

    파일 수: 6개이다.


    파일 1. PROJECT_CHANGELOG.md

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 2. popspot-backend/src/main/java/com/example/popspotbackend/controller/AdminMusicController.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 3. popspot-backend/src/main/java/com/example/popspotbackend/repository/MusicTrackRepository.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 4. popspot-backend/src/main/java/com/example/popspotbackend/service/music/MusicService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 5. popspot-backend/src/main/java/com/example/popspotbackend/service/music/SpotifySearchService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    파일 6. popspot-backend/src/main/java/com/example/popspotbackend/service/music/YouTubeMusicSearchService.java

    파일 전체 문맥

    조각만 보면 알기 어려운 코드를 파일 처음부터 끝까지 보여 준다. 초록은 추가·수정, 빨강은 삭제된 줄이다.

    공유XLinkedIn

    댓글