Spotify 검색에서 cover · live · remix · karaoke 우회 잡기 — POP-SPOT v2.14 음악 검색 정확도

// v2.14 — 제목 검증 점수화 로직. SpotifySearchService 안
private static final List<String> BAD_KEYWORDS = List.of(
//      ^^^^^^^^^^^^                              ^^^^^^   Java 9+ 불변 리스트 팩토리
    "cover", "live", "remix", "karaoke",
//   원곡 대신 다른 가수·라이브·DJ 편곡·반주(MR) 버전
    "instrumental", "acoustic version", "sped up", "slowed"
//   연주만·언플러그드·빠르게 편집·느리게 편집 (틱톡 의 유행 버전)
);

private double scoreTitle(String resultTitle,
                           List<String> queryKeywords) {
    String t = resultTitle.toLowerCase();
    //                     ^^^^^^^^^^^   소문자 통일 — "Cover"·"COVER"·"cover" 모두 동일하게 검출
    long matched = queryKeywords.stream()
//       ^^^^^^^                                 원곡 키워드 중 제목에 포함되는 개수
        .filter(k -> t.contains(k.toLowerCase()))
        .count();
    long bad = BAD_KEYWORDS.stream()
//       ^^^                              변형 키워드 중 제목에 포함된 개수
        .filter(t::contains).count();
    return (double) matched / queryKeywords.size()
//          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^   정규화 점수 — 원곡 키워드 포함 비율 (0.0 ~ 1.0)
//                                                   예: 키워드 수 2개 중 1개 포함 → 0.5
         - bad * 0.3;
//         ^^^^^^^^^                                  변형 키워드 1개당 0.3점 감점
//                                                    "cover" 포함 → -0.3 / "cover live" 예 → -0.6
//                                                    완전 차단은 아님 — 원곡이 cover 밖에 없으면 소소차적으로 선택 가능
}

public Optional<Track> pickBest(List<Track> hits, List<String> kw) {
    return hits.stream()
        .max(Comparator.comparingDouble(
//      ^^^                                  점수 가장 높은 하나만 선택
            t -> scoreTitle(t.getName(), kw)));
//          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^   위의 점수 함수를 각 트랙에 적용
}
// 결과: cover 가 첫 결과일 수 있고 원곡이 하위 1~2 트랙에 있으면 원곡 채택