fix: 강의 검색 결과 학년 정렬 누락 수정(#101)

[xunssoie]

PR Summary

강의 검색 결과가 다른 조회 5종과 같은 학년 정렬을 따르도록 고치고, 방향이 빠져 관련도 낮은 순으로 나가던 정렬을 높은 순으로 정정했습니다. 검색 경로에 정렬 회귀를 잡는 MySQL 통합 테스트를 함께 두었습니다.

Problem

문제 1 - 검색 결과만 학년 정렬을 타지 않음

전공, 교양, 타학과, 연계전공, HUSS 조회는 모두 학년, 이수구분, 학수번호 순으로 정렬합니다. 검색만 정렬 키에 학년이 없어, 같은 화면 흐름에서 검색으로 넘어가는 순간 강의가 학년과 무관한 순서로 나왔습니다. 학년은 학생이 수강 가능 여부를 가장 먼저 거르는 기준이라, 정렬이 빠지면 목록을 처음부터 훑어야 합니다.

문제 2 - 관련도가 낮은 순으로 나감

ORDER BY MATCH ... AGAINST 뒤에 정렬 방향이 없어 기본값인 오름차순으로 동작했습니다. 검색어와 가장 동떨어진 강의가 앞에 오고, 정확히 일치하는 강의가 맨 뒤로 밀렸습니다. 정책 문서에 적힌 "관련도가 높은 순"과 정반대로 나가고 있었습니다.

문제 3 - 검색 경로에 테스트가 없음

FULLTEXT 검색을 도입한 #40 이후 검색 테스트는 통째로 주석 처리돼 있었습니다. 테스트 DB인 H2가 MATCH ... AGAINST를 실행하지 못하기 때문입니다. 검증이 0건인 구간이라 위 두 결함이 걸러지지 않고 그대로 나갔습니다.

Solution

해결 1 - 학년을 첫 정렬 키로

정렬의 첫 키를 학년으로 두어 다른 조회와 기준을 맞췄습니다. 전학년이 코드 0이라 오름차순만으로 전학년, 1, 2, 3, 4 순서가 나와 별도 CASE 식이 필요 없었습니다. 두 번째 키는 이수구분이 아니라 관련도로 정했는데, 검색 결과는 학과와 이수구분이 섞여 나와 이수구분 묶음이 주는 의미가 약한 반면 사용자가 직접 입력한 검색어와의 관련도가 두 번째 기준으로 더 쓸모 있기 때문입니다.

해결 2 - 관련도에 내림차순 명시

관련도 식에 DESC를 붙여 높은 순으로 정정했습니다. WHERE와 ORDER BY에 같은 MATCH 식이 오지만 옵티마이저가 한 번만 계산합니다. MATCH의 컬럼 목록은 FULLTEXT 인덱스 정의와 어긋나는 순간 인덱스를 타지 못하므로 손대지 않았습니다.

해결 3 - Testcontainers MySQL 통합 테스트 도입

H2로는 검증할 수 없는 구간이라 실제 MySQL 컨테이너를 띄우는 통합 테스트 어노테이션을 만들었습니다. Flyway로 운영과 같은 스키마를 세워 ngram FULLTEXT 인덱스까지 재현하고, 학년, 관련도, 학수번호 세 키를 각각 검증합니다. Docker가 없는 환경에서는 이 테스트만 건너뜁니다.

두 가지 함정이 있었습니다. 이 테스트는 트랜잭션을 걸지 않는데, InnoDB FULLTEXT 인덱스는 커밋된 행만 검색해 롤백 격리 안에서 저장한 행은 MATCH에 잡히지 않기 때문입니다. 또 관련도를 검증하려면 검색어와 무관한 행을 반드시 섞어야 합니다. 모든 행이 검색어를 포함하면 idf가 0이 되어 관련도가 전부 같아집니다.

해결 3-1 - 컨테이너 접속 정보 주입 방식

@ServiceConnection으로는 컨테이너가 연결되지 않았습니다. 이 프로젝트는 DataSourceConfig에서 spring.datasource 프로퍼티로 DataSource를 직접 만들기 때문에, 부트가 연결 정보를 갈아끼우는 자동설정 경로를 타지 않습니다. 컨테이너는 떠 있는데 JPA는 H2를 붙잡고 있는 상태였습니다. 운영 코드를 건드리지 않으려고 컨테이너 접속 정보를 DataSourceConfig가 읽는 바로 그 프로퍼티에 주입하는 방식으로 연결했습니다.

검증

전체 테스트 290건이 통과합니다. 정렬 방향 회귀를 실제로 잡는지 확인하려고 DESC를 잠시 빼고 돌렸을 때, 의도한 관련도 검증 테스트 하나만 실패하는 것까지 보고 복원했습니다.

범위 밖 변경

이슈 라벨 표기에서 이모지를 제거한 문서 커밋이 하나 함께 올라가 있습니다. #101과는 무관한 정리입니다.

Related Issue

• close fix: 강의 검색 결과의 학년 정렬 누락 #101

[github-actions]

Test Results

290 tests   290 ✅  4s ⏱️
 93 suites    0 💤
 93 files      0 ❌

Results for commit c4b6e69.